Setting up Integration with Amazon 1P

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

Amazon 1P Synchronization Module Features

With the Amazon 1P module you can:

• Import Amazon Bulk Purchase Orders
• Go through all stages of internal approval to respond to Amazon Bulk Buy Offers requests
• Track which Purchase Orders are based on previously approved Bulk Buy Offers

Setting up integration with Amazon

Amazon Profile Configuration

To initiate Amazon 1P integration, create the application and generate credentials for your store, granting ShopCtrl access to your open API.

1. Login to your Vendor Central Amazon account.
2. From the top right navigation menu, select Integration > API Integration.
   
3. Click Add new app client.
   
4. On a new page fill in the App name:
   
5. Choose API type - SP API.
6. Check the Amazon fulfillment role you would like to grant API access to.
7. Confirm that you will not delegate access to PII to another developer's application.
8. Click Save and exit to create application

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

Getting credentials for your Amazon synchronization with ShopCtrl

To establish the API connection with your Amazon account, collect the following information:

• Vendor code
• LWA Client ID
• LWA Client Secret
• Refresh token

Vendor code

1. Login to your Vendor Central Amazon account.
2. Click on the Settings > Contacts in the top action panel.
   
3. Your Vendor code will be displayed in the combobox.

LWA Credentials

To retrieve the LWA Client ID and LWA Client Secret:

1. Login to your Vendor Central Amazon account.
2. From the top right navigation menu, select Integration > API Integration.
3. Locate the application you created for the integration and click View in the LWA credentials column.
   
4. Both Client identifier and Client secret will be displayed.
   

Refresh Token

1. Login to your Vendor Central Amazon account.
2. From the top right navigation menu, select Integration > API Integration.
3. In the Action column navigate to Edit App button and click on the arrow. In the drop-down menu select Authorise.
   
4. You will be redirected to the Authorise application page.
   
5. Click the Authorise app button. 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

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. Adjust the designated shop settings to process this data correctly.

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 ShopCtrl as a user with the Shop Owner Admin role.
2. Navigate to Configuration > Shops in the menu to access the list of created shops.
3. Choose a specific shop for which you want to configure Amazon synchronization and click Edit to access shop settings.
4. Within the topic menu, select Shop synchronization > Amazon 1P Synchronization.
5. Specify a Region and a Marketplace from which you wish to import orders via this shop.
6. On the Self Authorization pane enter the Vendor code.
7. Provide the LWA Client Id and LWA Client Secret generated for the ShopCtrl private app on Amazon.
8. Enter the Refresh Token.
9. 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
     • Import new orders - imports new orders
     • Import missing orders - enables additional check for missing orders
10. BulkBuy Settings refer to a distinct feature within ShopCtrl, specifically designed for managing Bulk Buy Offers. You can configure these settings at your convenience as part of the comprehensive setup process for Bulk Buy Offers.
11. Order Sync Settings This setting allows for the import of historical orders that already include acknowledgment and cancellation information. Select the appropriate credit reason for rows with "Rejected" and "Cancelled" order statuses.
12. ASN Sync Settings In this section, you can configure document templates needed for a successful ASN packing process. All the configured templates will be used for generating documents for group shipments.
13. Main Order Status mapping Configure the mapping of order statuses by manually selecting the incoming Amazon purchase order status and aligning it with an appropriate ShopCtrl status.
    
14. Payment Order Status mapping Since Amazon purchase orders have a singular main status, and ShopCtrl introduces an additional layer of payment status, you can fine-tune the order status mapping to align the Payment status with the main status of the Amazon purchase order. This customization allows you to adapt the order status mapping to your specific workflow preferences.
15. Amazon Fulfillment Centers ShopCtrl can map predefined Amazon Fulfillment Centers to the provided Ship To Party References. Configure this mapping according to your system preferences. These parameters are added as order parameter ShipToPartyRef to each order after synchronization from Vendor Central.
16. 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.
17. Click Save or Save and Close to apply changes to the shop.

Amazon synchronization streamlines the order management process, ensuring that your ShopCtrl environment stays updated with the latest orders from your Amazon store. It enhances efficiency and reduces the manual effort required to manage orders across different platforms.