Pre-Launch Announcement: Introducing Amazon Shipping Error Code Enhancement WW for OFF-Amazon

We are pleased to announce that we have enhanced our error codes in our APIs. This improvement aims to provide clearer and more informative error messages, making it easier for developers to diagnose and troubleshoot issues.

Why are we enhancing our Error Codes?

Until now, the lack of detailed error messaging has often led to confusion and delays, necessitating direct intervention from our support teams. We've improved our system so that it now tells you exactly what's going wrong if there's a problem with your shipment. Our enhanced error response framework is designed to empower shippers with immediate, clear, and actionable response to make corrective decision. Issues such as address mismatch, excess dimensional weight, or regulatory constraints, each error now comes with a concise explanation and a specific code, enabling you to identify and resolve the issues swiftly. This means you can quickly understand and fix the problem without having to wait for help from customer service.

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?

This change does not require any work from your technical teams to enable however it should be noted; If you currently have implemented a mapping of our Error Codes to your own Error messaging framework, this will be impacted. The Error massages you will be mapping against will change to reflect the new framework outlined in this document. If you wish to continue your own mapping then use the codes presented in this document to aid the implementation.

When will this change be launched?

We will be launching the first phase of the Error code remapping into Pilot in April 2024.

This first phase focuses on the Error codes for the Off-Amazon ("channelType": "EXTERNAL").

Here is an Example response with the new Error Code model

{
  "errors": [
    {
      "code": " S-503",
      "message": "NoSlotsFound",
      "details": "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)"
    }
  ]
}