Shopify & Brightpearl

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

Introduction

The Patchworks Shopify and Brightpearl blueprint enables the synchronisation of B2B data between the two systems. Entity types and sync directions are summarised below.

Flow Type	Purpose		Direction
Companies, contacts, payment terms	Create and update company, contacts and payment terms.	Brightpearl	↔	Shopify
Catalog & pricing	Create and update catalog and pricing details.	Brightpearl	→	Shopify
Sales orders	Create orders	Shopify	→	Brightpearl
Fulfillments	Create fulfillments	Shopify	→	Brightpearl
Locations	Create and update locations	Brightpearl	↔	Shopify
Inventory	Update inventory	Brightpearl	↔	Shopify
Products	Create and update products	Shopify	→	Brightpearl
Refunds	Update order refunds	Shopify	→	Brightpearl

For detailed information, please refer to the Available process flows section.

How it Works

Each flow is powered by the Patchworks API-first integration platform, where:

• The standard Brightpearl REST API drives data extraction from Brightpearl.

• The Shopify B2B GraphQL API drives data extraction from Shopify.

• Patchworks custom scripts handle data comparisons, mapping, deduplication, and transformation.

• Fully customisable cross-reference lookups allow automatic data conversions for your specific business rules.

Out of the box, the Patchworks Shopify and Brightpearl blueprint includes:

• 14 ready-made integration flows covering the complete product, order, payment and fulfilment cycle.

• Reusable scripts for location mapping, product handling, price injection, etc.

• Configurable flow variables (lookbacks, tracked stock, price levels, etc.) to tailor behaviour.

Key benefits

• Faster time-to-value. Pre-configured, tested flows deploy in days, not months.

• Fully customisable. Extend or modify mappings, variables, and filters to suit your business logic.

• Low maintenance. Built on the Patchworks platform with built in retries, error handling, and monitoring.

Available process flows

For detailed information, please refer to the Available process flows section.

Assumptions

• Brightpearl & Shopify knowledge. This blueprint provides base functionality/logic to sync data between Brightpearl & Shopify. It's important to review flow configuration in the context of your own system setup. Guidelines are provided in the Available process flows section section of this documentation.

• Patchworks knowledge. Process flows included with this blueprint include advanced functionality such as custom scripting, GraphQL queries, and mapping transform functions. It is assumed that you have a good working knowledge of these features.

Installation

For installation instructions, please refer to our Installation guide.