Amazon Marketplace Integration

IN THIS GUIDE

Overview
Integration Setup | Login and Register | Select Marketplaces
Settings | Import Orders | Feed Log
Canceling Orders
Special Features
Working with Multiple Amazon Marketplace Regions
FAQ

Overview

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

This guide will go over the settings and features for the Amazon Marketplace integrations. If you are looking for information about the Fulfillment by Amazon (FBA) integrations, please see this guide instead.

What's the difference between Amazon Marketplace and FBA?

While both the Amazon Marketplace and Fulfillment by Amazon (FBA) integrations are part of your Amazon Seller Account (Amazon MWS), the Marketplace integration is for downloading Amazon orders into Order Desk, and the FBA integration is for sending orders from Order Desk to Amazon for fulfillment.

Amazon orders that were fulfilled by FBA directly through Amazon (AFN) can be downloaded from the Marketplace Integration. The FBA integration is only used for sending orders to Amazon for fulfillment.

Make sure you are connecting to the correct integration(s) when setting up your store.

Integration Setup

To enable the Amazon Marketplace integration, click on Manage Integrationsunder the Integrations menu in the left sidebar:

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

Login and Register

Complete the connection between Order Desk and your Amazon Marketplace account(s) by following the prompts in the integration.

Step 1: Login to Amazon

Select the primary country for the region you are enabling from the dropdown. Click Login to Seller Account.

This opens Amazon in a new tab. Keep Order Desk open in your current tab so you can copy some information back over from Amazon as you go through the next steps.

Step 2: Add Credentials

To connect to Amazon Marketplace, you will see the developer name and ID to take into your Amazon account. You will also need to enter your Seller ID and MWS Auth Token into Order Desk to complete the connection. 

INVALID SELLER ACCOUNT TYPE
Amazon has specific requirements for using MWS. If you're having trouble accessing these settings in MWS, make sure your account fits their requirements—more information here. This needs to be addressed directly with Amazon; Order Desk is not able to help.

Select Marketplaces

Select your marketplaces to tell Amazon which ones to pull your orders from when sending them into Order Desk:

Most merchants will select Amazon.com 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.

Settings

Under the Settings section, choose how to set up your Amazon integration and what features you want enabled:

Automatically Check

Select how often to download orders from Amazon. Options include: Never, Every Day, Every Twelve Hours, Every Six Hours, Every Two Hours and Every Hour.

Folder for New Orders

Choose the folder where you would like newly downloaded orders from Amazon to be placed. If you would like to use your own custom folders, see this guide for instructions on how to create them.

Sync Tracking Numbers

If enabled, when shipments are added to orders, Order Desk will send the fulfillment details back to Amazon to fulfill the orders and notify your customers.

Sync Inventory

Enable the Sync Inventory option to send inventory counts to Amazon Marketplace.

This will report the inventory that is available in Order Desk to Amazon. Any SKUs which Amazon does not recognize will be ignored. For more information on how inventory syncing works, read this guide.

Inventory Location Filter

If you only want to download specific orders, you can use the Inventory Location Filter field to specify which ones you want. Enter multiple locations separated by a comma. 

The inventory location name must match exactly as it is on your inventory items in Order Desk. When importing new orders from Amazon, Order Desk will look at the SKUs on the items and compare to the SKUs in your inventory here. Any orders with items for a location that  isn't listed in this field will not be imported.

For this to work, your inventory must be added to Order Desk. The inventory Location should be set on each item. For details, please see How to Add Inventory and How to Store Extra Item Details.

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.

Download FBA Orders

If you send Amazon Fulfilled Orders (AFN) to FBA directly from Amazon but you still want to download these orders to Order Desk, select the Download FBA Orders option.

If you would also like to have the tracking numbers reported to Order Desk as Amazon fulfills these orders, you will need to have the corresponding FBA integration enabled in Order Desk.

IMPORTANT
If you download shipped or FBA orders, make sure you do not have any fulfillment service integration setting enabled that automatically submits all orders and that any rules you have are set up to filter out these orders. Continue reading for instructions on how you can filter these orders out of the way.

To prevent any shipped or FBA (AFN) fulfilled orders from inadvertently being sent for fulfillment a second time, make certain you do not have any other fulfillment or shipping integrations set to automatically submit all orders. You can check this by going into any other fulfillment integrations you have enabled in your store and looking for a setting like this:

If disabled, orders can only be sent manually or automatically with a rule, allowing you to filter out the orders that should not be sent for fulfillment. You can use the Rule Builder to set aside any AFN orders so they aren't sent for fulfillment as they're downloaded into Order Desk.

As an example, set up a rule to move all AFN orders to the Closed folder. The rule would specify that when an order is imported, If Order Metadata Field amazon_fulfillment_channel Equals AFN, the order should be moved to the closed folder:

Once this rule is in place, make sure any other rules submitting orders for fulfillment are not pulling orders from the folder you chose for these AFN orders.

You can also include a safety filter to exclude AFN orders in any rules that are submitting unfulfilled orders to an integration or vendor:

If Order Metadata Field amazon_fulfillment_channel Does Not Equal AFN

There are many ways 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 Amazon orders, or if you have your integration set to never download new orders, you can manually import 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.

Canceling Orders

You can cancel your Amazon Marketplace orders from within Order Desk. To do this, open up the order page and look for the cancel settings under the order totals information:

Select the reason for the cancelation from the dropdown:

Then click the Cancel Order at Amazon Marketplace button. This will start a submission process of the acknowledgement feed to Amazon. After this button is pressed, there will be a five minute delay in case any other orders are also canceled. After five minutes have passed, the feed will be submitted to Amazon and the order(s) canceled.

Special Features

With Amazon Marketplace, you can send updates to Amazon on the items in your orders if these details are stored as item metadata on your inventory items here in Order Desk. 

Field Name Field Description
SwitchFulfillmentTo
Set either AFN or MFN.
FulfillmentLatency
Number of days for handling time.

For information about storing item metadata, please see the  How to Work with Inventory Details guide.

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. Contact Order Desk support if you need help setting up these rules. 

Single Fulfillment Service

If all orders you download are going to be 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 into 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 your separate vendors and fulfillment services.

Follow the instructions in the Submitting Orders to Amazon FBA Worldwide guide to see how those rules will look. While that guide is specific to sending orders to FBA, you can see the rule structure needed and apply it to any other integration.

FAQ

Do you support Amazon Handmade?

Yes. Amazon Handmade orders will be imported by the regular Amazon Marketplace integration for the region you sell in.

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 called vat_tax on the order. 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 or emails.

How do I download my FBA orders?

Despite how it sounds, you cannot download FBA orders with the FBA integration. Instead, 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