Shopify orders

New orders placed through Shopify will be created in Brightpearl. The order download can be activated and deactivated at any time from within Shopify. 

Order download triggers

Brightpearl’s Shopify integration attempts to download orders on the following schedule:

  • Real time
    When an "Order Created" webhook is received from Shopify, Brightpearl attempts to download the new order.
  • Hourly reconciliation
    A reconciliation is performed every hour, where Brightpearl checks for any orders placed in Shopify which have not yet downloaded.
  • Nightly reconciliation
    An additional nightly reconciliation is run (at 3am Brightpearl server time) to see if any orders were missed in the last 24 hours.
  • Manual
    A manual order download can be triggered for a single order from the Brightpearl Shopify app.

Delay order creation

Ordinarily, orders are captured from Shopify immediately once they're placed. However, on occasion there may be reasons to want to delay the order download, e.g. to give a third party application the opportunity to perform a fraud check.

To mitigate any issues, the integration provides an option to delay the order creation:

Choose between no delay, a 2 minute delay and a 5 minute delay.

Single order download

If for any reason an order fails to download, an order download can be forced via single order import:


In the Shopify order ID field, enter the Shopify internal ID and click "Import order".

The Shopify internal ID can be found in the URL of the Shopify order. For example, if your order URL is, then the Shopify order ID is 123456789.

You can also force an order update from the Orders list. Select the orders you wish to import and click More actions > Import selected orders:


New order status

New orders will be created with the order status chosen in the Orders configuration tab.

New and existing customers

If a new email address is found on the order, a customer will be created in Brightpearl, regardless of whether they chose “guest” or “account” during checkout.

Email address 2 and email address 3 in Brightpearl are not checked when searching for existing customers to assign the order to.

An order from a repeat customer will be added to their existing account. By default, the customer’s contact record will be updated with the most recent information from that order.


Brightpearl has 3 address fields on an order:

  • Primary
  • Invoice
  • Delivery

Primary address is mapped to the delivery address.

You can also choose a contact email for an anonymous customer for orders in the Orders configuration tab.

SKUs and product description

On order download, Brightpearl attempts to match a product’s SKU in Shopify to a SKU in Brightpearl. If a match is found, that product is added to the order in Brightpearl. If it cannot be found, the product will be added as a miscellaneous line item. It is recommended to add the missing product in Brightpearl, delete the sales order in Brightpearl and then re-download using Single Order Import. This ensures that the fulfillments post correctly to Shopify. 


When an order for the item is downloaded, Brightpearl will use the bundle item and add on all the separate components. The inventory will be automatically allocated to reserve the bundle for the order.

Price, tax, and order total

Brightpearl will always respect the item price and tax collected on Shopify. In rare cases, a reconciliation line may be required to ensure the order total matches Shopify.

The price list on new orders can be selected in the Orders tab in the app.

Tax code

The tax code assigned to an order row will be selected based on the Brightpearl tax rules.

Learn more about the VAT tax rules here, and the sales tax rules here.

Shopify multi-currency

Read about multi-currency support here

Inventory allocation

When an order is downloaded, any inventory in the allocation warehouse assigned to the order will be allocated to the order. There may have been more inventory visible on Shopify (from other warehouses), but this will not be automatically allocated.

Brightpearl automation rules can be used to create goods out notes for any warehouse, so it worth considering setting up a rule to reduce the risk of double selling inventory in warehouses other than the default allocation warehouse.

Discounts, coupons, and promotions

All discounts, excluding shipping, will be spread across products using a weighted average based on price. A discount line will appear, but will be zero value and only describe the discount or list the coupon code used.

The following table describes how the discount appears on a sales order.

It is applicable to both Shopify and Shopify Plus accounts.

    Order level discounts (%) Item level discounts (%)
Discount line Displayed as Additional line Additional line
Details Discount or coupon description Discount or coupon description
Account code Sales discounts Sales discounts
List price and price

List price: 0

Price: 0

List price: 0

Price: 0

Item line List price and price

List price: original

Price: discounted

List price: original

Price: discounted

Shipping discounts will only discount the shipping line item as opposed to all products.

Shipping method

Shipping methods must be defined within Shopify to be used on sales. Shipping charges will download as additional line items.

If a shipping method of the exact same name exists in Brightpearl, it will be assigned to the order in the “Shipping Method” field. If the name cannot be matched, the default shipping method selected in the Orders tab will be used. This allows sales to be filtered by the shipping method to prioritize and batch fulfill orders. The goods out note will inherit the order shipping method unless specified otherwise.

Custom items

The integration supports customizable products. Any Shopify custom item will be added to the order in Brightpearl. 


Cart attribute mapping

Shopify allows you to create cart attributes, which are custom fields used for collecting additional information from customers when they check out - for example, gift messages.

To bring those additional details into Brightpearl, the Shopify cart attribute can be mapped to a Brightpearl sales order custom field.

If the attribute isn't mapped it will get captured in the Brightpearl order notes.

Read more about cart attribute mapping with Shopify here.


Enter the Shopify attribute field name and specify which Brightpearl custom field to use to capture the information.

Have more questions? Submit a request