Install and configure the Amazon app

We recommend that you read our prerequisites and guide available  here  before attempting an implementation.

Install & connect Amazon marketplaces

To connect Amazon to Brightpearl you will need to:

  1. Install the Amazon app in your Brightpearl account.
  2. Regsiter with Amazon MWS and get your account identifiers which will give Brightpearl permission to talk to your Amazon account.
  3. Add each Amazon marketplace as a channel in Brightpearl with your chosen synchronization options.

How to install the Amazon app

  1. In Brightpearl, go to  App Store > Amazon .
  2. Click Turn on  against the Amazon integration, you can’t miss it! You'll be taken straight to the setup screen to add your first marketplace.

turn o amazon app

How to register with Amazon MWS

  1. Go to your Seller Central account > Apps & Services > Manage your apps > Authorize new Developer 


  1. Enter the following credentials:
  • Developer name: Brightpearl
  • Developer account number for European sellers: 8977-7545-2683
  • Developer account number for US sellers: 3260-3202-8765

amz dev details

  1. Make a note of your Seller ID and MWS Authorization Token , you will need to put these into Brightpearl.

amz auth details

How to add an Amazon marketplace

Each Amazon marketplace is added separately in Brightpearl, even if they all belong to the same seller account. For example, a single Amazon seller account can be used for UK, Germany, Spain, Italy and France - add each of these separately in Brightpearl. Once you've added the first one using your seller account identifiers you can simply select them from the list to re-use them.

  1. Go to  App store > Amazon > Turn on Amazon or Setup if it is already installed.
  2. Click the  Connect Amazon marketplace  button.
  3. Select the Amazon marketplace you are adding.
  4. If you have already added a marketplace for this Amazon seller account find your Seller ID, Merchant Token and Auth Token by clicking on Select existing merchant ID. If this is your first marketplace for the seller account enter your Seller ID and MWS Authorization Token (by registering with MWS) and your Merchant Token (from Seller Central > Account info).

amazon details select existing

  1. Give this marketplace a name, this is how you’ll see it displayed throughout Brightpearl.
  2. In the Sync prices section, make the following selections:
Brightpearl will automatically update the price of Amazon listings connected to Brightpearl products in near real time. This occurs when you save a product connected to a listing or update its price on the price list for our Amazon marketplace. If, for some reason, prices are not syncing, try enabling and disabling the 'Sync pricing' setting. 
  • Sync pricing - Check this box to activate price updates from Brightpearl.
  • Price lists - Select the price list to be used for updating listings, ensure it is the same currency as the Amazon store.

amz price sync

  1. In the Sync inventory section, make the following selections:
  • Sync inventory - Check this box to activate inventory updates from Brightpearl. If inventory syncing is activated, the on-hand quantity in Brightpearl will be uploaded to Amazon at the point that the listing is first connected; and when the on-hand inventory levels subsequently change.
  • Warehouse for allocating merchant fulfilled orders - Select the Brightpearl warehouse which will be assigned to downloaded orders. Inventory will be automatically allocated from this warehouse (even when synchronizing inventory levels from multiple).
  • Warehouse for allocating fulfilled by Amazon (FBA) orders - You will need a separate warehouse for managing FBA stock. Ensure it is selected here so that your main stock is not affected. You can set an FBA warehouse by channel as opposed to the seller account.
  • Warehouse for calculating on-hand inventory levels from merchant fulfilled listings - Select 1 or more warehouses. The combined on-hand inventory levels will be updated on Amazon. Note that Amazon will automatically include FBA stock on your listings so you do not need to select your FBA warehouse.

amz inventory sync

  • Fulfillment latency - Amazon handling times can be controlled at a listing level. To start controlling handling days per listing, record the number of days in a product custom field (numerical) and select the custom field on the Amazon settings. The default handling days will then only be used where no product specific handling days have been set.
    NOTE: The fulfillment latency will only be updated if product's on hand level changes. 


  • Bulk inventory update - You can run bulk inventory update manually up to 3 times a day. Brightpearl will also perform nightly bulk inventory update. 
  1. In the Sync orders section, make the following selections:
  • Start orders downloading from - Set the date on which orders should begin downloading. This is mainly used during the implementation of your Brightpearl account ready for your go live day. It is not possible to download old Amazon orders or any orders placed during which your Amazon order sync does not have a current active date.
  • Status for new orders - Select which sales order status to apply to orders when they download. This doesn't have to be unique for Amazon orders, you may choose to use one such as "online sales" for all integration - remember that you can identify where orders came from using sales channels.
  • Status for new Prime orders - Leave blank to use the same status as non Prime orders.
  • Number of days to attempt to create orders for -You can set the cut off (1 to 10 days) for orders that haven’t beed downloaded from Amazon due to occasional lapses in information that comes from Amazon, so you can create any delayed orders manually.
  • Channel branding - Select which company details to use on templates for orders downloaded from this channel.
  • Payment Method
  • Nominal code for Amazon fees - Select the nominal code into which fees should be recorded for accounting purposes.
  • Custom field to capture gift messages - To ensure you can view any gift messages on your Amazon orders create a custom field for your sales orders and select it here.
  • If you see a warning message about shipping methods it will be cause you have no shipping methods created in your Brightpearl account. Amazon require a shipping method when the shipment notification is sent from Brightpearl. If you don't have at least one shipping method in Brightpearl your Amazon orders will not be marked as shipped.


Note that additional FBA options are available if you have selected an FBA warehouse.

  • Status for new fulfillment by Amazon (FBA) orders - You choose for these orders to use the same status as your merchant fulfilled orders or a different one which will allow you to easily identify them.
  • Automatically mark FBA goods out notes as shipped? - If you opt for them to be automatically marked as shipped you won't have to do it manually. You may, however, prefer to wait for confirmation from Amazon before you manually mark them as shipped, in this case opt out and it will simply create a goods-out note, but make sure those get filtered out from the rest of your goods-out notes during picking and packing.


  • Capture other transactions - enable this feature to download transactions that are not directly related to orders and fees. 
  • Use download date for payments - This will use the date of the XML Payment download file on the payments and fees journals created rather than order created date.
  • Send shipment updates for - If you are using ShipStation, set your Seller Fulfilled Prime Order choose to skip the shipment notification. 
  • Custom field to specify seller fulfilled prime orders  - SFP orders can be easily identified using a custom field to create a permanent "prime flag", allowing you to filter those orders out and process them first.
  • Custom field to specify business orders - New Business orders can be easily identified in Brightpearl by using a Yes/No custom field. Create the custom field and select it on the Amazon channel settings.
  • Custom field to specify purchase order number - This number can be captured in a custom field on the order in Brightpearl. Create a freetext custom field. 
  • Amazon withheld tax payment method - When Amazon withhold a tax amount a separate order payment will be created. The payment method used should be set up with a liability bank account specifically for this purpose. Read more about Amazon withheld tax here. Screen_Shot_2018-12-07_at_12.55.04_PM.png
  1. Click the  Connect Marketplace  button to finish.

As soon as a marketplace is added your Amazon listings will begin to download, go to Channels > Amazon > Listings. You will need to connect all of your listings to Brightpearl products to start synchronzing prices and inventory and to ensure that inventory is allocated to sales orders when they download. If listings are not connected to products the orders will download but will use miscellaneous non-stock tracked products.

Connect Amazon listings to Brightpearl products

Once the Amazon account has been added and authorized in Brightpearl, the existing listings will be displayed in Brightpearl at  Channels > Amazon > Live Amazon listings .

Brightpearl will check for listings every 5 minutes so don't worry if they are not displayed immediately.

What do I need to do?

Each listing needs to be connected to a product in Brightpearl to be able to synchronize inventory and prices and to allocate inventory to downloaded orders. You will need to do this from within Brightpearl - it can be done in several ways as described in this guide.

If orders download before products are connected then they will be added as miscellaneous line items, and not the stocked product.

Connect Amazon listings to Brightpearl products

A connection can be established in several ways. use this table to see which options are available depending on whether you have a listing, product or both:

Do you have an active Amazon listing?    Does a product exist in Brightpearl?    The connection options available are:
quiz correct quiz correct

Auto-connect SKU-to-SKU

Manually search & connect

quiz correct quiz incorrect

Create a product from the listing

Create the product & then connect

quiz incorrect quiz correct

List on Amazon then connect

quiz  incorrect quiz incorrect

It is not possible to publish listings on Amazon from Brightpearl, so you will need to list directly on Amazon and then either use that listing to create the product, or create the product and then connect.

Note that the current on hand quantity in Brightpearl will be uploaded to Amazon at the point the product and listing are connected, if inventory syncing is active. Subsequent changes to the on hand quantity in Brightpearl will trigger an update on Amazon for connected listings.

A full inventory sync can be triggered to Amazon by deactivating and reactivating inventory sync from within the Amazon marketplace settings in Brightpearl.

A listing can be connected to a bundle.

Create the product & then connect

Products can be created from your listings, however, you may prefer to create all your products within Brightpearl and then connect them. Products can be added in Brightpearl one at a time or by importing them from a spreadsheet.

List on Amazon then connect 

It is not possible to publish Amazon listings from Brightpearl. You will need to create your Amazon listings directly within your Amazon account.

See above for connecting a product to a listing.

Once your listings are connected to a product in Brightpearl, Brightpearl will begin to manage the price and quantity available on the listing in Amazon. And when an order is downloaded the product will be added and allocated onto the order.

What happens if a listing is not connected to a product?

If a listing is not connected to a product then Brightpearl will not manage the quantity or price on Amazon; it will be managed by Amazon. If an order is received for the item the order will still download, but the product won't be added or allocated; the line item will be a free-text / non-stock tracked item. You will therefore not have anything to ship in Brightpearl; you will need to manually update the status of the order in Amazon.

It is possible to edit the order in Brightpearl in order to add and allocate the product to fix the issue, but make sure you connect your product to the listing for next time.

How to auto-connect Amazon listings to Brightpearl products

As long as both your Amazon listing an Brightpearl product have the same SKU, and that is unique across your product range, they can be automatically connected. If the product exists at the point the listing is first downloaded into Brightpearl this connection will happen on its own. Otherwise you can use the Auto-connect by SKU button from  Channels > Amazon > Live Amazon listings

connect listing auto connect

Have more questions? Submit a request