Orders – Update the SKU of an Item in your order

The POST updateOrder endpoint can be used update the information for your orders.

The ItemSku included in the URL is used to update the product SKUs for your orders in the system.

You must include the recipeid and the partnerBillingKey when updating an order in your system. You can retrieve these from your API page in the Settings of the Gooten Admin.

Please note that you can only update and change the SKU of an item in your order as long as the order is in a pre-production status. You can update the SKUs for orders in the following statuses:

    • New
    • Hold
    • Test
    • Pending
    • OutOfStockItem
    • DiscontinuedItem
    • PrePayment
    • PaymentProcessing
    • ReadyForAccounting
    • ReadyForImageDI
    • NeedsCustomization
    • NeedsManualApproval
    • AccountingIssue
    • AddressIssue
    • PaymentIssue
    • ImageIssue
    • HoldByCIImageIssue
Update the SKUs for an order

1. Send a POST API request to the following URL below. Please be sure to replace the recipeid and partnerBillingKey with your proper ID and key from the Gooten Admin.

https://api.print.io/api/updateOrder/[Order_ID]/ItemSku?recipeid=00000000-0000-0000-0000-000000000000&partnerBillingKey=xxxxxxxxxxxxxxxxxxxxxxxxx

You must also replace the [Order_ID] value in the URL above with the order ID of the order that you want to update the SKU of.

An example of the API request URL with an [Order_ID] can be found below:

https://api.print.io/api/updateOrder/520718/ItemSku?recipeid=00000000-0000-0000-0000-000000000000&partnerBillingKey=xxxxxxxxxxxxxxxxxxxxxxxxx

2. In the body of the request, you'll need to include the information for the new product SKU that you are changing for the order and the order item ID of the item you are updating.

    • NewPRPSku - required - the new SKU for the product variant or print-ready product that you are changing it to.
    • OrderItemId - required - the ID of the order item in your order that you want to update the SKU for.

You can view an example payload below:

3. Once you’ve sent the API request, the response will display a boolean value to determine if the request worked and it will display the following information:

    • Id - The order safe ID which is the ID that can be used to search or view for the order.

The example updates the SKU of the order item by changing the SKU for the item. You can find an example response below:

{
    "HadError": false,
    "Result": {
        "Id": "115557-258528cc-f6e7-4883-b3e4-136e99024fbc"
    }
}