Skip to main content

Set up order sync for Amazon

Import orders from Amazon and send order updates back to the marketplace using the Amazon order sync ecosystem in Productsup.

Introduction

Amazon provides sellers with access to the vast customer base on their marketplace, which helps sellers increase online visibility and drive more sales. Productsup lets you synchronize orders between Amazon and your order management, shop, or ERP system. Productsup offers the following order-sync ecosystem to achieve this goal:

  • The data source Amazon Selling Partner API – Orders lets Productsup import your orders from a selected Amazon Seller Central account.

  • The API-based export Amazon Marketplace Shipment Update (SP-API) lets you update orders on Amazon using information stored in your ERP, order management, or shop system, for example, order tracking IDs and carrier information. This way, you can notify your clients about the progress of processing and shipping their orders.

The order data that Productsup imports from Amazon includes Personally Identifiable Information (PII), such as clients' surnames, addresses, phone numbers, etc. To comply with the Amazon Data Protection Policy regarding PII, Productsup has the following measures in place:

  • The platform retains the order data featuring PII for 30 days.

  • The platform obscures the values featuring PII and displays them in Dataflow and Data View as follows:

    obscured PII values in the Preview option in Dataflow
    obscured PII values in Data View

    Note

    When you export order data with PII to your desired system, Productsup sends values without obscuring them. The PII order data is fully visible and readable in your target system.

Prerequisites

To use the Amazon order sync ecosystem in Productsup, you need to:

  1. Be a partner in the Amazon Merchant Fulfilled Network, which is Amazon’s terminology for Fulfilled by Merchant.

    The Amazon order sync ecosystem in Productsup is available only for the Amazon Merchant Fulfilled Network partners who manage storage, shipping, and customer support independently from Amazon.

  2. Have the Order Sync feature activated in your organization.

    The Amazon order sync ecosystem is an additional feature of the Productsup platform. Reach out to your Customer Success Manager to activate it.

Import order data from Amazon

To get your Amazon order data to your ERP, order management, or shop system, you need first to import your Amazon order data into your Productsup site:

  1. Go to Data Sources from your site's main menu and select ADD DATA SOURCE.

  2. Search for Amazon Selling Partner API – Orders and select Add. Give it a custom name as desired and select Continue.

    Amazon Selling Partner API - Orders

  3. Choose the market of interest in Marketplace ID.

  4. Select what orders to import depending on the date of creation or last update:

    • Orders Created After or

    • Order last updated after.

    Import Amazon orders after the date

    Note

    You can't leave both fields empty and can't set both parameters at the same time. You must set either Orders Created After or Order last updated after.

    If you need to set both parameters to function as OR behavior, you must create two main data sources in the same site. In one data source you set Order Create After and in another, Order last updated after.

  5. Activate Import Address to import address details for business orders.

  6. To import only the orders with specific statuses, select the needed statuses in Import Only Statuses.

    Tip

    Hold the Ctrl or Cmd key to select multiple order statuses or hold Shift to select a range of statuses.

  7. Optionally, activate Import customized data to extract JSON data from zip files linked in the item_BuyerInfoBuyerCustomizedInfoCustomizedURL attribute and display it in a new Customizable data attribute without importing any images from the zip.

  8. In Authentication, choose the Amazon authentication you previously set up in your organization, project, or site. If you haven't set up Amazon authentication yet, perform the following steps:

    1. Select Add New Authentication.

      Select Authentication

    2. Select Amazon Authentication (BETA version by Amazon) in Type. You can optionally give your authentication a name.

    3. Select Next.

    4. If applicable, select Region and Country to choose your marketplace country and locale.

    5. Select Connect.

      Important

      Before proceeding, Productsup redirects you to Amazon to finalize your authentication. After completing the authentication setup, Amazon redirects you back to Productsup.

    6. Close the confirmation window to proceed.

  9. Optionally, enter a custom description for the data source in Description (optional). The new name of the data source will change in the Data Sources overview page.

  10. Select Save.

  11. Select Run in the top-right corner of your view to let the site import your order data from Amazon.

Once you set up the data source Amazon Selling Partner API – Orders, you can go to Exports to add and set up an export and send your order data to the target channel, such as your ERP, order management, or shop system. Before running your export, you must map the mandatory attributes in Dataflow.

Export shipment updates to Amazon

To update your orders on Amazon with information stored in your ERP, order management, or shop system, do the following:

  1. Take the steps to import your Amazon order data into Productsup and your desired target system. See Import order data from Amazon.

  2. Create a new site in your Productsup organization. This site has to be separate from the site that imports your order data from Amazon.

  3. Go to Data Sources from the main menu of the newly created site and select ADD DATA SOURCE to add and set up your ERP, order management, or shop system as a data source. When done, select Run in the top-right corner of your view to run the site and let the platform import your shipment data into Productsup.

  4. Go to Exports from your site's main menu and select ADD EXPORT.

  5. Search for Amazon Marketplace Shipment Update (SP-API), hover over it, and select Add.

    Add the export Amazon Marketplace Shipment Update (SP-API)

  6. Select Add Destination, choose Amazon Selling Partner API - Shipment update from the drop-down list, give it a name as desired, and then select Save.

    Add the Amazon Selling Partner API - Shipment update destination

  7. In Authentication, choose the Amazon authentication method you previously set up in your organization, project, or site.

  8. Choose the market of interest in Marketplace ID.

  9. Toggle the Feedback Import button to Off if you don't want the platform to receive feedback files from Amazon.

    This feature is active by default to let Productsup receive a feedback file from the Amazon Selling Partner API in case of errors. This helps to troubleshoot the export setup.

    Note

    If you want the platform to receive feedback files from Amazon, leave the Feedback Import button On.

    Optionally, you can change the connection attributes that let you add the export feedback to your site:

    1. In Feedback file connection column, give a custom name to the attribute that should contain the export feedback and appear as an additional attribute in Dataflow or Data View.

      By default, the attribute's name is ___amazon_item_id.

    2. In the drop-down menu Main feed connection column, choose the attribute corresponding to your unique order identifier. For example, it can be AmazonOrderID or any other attribute containing this data if your internal system uses a different attribute name for it.

      feedback file connection column for Amazon

  10. Toggle the Active button to On to activate the destination.

  11. Select Save.

  12. Go to Dataflow and select Amazon Marketplace Shipment Update (SP-API) in the drop-down menu on the left to map all relevant attributes from import to export.

  13. Once your data is ready for export, select Run in the top-right corner of your view to send shipment updates to Amazon.

The export Amazon Marketplace Shipment Update (SP-API) has the following attributes at the export stage in Dataflow and Data View:

Attribute

Mandatory or not

Meaning and expected values

AmazonOrderID

Mandatory

Your order ID as expected by Amazon.

MerchantOrderID

Mandatory

Your order ID as specified in your internal systems.

FulfillmentData.ShippingMethod

Mandatory

The shipment method used to deliver the order.

FulfillmentDate

Mandatory

The expected shipment date for the order.

FulfillmentData.CarrierCode

Mandatory

The code of the carrier company that delivers the order. For example, DPD, DHL, AMZL_UK, AT POST, or ParcelOne.

See Accepted CarrierCode values for more carrier codes.

FulfillmentData.CarrierName

Mandatory in some cases

The name of the carrier company that delivers the order. This field is mandatory only if your carrier company isn't on the list of carrier codes accepted by Amazon, so you provide the value Other in FulfillmentData.CarrierCode.

MerchantFulfillmentID

Optional

The ID of the shipment as specified in your internal systems.

FulfillmentData.ShipperTrackingNumber

Optional

The shipment tracking number that helps the buyer track the delivery progress.

Item.AmazonOrderItemCode

Optional

The code of the ordered item as assigned by Amazon.

Item.MerchantOrderItemID

Optional

The ID of the ordered item as specified in your internal systems.

Item.MerchantFulfillmentItemID

Optional

The unique identifier for the shipment of the ordered item as specified in your internal systems.

Item.Quantity

Optional

The number of shipped items if you send the ordered items as multiple separate deliveries.

In this section: