Troubleshoot Sandbox Errors

📘

Important

The Buy with Prime API is offered as a preview and might change as we receive feedback and iterate on the interfaces. We are sharing this early documentation to help you learn about the Buy with Prime API as we write and iterate on the content.

Error updating order package information

The following errors can occur when you Change the State of an Outbound Package in the Sandbox.

Error TypeError CodeDescription
AccessDeniedError
N/A
You don't have sufficient access to perform this action. Ensure that you're using the correct order ID and retry the call.
ConflictException
N/AThe order is already in the process of being updated. Retry the request.
InternalServerError
N/AUnexpected error during request processing. Retry the request.
ThrottlingError
N/AUser made too many requests to the Buy with Prime API. Send the request again using exponential backoff.
ValidationError
ConflictingPackageStateInput
You can't provide both packageInformationState and packageTrackerState in the input.
ValidationError
MissingCancellationReason
You need to provide a reason with when the desired status is CANCELLED.
ValidationError
PackageTrackerNotAvailableForUpdate
Wait for 5 minutes, query the order again, and retry after the package tracker is available in the order.
ValidationError
InvalidPackageDeliveryDetailStateTransition
For a list of valid state transitions, see Reference: updateOrderPackageInformation.
ValidationError
PackageInformationDetailIdNotFound
The PackageInformationDetailId isn't found n the system.
ValidationError
PackageTrackerNotFound
The package tracker isn't found or is expired.
ValidationError
UpdatePackageTrackerLimitExceeded
The maximum number of updates on the tracker has been reached. You can't update the tracker any more.

Error updating order returns

The following errors can occur when you Change the State of a Return Package in the Sandbox.

Error TypeError CodeDescription
AccessDeniedError
N/AYou don't have sufficient access to perform this action. Ensure that you're using the correct order ID, and retry the call.
ConflictException
N/AThe order is already in the process of being updated.
InternalServerError
N/AUnexpected error during request processing.
ThrottlingError
N/AUser made too many requests to the Buy with Prime API. Send the request again using exponential backoff.
ValidationError
ConflictingReturnDetailsInput
You can't provide both ReturnDeliveryDetailsInput and ReturnLineItemInputs in the input
ValidationError
DuplicateReturnLineItemIds
There is more than one ReturnLineItemInput with the same ID.
ValidationError
ReturnLineItemIdNotFound
The returnLineItemId isn't found.
ValidationError
NonPositiveReturnLineItemConditionUnit
A conditionUnit in the GradingInput can't contain a non-positive value for units.
ValidationError
ReturnItemsUnavailableForGrading
The sum of units in conditionUnits must not exceed the number of units available for grading. Query the order to see how many units have already been graded, and then pass in only the remaining units.
ValidationError
DuplicateReturnDeliveryDetailIds
There is more than one ReturnDeliveryDetailsInput with the same ID.
ValidationError
ReturnDeliveryDetailIdNotFound
The returnDeliveryDetails ID isn't found.
ValidationError
InvalidReturnDeliveryDetailStateTransition
For a list of valid state transitions, see Reference: updateOrderReturns.

The package or return update isn't reflected in order

As you test your application, you might need to wait for the Sandbox interface mutations because they are asynchronous. For expected wait times, see:

If the expected time passes and the order isn't updated or the events aren't received, create a new order and retry the updates.