Amazon Shipping Integration Guide For Amazon Sellers

Overview
This guide aims to provide an overview of the process to integrate with the Amazon Shipping APIs. This documentation assumes
that your organization is an active Amazon Seller.

The result of this guide will be a Seller Partner application that provides the credentials to access the Shipping APIs.

Steps
The following are the steps to create a Seller Partner app to get your API credentials to call the Shipping APIs.

Step 1: Registering as a Developer

This step provides details about your organization and application to Amazon. These details enable us to vet and approve your
permissions to have access to data via our APIs.

1. If you do not already have an Amazon Pro Seller Account, you will need to upgrade to a Pro Seller account on
SellerCentral in order to set up a Selling Partner application.
a. Go to
i. UK: https://sellercentral.amazon.co.uk/
ii. US: https://sellercentral.amazon.com/
iii. IN: https://sellercentral.amazon.in/
2. Once a Pro Seller account is created, you will need to go through the DRAF [Developer Registration and Assessment
Form] process that provides Amazon details of the application being created and the data you are requesting access to
view or manage.

We consider anyone who makes calls to our MWS or SPDS APIs a developer, and all developers are required to go
through the DRAF process. DRAF allows developers to submit information about their applications so we can assess
compliance with our Amazon MWS data protection requirements and help to make sure that we provide the right level
of access that you require. For more information, please see
https://docs.developer.amazonservices.com/en_US/faq.html

a. Navigate to https://developer.amazonservices.co.uk/ (EU) or https://developer.amazonservices.com/ (US) to

start the DRAF process.

b. Select the option that best represents that application you are building
i. Individual shippers should select the option that reads “I represent a seller organization integrating
with Amazon MWS for its own selling account only.” (Second Option)
Amazon Shipping Integration Guide For Amazon Sellers

c. Select the functions your application will perform. This will provide you the appropriate scope to access
specific APIs. To access the Shipping APIs, select “Merchant-fulfilled Shipping”.

d. You will now go through the data protection requirements questionnaire. These responses will be reviewed by
a team that assess your security posture. Amazon holds a high bar for data protection, and we recommend
that you be thorough in your responses. Please reach out to your Sales Manager if you have questions.

3. Once you have submitted your DRAF form, please provide the case number that is generated so we can expedite the
process for you.
4. You should expect to receive a response within 30 business days. When you get the response, ensure that you have the
Merchant-fulfilled Shipping Role assigned to your MWS Developer account and not a General Role. The Merchant-
fulfilled Shipping Role ensures that your Developer credentials have access to the Amazon Shipping APIs. If you do not
have the right role assigned, please write back on the support case to have this rectified.
Amazon Shipping Integration Guide For Amazon Sellers

Step 2: Creating your Seller Partner Developer App

This step will establish a Selling Partner application that will provide you the API credentials to calls to the Shipping APIs. Please
refer to the Registering your Selling Partner API application section in the Selling Partner API Guide which will guide you through
the steps to create the app.

1. Create an AWS account, accept the IAM policy and create IAM user as noted on Registering your Selling Partner API
application.
2. Provide the details required to create the app to your Sales Manager.
a. Required Details: 1) The ARN for your IAM user 2) Merchant ID
3. Once the app is created, review the app in the Developer Central.
a. EU: https://sellercentral.amazon.co.uk/sellingpartner/developerconsole
b. US: https://sellercentral.amazon.com/sellingpartner/developerconsole
c. IN: https://sellercentral.amazon.in/sellingpartner/developerconsole
4. Refer to the Self Authorization section of the Selling Partner API Guide to understand how to provision the API
credentials for the Amazon Shipping APIs.

Step 3: Integrate with the Amazon Shipping APIs

This step details the process of integrating with the Amazon Shipping APIs. At this point, you should have access to your SPDS
application and your API credentials to make calls to the Amazon Shipping APIs.

1. Please review the Amazon Shipping API user guide and Swagger model for details on the API operations and behaviour.
2. Develop your integration! If there is any support required, please reach out to your Sales Manager to get the right
support to solve.
a. We recommend that you support these use cases at the minimum:
i. Functionality to get rates via the Shipping APIs.
ii. Functionality to purchase shipment via the Shipping APIs.
iii. Functionality to cancel shipment via the Shipping APIs.
iv. Functionality to track shipment via the Shipping APIs.
3. Product a test label and follow the steps on the Amazon Shipping Test Label Guide for sign off.
4. Once signed off, your Sales Manager will work with you to confirm first shipping date.