Amazon Marketplace

How to add an Amazon store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

The ShipStation – Amazon integration imports your Amazon Marketplace orders into ShipStation. View product photos, weights, and SKUs for all of your merchandise and confirm inventory levels. Set up automation rules to make order management even easier.

Do you use Fulfillment by Amazon (FBA)? Review our FBA article in the Carrier Integration section of our help centre for details.

Amazon Requirements

Connection Requirements:

  • An Amazon Seller account on the Professional plan.

  • Your Amazon Seller ID and MWS Auth Token (see the Connect an Amazon Store section below for details).

Order Import Requirements:

  • The order must be a merchant-fulfilled (MFN) order.

    ShipStation can import Amazon-fulfilled (AFN) orders as well, but these will only import as Shipped orders. See the Available Features section below for more details.

  • The order must contain a physical product.

Connect an Amazon store to ShipStation

To connect your Amazon store to ShipStation:

  1. Select the Amazon tile for the Amazon country account you wish to connect.

    If you have an Amazon Unified North America account (which has access to Amazon.com, Amazon.ca, and Amazon.com.mx), you must use the Amazon tile in this step.

    Amazon logo tiles
  2. In a new tab or browser window, log in to Amazon Seller Central.

  3. Go to Appstore > Manage Your Apps.

    Amazon Seller central with arrow pointing to App Store tab and manage your app.
  4. Click Authorize new developer .

    Amazon Seller Central with arrow pointing to Authorize new developer button.
  5. Enter the Developer Name and Developer Account No listed in Step 2 of the ShipStation connection window into the appropriate fields in the Amazon screen.

    Amazon Marketplace Web Service grant access.
  6. Click the Next button, accept the licence agreement, then click Next again.

    You'll be presented with codes for your Seller ID and MWS Auth Token that you'll enter into ShipStation.

    Access your Amazon Seller account with MWS congratulations message.
  7. Copy your Seller ID and MWS Auth Token from Amazon and enter them into the matching fields in the ShipStation connection window.

    Connect Amazon menu with credentials fields highlighted.
  8. Click Verify Seller ID.

    Connect Amazon form with Verify Seller ID button highlighted.
  9. Choose an Amazon Order Source for the connection.

    For North America Unified Accounts, choose whether this store will be used for Amazon.com, Amazon.ca, or Amazon.com.mx orders. For additional North America Unified Accounts, you must connect each one individually to ShipStation and set each to a different Amazon Order Source. Just repeat the ShipStation-specific steps to add each additional store connection.

    Connect Amazon form with Amazon Order Source highlighted.
  10. Choose the Product Identifier for the store.

    Available options are SKU or ASIN.

    Connect Amazon form with Product Identifier menu highlighted.
  11. Click Connect.

    Connecting Amazon with arrow pointing to the connect button.

If your Amazon account has multiple Amazon Order Sources, repeat the connection process for each Amazon Order Source you want to see in ShipStation. Orders will import into their appropriate stores so you can filter and fulfill according to your workflow needs.

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Amazon Custom and Handmade Stores

Amazon Custom or Amazon Handmade are separate Amazon platforms that allow merchants to sell customized and handmade items. ShipStation does currently import orders from Amazon Custom, but cannot import customization details related to the order. ShipStation cannot currently import orders from Amazon Handmade using the standard Amazon Marketplace connection to ShipStation.

While we do not integrate fully with the Custom or Handmade stores directly, our partner DataAutomation has developed a process that leverages ShipStation's openAPI to update customization details for Amazon Custom and import Amazon Handmade orders into ShipStation.

If you have an Amazon Custom or Amazon Handmade store and would like to import these orders into ShipStation, DataAutomation can help! Send an email to amazoncustom@dataautomation.com to discuss and sign up for the service (fees will apply).

Tip

To learn more about Data Automation and Amazon Custom / Handmade Stores, read our blog post: Fulfill Amazon Custom and Handmade Orders with DataAutomation and ShipStation.

Available Features for Amazon Integration

ShipStation's integration with Amazon supports the following standard features:

Additional Features for Amazon

ShipStation's integration with Amazon allows for the following additional features:

Feature

Description

Ship by Date

ShipStation imports the Latest Ship Date field from Amazon and uses it for the Ship By Date value.

Sends Shipment Updates to linked BigCommerce store

If you're using BigCommerce to manage your Amazon orders or inventory, see the Using BigCommerce with Amazon or eBay article to ensure your workflow is set up properly in ShipStation.

Support-Enabled Features for Amazon

In addition to the features listed above, you can enable the following settings for your Amazon store via the ShipStation User Success team.

Feature

Description

Custom Fields

Map up to three Custom Fields for an Amazon store. Available custom fields are:

  • Seller Order ID

  • Order Number

  • Purchase Order Number

  • Earliest Ship Date

  • Latest Delivery Date

  • Is Business Order

  • Shipment Service Level Category (Expedited, Free Economy, Next Day, Same Day, Second Day, Scheduled, or Standard)

Amazon.co.jp

ShipStation supports an integration with Amazon.co.jp that we can enable for you.

Amazon.co.jp orders will import using Japanese Kanji for address information. (This is not supported by most shipping carriers). ShipStation does not provide translation services for these orders, so you will need to manually convert the address to Roman characters to create the shipping label.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Renew Authorization for Amazon Token

If you've had an account with ShipStation for a while, our authorization as a developer might have expired. It happens after a certain amount of time and you may have received an email to your Amazon seller account notifying you that your API tokens are expiring. You will need to re-authorize your MWS Developer Permission.

To renew authorization for ShipStation to Access Amazon:

  1. Copy and paste this URL into a browser: https://sellercentral.amazon.com/gp/account-manager/home.html/ref=au_userperms_dnav_xx_

  2. In the top right corner, go to Settings and select User Permissions:

    Amazon interface showing settings then user permissions
  3. Under the Third-Party developer and apps section, click Visit Manage Your Apps.

    AMZ_manage_apps_usersetting-MRK.png
  4. Under "Amazon MWS Developer Permissions" select to "Renew Access" on each relevant developer access.

    AMZ_settings_AuthTokens_RenewAccess_MRK.png
  5. Copy the renewed Access Token and return to ShipStation.

  6. Go to edit your Amazon store settings and paste in the renewed Access Token.

    Connect Amazon menu with credentials fields highlighted.

Amazon Personal Data Redaction

To protect your customer's privacy and adhere to Amazon's Data Protection Policy ShipStation will automatically redact all Personally Identifiable Information (PII) from orders and customer records imported from Amazon Marketplace after a set time has passed.

This policy affects order records in ShipStation, as well as any customer records in ShipStation that are associated solely with an Amazon Marketplace.

Additionally, Amazon no longer sends PII to third parties, like ShipStation, for Amazon orders that use FBA (also known as AFN - Amazon Fulfillment Network - orders). If you have ShipStation set to import these orders for fulfillment record purposes, this means the Buyer / Recipient Info fields will be blank in ShipStation for these orders.

PII includes:

  • Customer name

  • Street Address

  • Phone Number

  • Gift Message Content

  • Usernames

  • Email Address (if not already encrypted by Amazon)

PII will be redacted based on the following schedule:

  • For orders that are not shipped in ShipStation, PII will be redacted 14 days after order import.

  • For orders shipped in ShipStation using a service that supports automatic tracking, PII will be redacted either 30 days after shipment delivery, 30 days after the ship date, or 44 days after label creation date (whichever is soonest).

  • For orders shipped in ShipStation using a service that does not support automatic tracking, PII will be redacted 30 days after shipment creation.

When viewing an Amazon order that has redacted information, the original information will be replaced with the text “REDACTED (Amazon)”.

Order Details Recipient section with Amazon customer information redacted

Labels created for the Amazon order will also have the information redacted.

Amazon_RedactedLabel.png

Redaction Special Cases

City, State, and Postal Codes will not be redacted on the order details in ShipStation, but will be redacted on the label according to the corresponding schedule.

Renew Authorization for Amazon Token

If you've had an account with ShipStation for a while, our authorization as a developer might have expired. It happens after a certain amount of time and you may have received an email to your Amazon seller account notifying you that your API tokens are expiring. You will need to re-authorize your MWS Developer Permission.

To renew authorization for ShipStation to Access Amazon:

  1. Copy and paste this URL into a browser: https://sellercentral.amazon.com/gp/account-manager/home.html/ref=au_userperms_dnav_xx_

  2. In the top right corner, go to Settings and select User Permissions:

    Amazon interface showing settings then user permissions
  3. Under the Third-Party developer and apps section, click Visit Manage Your Apps.

    AMZ_manage_apps_usersetting-MRK.png
  4. Under "Amazon MWS Developer Permissions" select to "Renew Access" on each relevant developer access.

    AMZ_settings_AuthTokens_RenewAccess_MRK.png
  5. Copy the renewed Access Token and return to ShipStation.

  6. Go to edit your Amazon store settings and paste in the renewed Access Token.

    Connect Amazon menu with credentials fields highlighted.

Additional Details about the Amazon Integration

  • No Shipment or Delivery emails for Amazon orders: Amazon will send customer notification emails when ShipStation notifies Amazon of the shipment.

    • ShipStation can send emails that include Return Labels to customers, but to do so you must add either tracking@shipstation.com or the email address set in the Branding tab of the Store Settings in ShipStation as an Approved Sender in Amazon Seller Central.

    • ShipStation can send Shipment and Delivery emails for non-Amazon orders created through Amazon Payments.

  • Amazon Throttling: Amazon MWS limits the number of calls made per hour to their system, including the shipment updates ShipStation sends. This limit may prevent such notifications from reaching Amazon immediately. ShipStation automatically retries throttled Amazon updates periodically to get the notifications through.

    We recommend creating labels in Batches to reduce the chance of throttling.

  • One shipment update only: ShipStation can only update the Amazon order with tracking information once. If you create an additional shipment for an Amazon order, ShipStation will not attempt to update Amazon.

    Splitting and Combining Amazon Orders in ShipStation Not Recommended

    Due to how the ShipStation Amazon integration handles notifications, we do not recommend splitting orders into multiple shipments or combining orders into a single shipment in ShipStation!

    • When splitting orders, ShipStation will only send the shipment notification for the first order shipped, but this shipment will contain all the order's items.

    • When combining orders, ShipStation will only send the shipment notification to one of the orders and you'll have to manually update the remaining orders directly in Amazon.

  • Amazon Custom Orders: ShipStation will import Amazon Custom orders, but will not import the customization details.

  • Skips product information for Merchant Fulfilled Shipped or Cancelled orders: Due to the additional calls needed to import product information from Amazon, ShipStation will not import product information for Amazon orders that are already Shipped or Cancelled.

    If you have the Import FBA Orders setting enabled, ShipStation will import the product information for Amazon Fulfilled orders, even though they import as Shipped.

  • No currency conversion: Amazon sends ShipStation the order totals and product prices based on the currency of the Amazon marketplace type. Since ShipStation supports viewing multiple currencies, the values you see in ShipStation should reflect the actual store currency and value. ShipStation cannot convert the currency displayed in the orders to other currency values.

  • Hidden Customer Information: Amazon hides customer email addresses and phone numbers to protect the privacy of its customers. The email address and phone number that import into ShipStation can be used to contact your customers, but the communication will flow through an Amazon service. You should not use these email addresses or phone numbers for marketing purposes.

Amazon Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue

How to troubleshoot or resolve

ERROR: InternalServiceError: Amazon encountered an exception. Message: Feed rejected

What it means: This ShipNotify issue is typically a billing / account-level / non-technical issue with the Amazon account.This may be an account downgrade or other non-technical issue, but it does not indicate a problem with ShipStation’s requests to Amazon to update orders.

What to do: Try the following steps...

  • Retry failed steps / re-notify marketplace.

  • Reconfigure the store and attempt notification again.

  • Confirm that your Amazon Seller payment method is up-to-date / non-expired, and that you have not missed any payments to Amazon recently.

  • If the above steps do not resolve the error, contact Amazon Seller Support or your Amazon Account Manager directly.

Shipment notifications say the Request is throttled.

Amazon MWS sets hourly limits for each kind of call made to an Amazon account, including the shipment updates ShipStation sends to Amazon after a shipment is created. This error indicates that the limit has been reached and that Amazon is throttling our requests.

If a shipment update is throttled by Amazon, ShipStation will queue the shipment update and automatically retry once the throttling time threshold has passed.

If you find that the notifications are not being retried, contact the ShipStation User Success team and our support team will evaluate the shipments and push any updates to Amazon.

To reduce the chance of being throttled, we recommend creating labels in batches. Using batches allows ShipStation to consolidate the shipment update made to Amazon into a single call, which greatly reduces the chances of throttling.

Only US orders are visible in ShipStation and no Canadian orders have imported, but you have a North American Unified Account.

If you have a North America Unified Account type, you'll need to connect an Amazon.com store instance for each order source you intend to use.

For example, if you sell on both Amazon.com and Amazon.ca, you'd connect two Amazon.com stores - one which uses an Order Source of Amazon.com, and the other which uses an Order Source of Amazon.ca.

  • Do not use the direct Amazon.ca integration option. This option will only import orders if you have a standalone Amazon.ca account. It will not work for North America Unified Accounts.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information