Connecting Amazon to Brightpearl involves the following steps:
- Authorizing Brightpearl as a developer and making a note of your account details
- Turning on the Amazon app in Brightpearl's app store
- Adding and configuring each separate Amazon marketplace as a a channel in Brightpearl
- You will need one channel per marketplace per seller account
- Configuring carriers on the relevant shipping methods to comply with Amazon's valid tracking rate (VTR) metrics
- 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:
- Log in to your Seller Central account, then click on Apps & Services > Manage your apps > Authorize new Developer.
- 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.
- Make a note of your Seller ID and MWS Authorization Token - you will need to put these into Brightpearl.
- Your merchant token can be found in Seller Central, under Settings > Business Information > Merchant Token.
Installing the Amazon app in Brightpearl
- In Brightpearl, go to App Store > Amazon.
- Click Turn on beneath the Amazon integration. You'll be taken straight to the setup screen to add your first marketplace.
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.
- Before you get started you will need to have registered Brightpearl as a developer and made a note of your Amazon seller ID, merchant token and MWS authorization token.
Learn how to find these here.
- To begin the setup process, go to App store > Amazon > Setup.
- Click the Connect Amazon marketplace button.
- Select the Amazon marketplace location you are adding.
- Enter your Amazon seller ID, merchant token and MWS authorization token. If you've already connected a marketplace using the same seller account, you can reuse the details by clicking "Select existing merchant ID".
- Give this marketplace a name - this will be the channel name. You’ll see it displayed throughout Brightpearl.
- Check the "Show in channel menu" box to display the channel in the Channels list.
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.|
Select the price list to use for listing updates.
It must be in the same currency as your marketplace.
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||
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.
|Warehouse for calculating on hand inventory levels for merchant fulfilled listings||
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||
|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.
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||
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.
|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.
|Number of days to attempt to create orders for||
Set the cut off date for orders that haven't been download from Amazon due to occasional missing information.
You can choose a number from 1 to 10 days.
|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.
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||
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:
|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?||
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.
|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:
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.
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.