Troubleshooting (Shopify)

The ecommerce channel alerts report helps you see when processes performed as part of your integrations have or haven't completed successfully. When errors occur you will see an alert next to the Channels menu and the relevant sales channel, click on the number to view the alerts report.

shopify troubleeshooting

To keep your report tidy you can mark messages as read, or delete them (200 at a time).

Order won’t download

  1. Check that the email address is not a staff member in Brightpearl. If it is, you’ll need to add the order to Brightpearl manually
  2. Check that the email address is valid (e.g. .con has been used instead of .com). If it isn't, then try changing it on Shopify and try a manual download to Brightpearl. If this isn't possible, then you'll need to add the order to Brightpearl manually
  3. Check that the country is in Brightpearl (they are not added automatically). Once you’ve added the country, you’ll need to add the order manually
  4. Is the Shopify order reference already in Brightpearl? If it is, then we won't be able to download the new order; and you will need to add the order manually. Try prefixing your orders for different channels (e.g. #1, B2B, B2C) to prevent this from being an issue
  5. Is the order missing address lines in Shopify? In order for the customer and sale to download, the order must contain a first or last name, email address and first line of their address
  6. If you still have trouble, please contact Brightpearl support

Payment hasn't downloaded

  1. If the payment has not been completed by the time the order has downloaded to Brightpearl, then the payment won't be downloaded. We do not retrospectively check for payments so you will need to allocate the payment manually
  2. If you do not believe this is the cause of the payment not downloading, then please contact Brightpearl support

Product not in Brightpearl

  1. Check that it has a SKU in your Shopify store - items need a SKU in order to be downloaded automatically. Please ensure that the SKU has less than 32 characters in Shopify
  2. If you’ve added it to your Shopify store since the initial setup download, then it won’t be imported into Brightpearl unless it’s purchased, or you click “download products” in the connector setup screens (this is not available during beta)

Inventory not updating on Shopify

  1. Check that the SKUs match in both systems and that they are unique
  2. Inventory will only update if there has been an inventory change (ie purchased / sold stock, manual inventory change)
  3. If you still have trouble, please contact Brightpearl support

Orders downloading without tax

  1. Check that the products in your Shopify account are set as taxable
  2. If you still have trouble, please contact Brightpearl support
Have more questions? Submit a request


Please sign in to leave a comment.