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:
- Install the Amazon app in your Brightpearl account.
- Regsiter with Amazon MWS and get your account identifiers which will give Brightpearl permission to talk to your Amazon account.
- Add each Amazon marketplace as a channel in Brightpearl with your chosen synchronization options.
How to install the Amazon app
- In Brightpearl, go to App Store > Amazon .
- 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.
How to register with Amazon MWS
- Visit the Amazon MWS website.
- If you have a UK Amazon Seller Account go to https://developer.amazonservices.co.uk/
- If you have a US Amazon Seller Account go to https://developer.amazonservices.com/
- Sign up using your Amazon seller central details and using the Brightpearl developer details provided here:
- Developer name: Brightpearl
- Developer account number for European sellers: 8977-7545-2683
- Developer account number for US sellers: 3260-3202-8765
- Make a note of your Seller ID and MWS Authorization Token , you will need to put these into Brightpearl.
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.
- Go to App store > Amazon > Turn on Amazon or Setup if it is already installed.
- Click the Connect Amazon marketplace button.
- Select the Amazon marketplace you are adding.
- 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).
- Give this marketplace a name, this is how you’ll see it displayed throughout Brightpearl.
- In the Sync prices section, make the following selections:
- 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.
- 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.
- 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.
- Bulk inventory update - You can run bulk inventory update manually up to 3 times a day. Brightpearl will also perform nightly bulk inventory update.
- 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.
- 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:|
Manually search & connect
Create a product from the listing
Create the product & then connect
List on Amazon then connect
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