This guide provides an overview of the process of integrating with the Amazon Shipping APIs. This documentation assumes that your organization intends to build an integration that will serve Sellers/ Shippers who have their own selling channel and utilizing Amazon Shipping for label creation.
After you complete the steps listed in this guide, you will be able to submit a Shipping Partner application which provides the credentials to access the Amazon Shipping APIs, and establishes the pages required to allow shippers to authorize your application..
Below these steps to create a Seller Partner application to receive your API credentials to call the Amazon Shipping APIs, and develop the OAuth 2.0 authorization flow to get credentials to call the Shipping APIs on behalf of a shipper.
Step 1: Register an Amazon Shipping RIVER account
This step will allow you access to RIVER, the communications platform you will use to contact our support team if you need help with any of the below steps.
- To get started, you would need to connect with your account manager. The account manager will invite the relevant point of contact in your organization to create an account on RIVER. Please accept the invite and create an account.
Step 2: Registering as a Developer
Through this step, you will request access to the Amazon Logistics role from your Amazon Developer Central account. These details enable us to vet and approve your permissions to have access to the data via our APIs.
- If you are already an existing MWS Developer, please click on ‘Edit App’ next to your app on Developer Central and choose ‘MWS and SP API’ under ‘API Type’. Fill out the same set of information that is requested for app creation today [such as IAM ARN, Roles and OAuth URLs]. Once complete, you should be able to access Shipping APIs.
If not an existing Amazon developer, please follow the steps to get access to create your developer app:
- Please login in to the respective retail site. Visit the page that applies to you.
- After logging in, you will notice the URL in the address bar will change to:
- Please send back this directedId to us via the RIVER portal so we can create a Developer Central account for you.
Once invited to Developer Central, you will be able to proceed to register as a developer when you are logged in. These steps provide details about your organization and application, which enable Amazon to vet and approve your permissions to have access to data via Amazon Shipping APIs.
- Click the Proceed to Developer Profile button. Otherwise, click the Your Developer Profile link (https://developercentral.amazon.com/).
- Complete the form.
- Select the option that best represents that application you are building
Public Developers should select the option that reads “My organization builds and offers publicly available applications”
- Select the functions your application will perform. This will provide you the appropriate scope to access specific APIs. To access the Shipping APIs, select “Amazon Logistics (Leverage Amazon as a shipping service.)”.
Note - Please only Amazon Logistics role only if your Shippers will purchase OFF Amazon labels. For generating ON Amazon labels, you must have the Direct-to-Consumer Shipping role added.
You will now go through the data protection requirements questionnaire under Security Controls. These responses will be reviewed by a team that assess your security posture. Amazon holds a high bar for data protection and to ensure there is no delay to your application, we recommend you respond as thoroughly as possible. Please reach out to your account manager if you have questions.
- Provide elaborate details of the mechanisms you have in place for all the questions.
- Provide accurate contact details in the form (screenshot below) for any future communications
- For the below questions, provide in detail the application which you are building and it will be used.
- Complete the Security Controls questions
Complete the 2 descriptive questions by providing the required details.
For Question: List all non-Amazon MWS sources where you retrieve Amazon Information > If your organization is not exchanging Amazon Information from non-Amazon MWS source, please mention the question is not applicable and the reason for it.
- Once you have submitted you the form, please provide the case number that is generated so that we can expedite the process.
- You should expect to receive a response within 7 business days. When you get the response, ensure that you have the Amazon Logistics Role assigned to your Developer account and not a General Role. The Amazon Logistics Role ensures that your Developer credentials have access to the Amazon Shipping APIs for OFF Amazon label creation. If your developer profile is approved but you do not have access to Amazon Logistics role, then please write back on the RIVER support case to have this rectified.
Step 3: Creating your Seller Partner Developer App
This step will establish a Selling Partner application that will provide you the API credentials to call Amazon Shipping APIs.
- Please refer to the Creating and configuring IAM policies and entities section of the Selling Partner API Developer Guide to create an AWS account, accept the IAM policy, and create IAM. Retrieve the details for the OAuth 2.0 process for shippers to grant you permissions to act on behalf of them.
Note. If you are registering a public application, Shipping/ Seller/ Vendor check boxes appears after you choose the SP-API type. Choose Shipping for your Shipping use case, Seller for your Selling use case, and both if applicable.
Step 4: Integrate with the Amazon Shipping APIs
This step details the process of integrating with 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.
- Please review the Amazon Shipping API user guide and Swagger model for details on the API operations and behavior.
- Develop your integration. If there is any support required, please reach out to your Account manager to get the right support to solve. We recommend that you support these use cases at the minimum:
- Functionality to get rates via the Shipping APIs.
- Functionality to purchase shipment via the Shipping APIs.
- Functionality to cancel shipment via the Shipping APIs.
- Functionality to track shipment via the Shipping APIs.
- Produce a test label and follow the steps on the Amazon Shipping Test Label Guide for sign off.
Step 5: Support OAuth 2.0 to enable shippers to authorize your application
This step details the process of supporting OAuth 2.0 to enable shippers to authorize your application to create and manage shipments on their behalf. Amazon Shipping utilizes OAuth 2.0 to securely pass third-parties the API credentials programmatically. Amazon does not allow for API credentials to be externalized and then used in third-party applications.
- In the Selling Partner API Guide, refer to the section titled Authorizing Selling Partner API applications.
- Complete the effort to support Website workflow.
- Provide your sign-in URI and redirect URI to your Amazon Shipping Solutions Architect, and your Solutions Architect will configure your app’s sign-in and redirect URI’s.
Step 6: Demo the integration and prepare for launch
This step details the final step of the integration where third-parties are required submit test labels for review and demo the integration’s functionality with Amazon Shipping.
- Communicate to your Partnership Manager that the integration is completed and ready for demo.
- Your Amazon Shipping contact will schedule a call with the Amazon Shipping team where you will demo the integration.
- If there is no follow up or modifications required after the demo, your Partnership manager will work with you to confirm clients interested in utilizing the integration and set a timeline to launch each client.
Congratulations! You have completed your integration with Amazon Shipping!
Updated 5 months ago