Amazon Buy Shipping API
ShippingEasy's integration with Amazon Buy Shipping allows you to create shipping labels for Amazon Merchant Fulfilled orders. You can import these orders from your directly connected Amazon Marketplace account or Rithum (formerly ChannelAdvisor).
Amazon Merchant Fulfilled Prime orders are required to be shipped using the Amazon Buy Shipping API integration.
-
No per-label fees apply for Amazon Buy Shipping API.
-
Amazon Buy Shipping API does not support international shipments or custom label messages.
-
If Amazon determines the selected service will not guarantee the shipment's arrival in the required time frame, Amazon will return the alert "Selected service is not compatible with other settings" and prevent you from creating the label for that order. In these cases, you will need to select a faster service.
Important
Give yourself enough time to pick, pack, and ship your orders!
The last pick-up time for each shipping service will impact the availability of the shipping service when you purchase a shipping label using services from the Amazon Buy Shipping API. You may not see your preferred shipping services if the label purchase time is less than an hour from the last carrier pick-up time you defined.
-
You cannot edit the recipient address for shipments using Amazon Buy Shipping API services. All labels will use the recipient address Amazon has on file for the order. If you must update the recipient address, you must log into Amazon Seller Central to make the change.
-
You cannot create multi-package shipments in ShippingEasy when using Amazon Buy Shipping API services. To create multi-package shipments, you must do so in Amazon Seller Central.
-
To use your own carrier account rates for the Amazon Buy Shipping API, you must connect your carrier accounts within Amazon's shipping portal. Review Amazon’s Seller Central help article to learn how to connect your own carrier accounts to use with the Amazon Buy Shipping API (requires you to log into Amazon Seller Central).
-
If using Rithum to import your Amazon orders, the Amazon Buy Shipping API integration will only function for orders imported from the Amazon store you most recently connected to ShippingEasy.
-
Amazon Merchant Fulfilled orders imported from either an Amazon Marketplace or Rithum store connected to ShippingEasy.
If you need help connecting your Amazon store, please review our Amazon Marketplace help article.
-
Your Amazon Seller Central email address and password.
-
You must log in to Amazon and agree to terms and conditions for any shipping carrier you intend to use.
Amazon Buy Shipping supports Transparency Codes through the advanced_options.transparency_codes[] array. Each transparency code entry is mapped to the corresponding order_item_id, which must match the value passed as shipment.items[].external_order_item_id in your API request.
The JSON example below demonstrates how to format the transparency_codes structure for multi-item shipments.
{
"shipment": {
"carrier_id": "se-123456",
"service_code": "amazon_shipping_ground",
"order_source_code": "amazon",
"external_order_id": "111-7115183-3994627",
"items": [
{
"quantity": 1,
"name": "Product A",
"external_order_id": "111-7115183-3994627",
"external_order_item_id": "12345678901234"
},
{
"quantity": 1,
"name": "Product B",
"external_order_id": "111-7115183-3994627",
"external_order_item_id": "98765432109876"
}
],
"advanced_options": {
"transparency_codes": [
{
"order_item_id": "12345678901234",
"codes": ["AZ:XXXXXXXXXXXX", "AZ:YYYYYYYYYYYY"]
},
{
"order_item_id": "98765432109876",
"codes": ["AZ:ZZZZZZZZZZZZ"]
}
]
}
}
}
Here are some common issues, potential causes, and troubleshooting tips.
|
Issue |
How to Troubleshoot or Resolve |
|---|---|
|
Error: Selected service is not compatible with other settings (package type, weight, size) |
What it means: This error message may appear when getting rates or creating labels with Amazon Buy Shipping API. It can occur for a few different reasons, but the most common are:
|
|
Error: Resource Not Found |
What it means: This error message will occur if ShippingEasy is able to communicate with Amazon but Amazon isn't able to find the order in the Amazon account ShippingEasy is trying to access. This error message is most commonly seen when using a Rithum (formerly ChannelAdvisor) store connection that is importing orders from multiple Amazon accounts. ShippingEasy relies on an existing Amazon store connection that contains the Amazon credentials needed to communicate with the Amazon Buy Shipping API. ShippingEasy cannot determine which specific Amazon store a Rithum order originated from, so it will always attempt to use the credentials from the most recently connected Amazon store. This error message will display if the order in question does not belong to that Amazon store. What to do: To resolve this issue, you will need to create a new Amazon.com store connection in ShippingEasy that is linked to the Amazon account you will be shipping Merchant Fulfilled orders for. Then, make the store inactive so you can process the orders imported through Rithum. If shipping Merchant Fulfilled orders for multiple Amazon stores, we recommend you use ShippingEasy's direct Amazon integration to import those orders instead of Rithum. |
Comments
Add a Comment
Article is closed for comments.
Tags: