Brightpearl > Shopify - sync locations

This is draft documentation - please check back later for final content.

Introduction

The Brightpearl > Shopify - sync locations flow retrieves all warehouses from Brightpearl and then all locations from Shopify. A script determines if a warehouse (i.e. location) exists in Shopify - if no, a new location is created and if yes, the existing location is updated.

This blueprint includes two process flows to handle the sync of locations between Brightpearl and Shopify: Brightpearl > Shopify (detailed here) and Shopify > Brightpearl. You only need to run ONE, depending on which way you want the sync to work.

Process flow snapshot

Click to view process flow snapshot

Limitations

Limitation	Summary
All warehouses/locations are synced	There is no option to limit which warehouses/locations are synced.

Assumptions

Assumption	Summary
Brightpearl data	It is assumed that data in Brightpearl is correct and up to date at the time this process flow is run.

Customisation

To ensure that this process flow runs as required, some customisation options are available. These are documented in the following sections:

• Flow variables

• Process shape shapes

Flow variables

This process flow does not use flow variables.

Process flow shapes

This process flow includes some shapes that can be configured with your own settings. Please see guidelines in the table below.

Shape settings determine the outcome of process flows. Do not change shape settings unless they are listed below.

Shape	Notes
Trigger	The default schedule is set to hourly. You can change the schedule if needed.
Connector (Brightpearl)	If you did not add or select a Brightpearl instance during the blueprint installation process, the following settings must be configured: Source instance : Set to your required Brightpearl instance. Source endpoint : Set to GET Get all warehouses
Connector (Shopify)	If you did not add or select a Shopify instance during the blueprint installation process, the following settings must be configured: Source instance : Set to your required Shopify instance. Source endpoint : Set to POST Get all locations via graphql
Script	The BP to Shopify - Determine new and updated locations script can be updated if additional location details are required.
Branch	Two branches are defined - new location creates new locations and update location updates existing locations. If you do not wish to update locations, this branch can be removed.
Connector (Shopify) branch: new location	If you did not add or select a Shopify instance during the blueprint installation process, the following settings must be configured: Source instance : Set to your required Shopify instance. Source endpoint : Set to POST Add locations via graphql
Connector (Shopify) branch: update location	If you did not add or select a Shopify instance during the blueprint installation process, the following settings must be configured: Source instance : Set to your required Shopify instance. Source endpoint : Set to POST Update locations via graphql

Reference

Reference information for this process flow is documented in the following sections:

• Scripts used in this process flow

• Cross-reference lookups used in this process flow

Scripts in this process flow

Script	Summary
BP to Shopify - Determine new and updated locations	Compares Brightpearl warehouses with Shopify locations, then creates or updates Shopify locations as needed.

Cross-reference lookups in this process flow

This process flow does not use cross-reference lookups.