Orders – Cancel an order item in your order

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

The Order_ID included in the URL is used to cancel the order item in the order.

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 cancel an item in your order as long as the order is in a pre-production status. You can cancel items for orders in the following statuses:

    • New
    • Hold
    • Pending
    • ReadyForAccounting
    • ReadyForImageDI
    • NeedsManualApproval
    • AccountingIssue
    • AddressIssue
    • ImageIssue
    • HoldByCIImageIssue
Cancel an order item in the 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]/CancelItems?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 cancel the order item of.

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

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

2. In the body of the request, you'll need to include the information to cancel the order items in the order.

    • Ids - required - the IDs of the order items in your order that you want to cancel.

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 order item IDs that either had an error or were successful.

The example cancels the order item for the order. You can find an example response below:

{
    "HadError": false,
    "Errors": [],
    "Success": [
        6924457
    ]
}