Amazon Marketplace

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

The ShipStationAmazon integration imports your merchant-fufilled Amazon Marketplace orders into ShipStation so you can view order details and confirm inventory levels while you ship! ShipStation sends shipment data back to your Amazon marketplace automatically, so your customers stay informed and your account maintains its standing.

If you use the Amazon Fulfillment Network (AFN), rather than the merchant-fulfilled option, you can also enable ShipStation to import those orders so you have insight into their status, right alongside all of your other orders.

Don't currently sell on Amazon? Learn how to become an Amazon seller today!

Multiple ways to use Amazon in ShipStation:

Split orders not supported with Amazon’s SP-API

Amazon’s new SP-API will not accept ShipStation shipment notifications for orders that are split in ShipStation. At this time, you should not use the Split shipments feature for orders that import from Amazon Marketplace.

Combined shipments are supported by Amazon's SP-API.

Amazon Requirements

Connection Requirements:

  • An Amazon Seller account on the Professional plan.

  • Amazon seller central login credential

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.

    Amazon connection tiles for all countries available in ShipStation

    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 basic Amazon tile (with no country extensions) in this step.

    AMZ_Tile_Basic.png
  2. 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 use the basic Amazon tile to connect each store individually to ShipStation. Then set each store to a different Amazon Order Source. Just repeat the ShipStation-specific steps for each additional store connection.

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

    Available options are SKU or ASIN.

    Connect Amazon form with Product Identifier menu highlighted.
  4. Click Connect and sign in to your Amazon account.

  5. Check I direct Amazon to provide ShipStation access to my Selling Partner account and related data. I am responsible for any actions taken by the application then click Confirm.

    AMZ_SET_Connect-Authorize_MRK.png
  6. Adjust any store-specific settings like branding, notification preferences, and product handling on the Settings page.

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 them 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 integration with Amazon allows for the following additional features:

Feature

Description

Merchant Fulfilled Prime

(Amazon.com US orders only)

Supports importing and fulfilling Merchant Fulfilled Prime orders.

For details on how to enable and use this feature, please review the Ship Amazon Merchant Fulfilled Prime article.

Ship by Date

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

Import FBA Orders (Amazon.com only)

By default, ShipStation will not import Amazon orders that are set to be fulfilled by Amazon. Enable this setting in your store settings to allow ShipStation to import FBA orders from your Amazon store for record-keeping purposes. These orders will still be fulfilled by Amazon.

Keep the following in mind before enabling this feature:

  • The orders will not import into ShipStation until after they've been fulfilled by Amazon. They'll be imported into the Shipped status.

  • ShipStation does not import the tracking number or cost for the fulfillment.

  • These orders count towards your monthly shipment subscription limit.

  • Amazon will redact any Personally Identifiable Information from the order data that is provided to ShipStation. This means these orders will not include customer name, street address, phone number, or other information which could identify the customer.

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)

Include Condition Note (Amazon.com only)

By default, ShipStation will import the Condition ID and Condition Subtype ID as the Item Options. Enable this setting, and ShipStation will include the Condition Note as well.

Import Amazon Dimensions (Amazon.com only)

If you enable this setting, ShipStation will attempt to pull the product dimensions from Amazon and use that as the Size for the order. This setting only affects single item orders with a quantity of one.

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's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

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

    The Visit Manage Your Apps button is marked.
  4. Under "Amazon MWS Developer Permissions," select "Renew Access" on each relevant developer access.

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

  6. Edit your Amazon store settings and paste the renewed Access Token.

    Modify Amazon Connection pop-up

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.

Example label with all information blacked out due to Amazon's Data Policy

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.

Additional Details about the Amazon Integration

  • No Awaiting Payment or Pending Payment statuses: ShipStation does not support importing orders in Awaiting Payment or Pending Payment statuses.

  • 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 any additional shipments for an Amazon order, ShipStation will not attempt to update Amazon.

    Splitting Amazon Orders in ShipStation Not Supported

    At this time, splitting Amazon Marketplace orders in ShipStation is not supported as the marketplace notification will fail and the order status will not update in Amazon. If you have already created a label for a split order, you must log in to Amazon Seller Central to update those orders to the Shipped status.

  • Combining Orders: Combining Amazon orders in ShipStation is supported. However, combined shipment notifications is not a supported workflow with Amazon. Notifying Amazon of the shipment with the same tracking number for more than a single order may have a negative effect on your Seller Central's Valid Tracking Rate.

  • 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 the ShipStation 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's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

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