Install and configure the Amazon app

Connecting Amazon to Brightpearl involves the following steps:

  1. Authorizing Brightpearl as a developer and making a note of your account details
  2. Turning on the Amazon app in Brightpearl's app store
  3. Adding and configuring each separate Amazon marketplace as a a channel in Brightpearl
    • You will need one channel per marketplace per seller account
  4. Configuring carriers on the relevant shipping methods to comply with Amazon's valid tracking rate (VTR) metrics
  5. Making sure your Amazon listings are connected to the relevant products in Brightpearl

This guide will go through each step in detail to help you connect Brightpearl and Amazon.

Authorizing Brightpearl as a developer

Brightpearl must be authorized as a developer in order to allow the system to push data to and retrieve data from Amazon.

To authorize Brightpearl as a developer:

  1. Log in to your Seller Central account, then click on Apps & Services > Manage your apps > Authorize new Developer.


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

      Then click Next on the Authorize new developer screen.

    • Your merchant token can be found in Seller Central, under Settings > Business Information > Merchant Token.

Installing the Amazon app in Brightpearl

  1. In Brightpearl, go to App Store > Amazon.
  2. Click Turn on beneath the Amazon integration. You'll be taken straight to the setup screen to add your first marketplace.

    turn o amazon app

How to add and configure an Amazon marketplace

Each Amazon marketplace is added as a separate channel 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, but each one of these will have to be added into Brightpearl as a separate channel.

Warning: Don't add duplicate marketplaces as active channels, as this will result in duplicate orders downloading and duplicate information syncing to Amazon.

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. Log out of Brightpearl and log back in, to prevent your session timing out while doing the authorization.
  2. Go to App Store on the top right-hand side of the page and click Turn on next to the Amazon app. You'll be taken to an Amazon settings page.
  3. Click Connect Amazon marketplaces on the top right hand side of the page.
  4. Fill in the mandatory fields:
    • "What do you want to call this marketplace in Brightpearl" - this will be the channel name. You’ll see it displayed throughout Brightpearl.
    • "Price list" - see below. It must be selected, even if you're not syncing prices.
  5. Click "Authorize" below your Amazon seller ID

    Note: You can only click the "Authorize" button if the mandatory fields on the configuration page are filled in.

  6. You will be taken to a page prompting you to log in to Amazon. Log in using your Seller Central details.
    Note that if you are already logged in to Seller Central, you will be taken directly to Step 7. Ensure you are logged in to the correct store.
  7. Select the Amazon merchant account and marketplace relevant to the Amazon channel you selected in the first step.
    Warning: Make sure it's the right marketplace and that you're logged into the correct seller account! If you don't, you will need to reauthorize immediately using the correct details.
  8. You will be taken to a page listing the services Brightpearl needs to access. Check the box confirming you are happy to allow Brightpearl access and click "Confirm" on the bottom right-hand side of the page.
  9. You will be taken back to the Amazon channel settings page in Brightpearl, completing the authorization. You should now see your Amazon Seller ID in your settings page lists the Amazon region and "MWS/SP-API".
  10. Check the "Show in channel menu" box to display the channel in the Channels list.

Sync prices

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 checkbox Check this box to activate pricing updates from Amazon.

Price list

(mandatory field)

Select the price list to use for listing updates.

It must be in the same currency as your marketplace.

Sync inventory


In the Sync inventory section, make the following selections:

Sync inventory checkbox

Check this box to activate inventory updates from Brightpearl.

If inventory syncing is activated, the on hand quantity in Brightpearl will be sent to Amazon at the point that the listing is first connected, and then whenever there's a change to the on hand inventory levels.

Warehouse for allocating merchant fulfilled (FBM) orders

(mandatory field)

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 different warehouses).

Warehouse for allocating fulfilled by Amazon (FBA) orders

Select the Brightpearl warehouse to be assigned to FBA orders.

You will need a separate warehouse for managing FBA stock. You can set an FBA warehouse per channel.

Warning: If you don't have multi-warehousing enabled, FBA orders cannot be automatically fulfilled and shipped and cannot be assigned a separate order status. Enable multi-warehousing and create a separate warehouse for FBA orders to make full use of the FBA functionality.

Warehouse for calculating on hand inventory levels for merchant fulfilled listings

(mandatory field)

Select one or more warehouses where the combined on hand inventory levels will be sent to Amazon.

Note that Amazon will automatically include FBA stock on your listings so you do not need to select your FBA warehouse.

There are further settings to manage fulfillment latency.


Default handling days

Choose between:

  • Amazon default
  • Any number between 1 and 30


Allow listing level handling days

Check this box to allow handling days to be controlled on a per listing level.

Custom field to specify handling days on a product

Select the product custom field in which the product's listing handling days is recorded.

The default handling days will 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.


A bulk inventory update can be run manually up to three times a day.

This is in addition to the nightly bulk inventory update which runs automatically.

Sync orders

Warning: If you see a warning message about shipping methods, it will be because no shipping methods have been created in your Brightpearl account. Amazon requires 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.

In the Sync orders section, make the following selections:


Start orders downloading from

(mandatory field)

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's not possible to download old Amazon orders, so this date can only be set to today's date or a future date.

Note that this date is shared across all all channels with the same Seller ID - ensure it's set to be the same for all marketplaces within the same region.

Status for new Prime orders

Select the status to use for new Amazon Prime orders.

Leave it blank to use the same status as non Prime orders.


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.

Channel branding

(mandatory field)

Select which company details to use on templates for orders downloaded from this channel.


Custom field to capture gift message

If a gift message is used on an order, it can be captured with a custom field.

Create a textarea sales order custom field and select it here.

Custom field to specify seller fulfilled Prime orders

Seller fulfilled Prime orders can be permanently flagged using a Yes/No custom field, allowing you to filter for the orders and process them first.

Create a Yes/No sales order custom field and select it here.

Send shipment updates for

Choose from:

  • All orders
  • Non Prime orders only
  • No orders

If you are using a shipping manager to handle shipping for Prime orders, select the second option.

Custom field to specify business orders

Amazon Business orders can be permanently flagged using a Yes/No custom field.

Create a Yes/No sales order custom field and select it here.

Custom field to specify purchase order number

If using Amazon Business, the purchase order number can be captured in a custom field on the order in Brightpearl.

Create a freetext sales order custom field and select it here.

There are two additional options if using fulfilled by Amazon (FBA) orders. Note these only appear if a separate warehouse is selected for use with FBA orders.



Status for new fulfillment by Amazon (FBA) orders

Select the order status to use for new FBA orders.

It can be the same status as your merchant fulfilled orders, or a different one entirely.

Automatically mark FBA goods out notes as shipped?

Choose between:

  • Yes, create a goods out note and ship the order
  • No, create a goods out note but do not ship

If you opt for FBA orders to be automatically marked as shipped you won't have to do it manually.

However, you may prefer to wait for confirmation from Amazon before you manually mark them as shipped.

In this case, opt out to create a goods out note that isn't automatically shipped, but make sure goods out notes for FBA orders get filtered out from the rest of your goods out notes during picking and packing.

The following options relate to downloading Amazon pending orders:


Download pending orders

Check this box to download pending orders from Amazon.

Learn more about pending orders here.

Status for new pending orders

Select the status to use for new Amazon pending orders, to indicate they shouldn't be processed.

Pending order contact ID

Set the contact ID for the pending contact.

Once the order is moved out of a pending state, the contact will update to match the actual Amazon customer.

The following options relate to payments and fees:



Payment method

(mandatory field)

Select the payment method to be used to mark the Amazon orders as paid.

Capture Amazon other fees

Enable this feature to download Amazon fees which are not directly related to orders.

Use download date for payments

Check this box to use the date the settlement report is issued for the payment and fees accounting rather than the created date of the order.

Default account code for order fees

Select the account code into which fees should be recorded for accounting purposes.

Default account code for other transactions and fees

Select the account code into which non-order-related fees should be recorded for accounting purposes by default.

Transaction type mapping

Use this section to map specific fees found in the settlement report to different account codes.

Learn more about how to fill this section in here.

Note: In order for payments to download, the settlement report must be requested from Amazon in XML format. Learn more here.

Configuring shipping methods to work with Amazon

As a form of quality control, Amazon calculates a valid tracking rate (VTR) performance metric. Thus means Amazon validates tracking IDs based on the carrier selected when merchants confirm shipments. It requires the carrier name and carrier code sent from Brightpearl to be an exact match to one in their list. Learn more about valid tracking rate metrics here.

In order to meet the requirements, it is necessary to configure your shipping methods to include a carrier.

To assign a carrier to a shipping method, go to Settings > Shipping methods and select a shipping method used for Amazon fulfillment. Click the pencil to edit the shipping method and enter the carrier name in the "Carrier" field.


Connect Amazon listings to Brightpearl products

As soon as a marketplace is added, your Amazon listings will begin to download. To view them, go to Channels > Amazon > Live Amazon listings.

You'll need to connect all of your listings to Brightpearl products to start synchronizing prices and inventory.

Connecting your listings to your products also ensures that inventory is allocated to sales orders when they download. If listings are not connected to products, the orders will still download but, the row lines will be represented by non-stock tracked miscellaneous lines.

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

Learn more about linking your Amazon listings to Brightpearl products here.

Have more questions? Submit a request