Shopify > Brightpearl - sync locations

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

Introduction

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

This blueprint includes two process flows to handle the sync of locations between Shopify and Brightpearl: Shopify > Brightpearl (detailed here) and Brightpearl > Shopify. 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 locations/warehouses are synced	There is no option to limit which locations/warehouses are synced.

Assumptions

Assumption	Summary
Shopify data	It is assumed that data in Shopify 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 (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
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 Updated at : Set to {{flow.variables.updatedat}} Updated at references a flow variable value, defined in process flow settings.
Script	The Shopify to BP - Determine new and updated locations script can be updated if additional location details are required.
Branch	Two branches are defined - one creates new locations and the other updates existing locations. If you do not wish to update locations, this branch can be removed.
Connector (Brightpearl) Branch: New location	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 POST Create new locations
Connector (Brightpearl) Branch: New location	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 POST Create new warehouses
Connector (Brightpearl) Branch: Update location	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 POST Update warehouse addresses
Connector (Brightpearl) Branch: Update location	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 POST Update warehouse addresses

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.