Amazon Buy Shipping API

Details about ShipStation's Amazon Buy Shipping API integration: requirements, how to enable, features, and troubleshooting tips.

ShipStation’s integration with the Amazon Buy Shipping API allows you to use ShipStation to create labels for merchant-fulfilled Amazon orders that have been imported either from your directly connected Amazon Marketplace account or from a Rithum (formerly ChannelAdvisor) store. The Amazon Buy Shipping API is currently only available for US- and UK-based accounts.

If you are shipping Merchant Fulfilled Prime orders through ShipStation, you may wish to create your labels using the Amazon Buy Shipping API integration. ShipStation applies a special tag to Prime orders to help you identify them quickly. To learn how to ship your Merchant Fulfilled Prime orders using ShipStation, please review our Ship Merchant Fulfilled Prime Orders help article.

Limitations

  • 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 connect more than one Amazon Buy Shipping API account to ShipStation.

  • You cannot create multi-package shipments in ShipStation when using Amazon Buy Shipping API services. To create multi-package shipments, you must do so in Amazon Seller Central.

  • Delayed notifications are not available for shipments created with the Amazon Buy Shipping API. Since the label is created through Amazon's system, Amazon is aware of the shipment as soon as the label is generated.

  • End of Day forms (sometimes called manifests) are not currently supported in ShipStation for Amazon Buy Shipping API labels. These shipments will display in Shipments > End of Day, but cannot be closed or printed through ShipStation. However, you can print End of Day forms via Amazon's shipping portal, if needed.

  • 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 ShipStation.

    Review our Rithum article for more details.

Amazon Buy Shipping API Requirements

  • Amazon Buy Shipping is available to US and UK ShipStation accounts only.

  • Amazon Merchant Fulfilled orders imported from either an Amazon Marketplace or Rithum store connected to ShipStation.

    If you need help connecting your Amazon store, please review our Amazon Marketplace help article.

  • Your Amazon Seller Central email address and password.

  • At least one of the following carriers is configured in your Amazon Seller Central account: Amazon Shipping, DPD, or Royal Mail.

  • You must log in to Amazon and agree to terms and conditions for any shipping carrier you intend to use.

Connect Amazon Buy Shipping API to ShipStation

To connect the Amazon Buy Shipping API to ShipStation:

  1. Connect your Amazon.com seller account to ShipStation, if you haven't already.

  2. Select the Amazon Buy Shipping tile.

    Amazon Buy Shipping tile
  3. Follow the steps provided in the connection pop-up window.

    • Select the Amazon Order Source

    • Enter your Seller Central Email

    Amazon Buy Shipping API connection screen with region and developer details outlined.
  4. Review and agree to the terms and conditions by checking the Agree to Terms and Conditions checkbox.

    Amazon Buy Shipping Terms and Conditions open in ShipStation connection window, with checkbox to agree highlighted.
  5. Click Connect.

    Blue connect button from Amazon Buy Shipping connect window in ShipStation settings.

    You will be redirected to the Amazon Seller Central sign-in page.

  6. Sign in to your Amazon Seller Central account.

    Login screen for Amazon Seller Central with Email or Phone Number and Password fields highlighted.
  7. Select the correct Amazon Account and country. Then, click the Select Account button.

    Amazon account country menu with United Kingdom option selected.
  8. Authorize ShipStation by checking the checkbox and clicking Connect.

    Amazon Authorize ShipStation window with Confirm button selected.

    You will be redirected back to ShipStation and will be automatically logged in.

Once you have connected Amazon Buy Shipping, you will see services from Royal Mail and DPD that are supported by ShipStation.

Amazon also offers the shipping services Amazon Shipping Prime Premium and Amazon Shipping Economy for orders from the UK.

List of Amazon Buy Shipping available services.

Disable Unused Services

To prevent services you do not use from displaying in the Service drop-down for the Amazon Buy Shipping API:

  1. Go to Settings > Shipping > Carriers > Your Carrier Accounts.

  2. Click the Services link for the Amazon carrier to show the active services.

  3. Deselect any services you do not wish to use.

    You cannot deselect any of the Royal Mail services.

  4. Click Update.

Your Services drop-down will now only show the selected services you wish to use.

Amazon Orders Imported via Rithum

If you are using your Rithum account to import Amazon orders into ShipStation, you must still connect your Amazon store to ShipStation, but you can set it to Inactive so it doesn't appear in your Store list or attempt to import orders.

Amazon Buy Shipping API Troubleshooting Tips

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:

  • The selected shipping service does not support the package type, weight, or dimensions you've entered for the shipment.

  • The selected shipping service would not get the package to the customer in time for the Prime guaranteed delivery date.

Error: Resource Not Found

What it means: This error message will occur if ShipStation is able to communicate with Amazon but Amazon isn't able to find the order in the Amazon account ShipStation 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. ShipStation relies on an existing Amazon store connection that contains the Amazon credentials needed to communicate with the Amazon Buy Shipping API. ShipStation 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 ShipStation 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 ShipStation's direct Amazon integration to import those orders instead of Rithum.

Error: Amazon Requires an email address to be specified on every label. Please specify an email address on your Amazon store in your ShipStation Account Settings > Selling Channels.

What it means: The email address must be a verified email address for Amazon to officially recognize it.

What to do: Go to Settings > Selling Channels > Store Setup and click Edit next to your Amazon store. Under the Branding Tab, you should see text underneath the email field to Verify this Email Address. Click the link and follow the instructions to verify the address.

A verified email address will display the text "This email address has been verified for your account" under the email field.

Prime orders stuck in Pending Fulfillment status.

What to do: If your Prime orders are still in Pending Fulfillment status, click the import button to refresh the store. If the orders do not move into the Awaiting Shipment status, contact our support team for further assistance.