Amazon Marketplace


Integration Setup
Login and Register
Select Marketplaces
Import Orders
Feed Log
Working with Multiple Amazon Marketplace Regions


With Order Desk, you can connect to any Amazon Marketplace region to import your Amazon and Amazon Handmade orders. Tracking information will be sent back to Amazon as orders are fulfilled.

Previously, a separate Order Desk store was required to connect to each separate Amazon region, but in June 2017, an update was made to treat each region as a separate integration, allowing you to connect to multiple regions from the same Order Desk store.

This guide will go over the settings in the Amazon Marketplace integrations. For more information on the Fulfillment by Amazon (FBA) integrations, please see this guide, and for instructions on how to submit orders to FBA, see this guide.

Tip: Many merchants are unsure about the difference between the Amazon Marketplace and Fulfillment by Amazon (FBA) integrations. To clarify, while both are often referred to as Amazon Seller Accounts or Amazon MWS, Amazon Marketplace is the integration that lets you import your Amazon orders to Order Desk, and Amazon FBA is the integration you need if you intend to send your orders to Amazon for fulfillment.

If you have Amazon orders that were fulfilled by FBA directly through Amazon (AFN), you'll need to enable the Marketplace Integration to bring these in, as the FBA integration is specifically for submitting orders to Amazon.

Integration Setup

To enable Amazon Marketplace, look in the lefthand sidebar and click on Manage Integrations under the Integrations menu:

Under the Shopping Carts tab, click to enable any of the Amazon Marketplace regions you need to connect to your Order Desk store:

All five regions are available and can be found under the Shopping Carts tab: Amazon North America, Amazon Europe, Amazon Japan, Amazon China and Amazon India.

Tip: If you have an older Amazon North America account that requires a separate login for Canada and the US, you will need to connect them using two integrations: our original Amazon Marketplace integration and Amazon Marketplace NA. If you already have the original Amazon Marketplace integration enabled, keep it enabled and use the NA integration to connect to the other account. If you are signing up after June 2017 or do not already have the original Marketplace integration enabled on your account, please contact Order Desk support and we will be happy to enable this for you.

Login and Register

Once enabled, you will need to follow a few steps to complete the connection between Order Desk and Amazon Marketplace. This guide will use Amazon NA as an example, but the steps are the same for each region.

Step 1: Login to Amazon

Select the primary country for the region you are enabling from the dropdown and click Login to Seller Account. This will open Amazon in a new window to allow you to go through the next few steps. Keep Order Desk open in your current window as you'll need to copy some information back over from Amazon.

Step 2: Register

On the MWS registration page, you'll have some options from Amazon. Find the option that lets you access your own Amazon seller account with MWS. If you have already registered or are not finding this option in your Seller Central account, click on the orange Register as a Developer button on the User Permissions page.

On the following page, accept the Amazon MWS License Agreement and click through to the next page.

Tip: Amazon has certain requirements for which of their accounts can use MWS. If you are unable to find the right settings while registering or Amazon isn't allowing access, please be sure your account fits their requirements. For more information, read Amazon's page on MWS.
Step 3: Enter Account Identifiers

In Amazon, you'll have some account information that needs to be copied over to Order Desk to complete the connection between services. Look for your Seller ID, Primary Marketplace ID, AWS Access Key ID and Secret Key.

You will also need your Merchant Token which can be found in your regular Seller Central dashboard under Settings / Account Info / Business Information.

Paste each of these into the appropriate fields in Order Desk:

Last, select your Default Marketplace, if applicable, for regions with more than one country. This is typically going to be the primary country you work with in the region you're connecting to.

Select Marketplaces

Select the relevant marketplaces for your account to tell Amazon from which specific marketplaces to download your orders.

Generally, most merchants will select for North America, but if you also have country specific marketplaces or are connecting to a region other than North America, be sure to include the appropriate marketplaces for your account:


Under the Settings section, you can choose how you want to set up your Amazon integration.

Automatically Check

For Order Desk Pro accounts, you will be able to select how often you want to bring in your Amazon orders in the Automatically Check section:

Free Order Desk stores will only be able to check for new orders once per day.

Folder for New Orders

Choose the folder where you want all new Amazon orders to be placed as they are downloaded:

Sync Tracking Numbers

As shipments are added to your orders, if Sync Tracking Numbers is enabled, we will send those notifications back to Amazon to notify your customers.

Sync Inventory

Order Desk Pro stores can enable Sync Inventory if they want to send their inventory counts to Amazon Marketplace.

This will report the inventory that you have available in Order Desk to Amazon. Any SKUs which Amazon doesn’t recognize will be ignored. For more information on how inventory syncing works, please read this guide.

Download Shipped Orders

If you have orders in Amazon that have already shipped but you want to download them to Order Desk for your records, select the Download Shipped Orders option:

Be sure that you aren't automatically submitting every order to a fulfillment service if this is selected, as these orders can inadvertently be resubmitted for fulfillment.

Download FBA Orders

If you send Amazon Fulfilled Orders (AFN) to FBA directly from Amazon, but you still want to download those orders to Order Desk for your records, select the Download FBA Orders option:

If you would like to download FBA orders and also have the tracking numbers reported to Order Desk, you will need to have the corresponding FBA integration enabled on Order Desk as well.

Tip: For shipped and FBA orders being downloaded, be sure that you aren't automatically sending every order to one of your fulfillment services, as you can accidentally fulfill completed orders a second time.

You can use the Order Desk Rule Builder or integration specific settings, where applicable, to filter your orders and ensure any shipped or AFN orders aren't sent for fulfillment after being downloaded to Order Desk.

As an example, use a rule to move AFN orders to the Closed folder, where the condition in the rule says: If Order Metadata Field = amazon_fulfillment_channel|AFN:

Any other rules sending orders for fulfillment will need to exclude the Closed folder. Given the customizable nature of the rule builder, there are many different ways possible to set up rules to prevent these orders from being sent for fulfillment. If you need help with this, please contact Order Desk support.

Import Orders

If you would like to import older orders, or if you have your integration set to never download new orders, you can manually import your orders by entering the date in the Import Orders field and clicking Check. This will bring in all orders that fit your saved settings, if they haven't already been downloaded to Order Desk, from that date forward.

You may need to run the check a few times if you have a large number of orders. The date will gradually move forward until it reaches the present and all orders have been found and imported.

Feed Log

If you are interested in seeing the list of feeds that have been submitted to Amazon, you can click on the Get Submitted Feed Log button down at the bottom of the integration settings page:

You can click through to see the results of each feed submission, which can be helpful for debugging. This information can also be retrieved from the MWS Scratchpad.

Working with Multiple Amazon Marketplace Regions

If you are enabling multiple Amazon Marketplace integrations for separate regions, you may need to set up some rules and/or custom folders, depending on where these orders are being sent. This will be a completely custom setup for each store based on your specific requirements, but we'll provide some general guidance here to get you started.

If, after reading through these guides, you aren't certain about or comfortable with setting up your store, please contact Order Desk support, and we will be happy to assist you. Before contacting us, it helps to already have all of your integrations enabled. Also please provide as much detail as you can about how your orders will be fulfilled so we can help create the rules you need.

Single Fulfillment Service

If all orders are being sent to one fulfillment service, regardless of where the orders are coming from, you can either use the integration's settings to automatically submit all orders to that service, if applicable:

Or create a rule that says to submit orders to that fulfillment service as they are imported to Order Desk:

Multiple Fulfillment Services

If your orders will be sent to multiple fulfillment services, this will require a little more set up, depending on where they are going and how you determine which orders go to separate places.

It may be that you'll just need to set up rules by shipping country to send to separate fulfillment services. If that is the case, you can follow the instructions in our Submitting Orders to Amazon FBA Worldwide guide to see how those rules will look. If you aren't sending your orders to FBA but you are still separating them by shipping country, your rules might actually still look very similar, so it's recommended that you read through the guide to look at the rule structure, and then contact Order Desk support if you still need help with the setup.

Some integrations will have settings where they pull orders from a specific folder. Double check your integration settings to see if this is the case. If so, you will need to set up a rule to move orders to that folder and let the integration take over from there.

Tip: If you still need help with setup, we will be happy to work with you. Please enable all of your integrations and provide us with as much detail as possible about where your orders are coming from and how you decide where they are to be submitted. With these details, we can more quickly help you get your store running automatically.


Do you support Amazon Handmade?

Yes. Amazon Handmade orders will be imported by the regular Amazon Marketplace integration for the region you sell in. One important limitation to be aware of is that we are not able to bring in notes with the order details from Amazon Handmade, including personalizations. You will need to get these directly from Amazon and manually add them to orders in Order Desk.

If you are working with Print on Demand products, please refer to our Print on Demand Fulfillment guide for a thorough overview of how to use Order Desk with your print on demand store.

Will VAT taxes be included in orders from Amazon Marketplace?

Yes, for any orders coming in from Amazon Marketplace EU, the VAT tax will not be added on as an extra tax but will instead be included in the price. The VAT amount will also be set as a metadata field on the order called vat_tax. If you are sending these orders to Shopify for fulfillment, the VAT tax will be figured into the order total in Shopify, otherwise, you can use this metadata field if you need to include or display the VAT tax amount in any templates, exports, emails, etc.

How do I download my FBA orders?

Despite how it sounds, you can't download your FBA orders with the FBA integration. You will need to enable the Amazon Marketplace integration to import orders already fulfilled by Amazon (AFN) by FBA. Any orders coming from Amazon will be imported through the Marketplace integration, which is an order source. Any orders going to Amazon for fulfillment will be submitted through the FBA integration, which is a fulfillment service. Please read this section of this guide for more details.

My Amazon integration won't connect to Order Desk due to an error about MWS. How can I fix this?

If you're unable to make the connection between Amazon and Order Desk, or you previously made the connection and are now getting the error: Connection to Amazon FBA failed: Connection Error: The seller does not have an eligible Amazon account to call Amazon MWS. For more information about eligible accounts, see the Amazon MWS documentation, this means that Amazon prevented or disabled your connection due to your MWS eligibility. Please read their documentation on MWS and be certain that your Amazon account is in good standing and using the right plan for access to MWS.

Still need help? Contact Us Contact Us