Amazon
  • 13 Sep 2022
  • 6 Minutes to read
  • Dark
    Light
  • PDF

Amazon

  • Dark
    Light
  • PDF

Required Permissions

An employee must be assigned to the shop with a Shop Owner Admin role to perform actions referred to in this article.

Amazon integration connector lets you import orders and products from your Amazon seller account using API integration directly to ShopCtrl.

Amazon Synchronization Module Features

With the Amazon module you can:

Setting up integration with Amazon

Amazon Profile Configuration

  1. Login to your Seller Central Amazon account.
  2. From the top right navigation menu, select Partner Network > Develop Apps.
    Step01
  3. Click Your Developer Profile.
    Step02
  4. On a new page fill in your company Contact Information:
    Step03
  5. In the Data Access select this option to describe your organization:
    "My organisation participates in Amazon Services Europe, and I want to integrate to manage my own business only."
  6. Select the areas of the Amazon store to which you would like to grant API access.
    • Brand Analytics
    • Product Listing
    • Pricing
    • Buyer Communication
    • Inventory and Order Tracking
    • Direct to Consumer Delivery
      Step04
  7. Describe the Use Case for which you would like to retrieve data from Amazon.
  8. Specify the Security controls used in your organization.
    Step05
  9. Read and confirm the Amazon Agreement and Policies.
  10. Click Register to apply for API access.

After creating a profile, Amazon will take some time to review and approve it.

Create an application

Once Amazon approves your developer account, we could proceed with creating the application to generate credentials to your store and give ShopCtrl access to your open API

  1. Open the Developer console page.
    Step08
  2. Click Add new app client.
  3. The new application details will be opened on a new page. Fill in the App name.
    Step07
  4. Select an API Type - SP API.
  5. Fill in the IAM ARN provided by ShopCtrl: arn:aws:iam::883858241360:role/SellingPartnerRole.
  6. Select the Roles you would like to grant API access to.
  7. Select whether you would like to delegate access to PII to another developer's application: No, I will not delegate access to PII to another developer's application.
  8. Leave the OAuth fields empty.
  9. Click Save.

The new app will be displayed on your Developer Central account:
Step08

Getting credentials for your Amazon synchronization with ShopCtrl

To establish the API connection with your Amazon account, we need to provide the following information:

  • Seller ID
  • LWA Client ID
  • LWA Client Secret
  • Refresh token

Seller ID

  1. Login to your Seller Partner account.
  2. Click on the gear icon in the top action panel. And select Account Info.
    Step12
  3. You will be redirected to the Seller Account Information page. within Business Information pane, click on Your Merchant Token link.
    Step13
  4. You will be redirected to the Merchant Token page. Which is your Seller ID.
    Step14-01

LWA Credentials

To retrieve the LWA Client ID and LWA Client Secret:

  1. Go to your Developer console page.

Step08

  1. Click View in the LWA credentials column. Both Client identifier and Client secret will be displayed.
    Step09

Refresh Token

  1. Open the Developer console page.
  2. In the Action column navigate and click on the arrow. In the drop-down menu select Authorise.
    Step10
  3. You will be redirected to the Authorise application page.
    Step11
  4. Select Marketplace(s) that you would like to authorise your app at.
  5. Click Authorise app button.
  6. This will generate the Refresh Token.

Setting up shop synchronization in ShopCtrl

Once you have enabled integration in your Amazon account, you can set up synchronization in ShopCtrl. It will consist of two steps.

1. Configuring shop in ShopCtrl

Before start

Before enabling synchronization with Amazon, please set up the corresponding shop currency, VAT tariffs, and payment types for your ShopCtrl shop.

To continue setting up the shop in ShopCtrl, we need to determine how the customer contact information is stored. Amazon sends customer names as well as customer addresses as single fields to ShopCtrl. We need to change the designated shop settings to process this data correctly.

shop-settings-contact-info

To change the way customer contact information will be stored in ShopCtrl:

  1. Log in to your ShopCtrl account as a user with the Shop Owner Admin role.
  2. Open the shop settings page for which the Amazon connection was established.
  3. Within the topic menu, expand the Contacts nod and click Contact Info.
  4. Change the Address detail setting to One field for street name, house number and extension.
  5. Change the Name detailsetting to One single field for contact person name.
  6. Click Save or Save and Close to apply changes to the shop.

2. Setting up Amazon shop synchronization in ShopCtrl

  1. Log in to your ShopCtrl account as a user with the Shop Owner Admin role.

  2. In the navigation menu, select Configuration > Shops to open the list of shops created.

  3. Select a shop for which you would like to set up Amazon synchronization and click Edit to open shop settings.

  4. Within the topic menu, select Shop synchronization > Amazon Shop Synchronization.
    amazon-synchronization-shop-settings(1)

  5. Select a Region and a Marketplace which orders you would like to import through this shop.

Please note

You can set up synchronization with only one region, but it is possible to select several marketplaces per region. This means that orders from all marketplaces will be imported in one shop in ShopCtrl.

  1. Select Self Authorization Kind.
  2. Provide the Seller ID (Your Amazon Merchant Token).
  3. Provide the LWA Client Id and LWA Client Secret generated for the ShopCtrl private app in Amazon.
  4. Provide the Refresh Token.
  5. In the Synchronization Customization pane, check the features you would like to use. At the moment, the following features are available:
    • Orders Integration - a general setting that enables order import
      • PII Access - imports your customer's personal identifiable information for order processing
      • Import new orders - imports new orders
      • Import missing orders - check this feature to exclude all possible synchronization mistakes and import orders that went missing for any reason
      • Export cancelled orders - updates orders cancelled in ShopCtrl to Amazon
      • Export shipments - exports tracking codes to Amazon
      • Export returns - exports returns created in ShopCtrl to Amazon
    • Products Integration
      • Export changed product stocks - enables inventory export to Amazon
      • Export changed product prices - updates corresponding listing prices
      • Sync product publish state - closes or opens listings based on product publication status in ShopCtrl
  6. In the Additional Settings pane, select the main order status that will be set while importing for the orders fulfilled by Amazon. To guarantee that the orders won't be fulfilled twice.
  7. (Optional) In the Fulfillment Priority tab you can change the default fulfilment priority which is set for regular, premium and prime orders after import.
  8. (Optional) The order statuses mapping is performed automatically, but you could override it by setting up statuses mapping manually:
    amazon-order-status-mapping

Here is the Amazon order statuses flow for your reference:
amazon-statuses

  1. Map each of the Shipment Categories configured in your Amazon seller account to the ShopCtrl Carrier Account and Amazon Carrier Name and Delivery Service. You could choose a name from the carriers and delivery services list or enter it manually.
Please note

Amazon verifies submitted tracking codes along with the carrier name and shipment method used to deliver the order.
In order to get the carrier processed correctly, ShopCtrl carrier accounts need to be mapped to corresponding carrier names and delivery services recognizable by Amazon.
The incorrect mapping might affect the Amazon VTR calculation. See more Valid Tracking Rate

amazon-carrier-account-mapping

  1. Once all of the steps are finished, you can Enable synchronization by marking the checkbox at the top of the settings page. Your orders will be synced in the background.
  2. Click Save or Save and Close to apply changes to the shop.

What's Next