Launch Announcement: Amazon Shipping Error Code Enhancement WW for OFF-Amazon
We are pleased to announce that we have enhanced the error codes in our APIs empowering shippers with clear, actionable Error Codes, making it easier for developers to troubleshoot issues.
Why are we enhancing our Error Codes?
Amazon Shipping introduces Error Codes, a new solution that provides shippers with clear, specific error messages to promptly resolve any shipping issues, enhancing the overall developer experience.
What does this mean for you?
- Reduced Dependency on Support Queries: Minimize the need to reach out to customer support for common shipping errors, allowing issues to be resolved independently and continue operations without delay.
- Clarity and Precision: Each error code has been designed to provide clear guidance on the nature of the problem, what it means for the shipment, and how it can be addressed, reducing guesswork and frustration.
Do you need to do anything?
The enhanced error messages will be automatically delivered through the existing Amazon Shipping API integration, requiring no code changes from shippers. We've handled the back-end implementation, allowing customers to focus on their core business. However, if you have implemented a mapping of our error codes to your own error messaging framework, this new solution will impact that existing mapping.
When will this change be launched?
The improved Error Codes solution will be available in October 2024 for all shippers using the Amazon Shipping API on our off-Amazon channels, including the Off-Amazon API and One-Click Shipment API.
This first phase focuses on the Error codes for the Off-Amazon ("channelType": "EXTERNAL").
This enhanced error codes system is just the beginning. We are committed to continuously improving it by providing even more granular error messages in the coming months. Additionally, we plan to expand this solution across all shipping ingress points, including the On-Amazon API, Shipper Central, and other channels, ensuring a consistent and streamlined experience regardless of how customers access our shipping services. Stay tuned for further updates as we transform the shipping experience for all Amazon Shipping customers.
Here is an Example response with the new Error Code model
This Error Codes solution solves the current challenge by translating internal error codes into easy-to-understand messages. For example, instead of a vague "we can't ship this package" response, shippers will now see informative notifications like:
"We apologize for the inconvenience. We cannot ship the order because an incorrect value for the shipDate was passed. Please validate that the values are correct. If you have questions, please refer to our API documentation and try again. (Code: D-701)"
FAQs:
-
Do I need to make any changes to my code to use the new Error Codes?
No, the improved error messaging will be automatically delivered through your existing Amazon Shipping API integration. No code changes are required on your end. However, if you have implemented a mapping of our error codes to your own error messaging framework, this new solution will impact that existing mapping. -
What types of errors will the new Error Codes cover?
The initial launch will cover a wide range of issues, from incorrect shipment dates and address details, to coverage limitations and payment problems. We'll continue to expand the number of error codes over time to address an even broader set of scenarios. -
How can I access the new Error Codes?
The enhanced error messages will be returned through the standard Amazon Shipping API responses. You can start using them as soon as the feature is launched in early Q4 2024. -
Will I still be able to contact support if I have questions?
Absolutely. Our support team will still be available to assist you with any questions or issues you may have, even with the improved Error Codes in place. -
What kind of ineligible reasons can I expect to see now?
Please find the additional enum values for IneligibilityReasonCode in your rates API response.
| Value | Description | HTTP Status Code |
|---|---|---|
| PICKUP_SLOT_RESTRICTION | We apologize for the inconvenience. We cannot ship the order because the pickup date requested is before the first pickup date for this account. Please adjust the start date and retry.(Code: S-502) | 200 |
| NO_COVERAGE | We apologize for the inconvenience. We cannot ship the order because there are no upcoming pickup slots available. Please adjust the pickup slot and retry. (Code: S-503) | 200 |
| UNKNOWN | We apologize for the inconvenience. We cannot ship these orders because it will miss your customer promise if you ship with us. We are working hard to expand our network and increase Amazon Shipping delivery speed offers. To get these orders to the customer on time, please ship these orders with a different shipping provider.(Code: A-200) | 200 |
| UNKNOWN | We apologize for the inconvenience. We cannot ship the order because the package dimensions or weight are above the allowable limit. Please validate that the package inputs are within the allowable limits and try again.(Code: S-400) | 200 |
| UNKNOWN | We apologize for the inconvenience. We cannot ship the order due to an internal service error. Please contact us for additional support. (Code: S-900) | 200 |
| NO_COVERAGE | We apologize for the inconvenience. We cannot ship the order because there are currently no shipping services available for the recipient address. Please validate the recipient address and try again. If address is accurate, please ship these orders with a different shipping provider.(Code: A-300) | 200 |
- What kind of errors can I expect to see now?
Please find the additional error codes and details whenever Error occurs during the API request.
| Code | Message | Details | HTTP Status Code |
|---|---|---|---|
| Unauthorized | Unauthorized | We apologize for the inconvenience. We cannot ship the order because your Amazon Shipping services are currently paused. You will be able to ship at the end of your pause period. Please contact us if you would like to adjust your pause period. In the interim, please ship these orders with a different shipping provider.(Code: S-501) | 403 |
| Unauthorized | Unauthorized | We apologize for the inconvenience. We cannot ship the order because we’ve currently suspended shipping services for this account. Please navigate to the Amazon Shipping website to find more information about your account status.(Code: S-500) | 403 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because your account is not set-up to ship of hazardous materials. If you would like to ship hazardous materials, please navigate to the "dangerous goods" section within "Settings" on your Amazon Shipping page and follow the instructions. After you are set up, please try again.(Code: S-404) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because Amazon Shipping does not currently support shipments with hazardous materials in this region. We are working towards supporting this feature in this region soon. In the interim, please ship this order with a different shipping provider.(Code: S-405) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because the rate ID is incorrect or expired. Please refer to our API documentation to update the Rate ID in your API configuration and try again.(Code: D-702) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship your order because your requested ship date has already passed. Please select a valid ship date and try again.(Code: S-505) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship your order because your requested ship date is too far in the future. Please select a ship date that is closer to today and try again.(Code: S-504) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because an incorrect value within packageClientReferenceId was passed. Please validate that the values are correct. If you have questions, please refer to our API documentation and try again.(Code: D-701) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because an incorrect value of currency was passed. Please validate that the values are correct. If you have questions, please refer to our API documentation and try again.(Code: D-701) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because an incorrect values for item weight were passed. Please validate that the values are correct. If you have questions, please refer to our API documentation and try again.(Code: D-701) | 400 |
| InvalidInput | Invalid input | We apologize for the inconvenience. We cannot ship the order because an incorrect value of shipTo address was passed. Please validate that the values are correct. If you have questions, please refer to our API documentation and try again.(Code: D-701) | 400 |
For more information or assistance, please refer to the developer documentation.