# Shopify & Brightpearl

## 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.

<table><thead><tr><th width="166.40625">Flow Type</th><th width="208.10546875">Purpose</th><th width="129.5234375"></th><th width="111.609375" align="center">Direction</th><th></th></tr></thead><tbody><tr><td>Companies, contacts, payment terms</td><td>Create and update company, contacts and payment terms.</td><td>Brightpearl</td><td align="center"><strong>↔</strong></td><td>Shopify</td></tr><tr><td>Catalog &#x26; pricing</td><td>Create and update catalog and pricing details. </td><td>Brightpearl</td><td align="center"><strong>→</strong></td><td>Shopify</td></tr><tr><td>Sales orders</td><td>Create orders</td><td>Shopify</td><td align="center"><strong>→</strong></td><td>Brightpearl</td></tr><tr><td>Fulfillments</td><td>Create fulfillments</td><td>Shopify</td><td align="center"><strong>→</strong></td><td>Brightpearl</td></tr><tr><td>Locations</td><td>Create and update locations</td><td>Brightpearl</td><td align="center"><strong>↔</strong></td><td>Shopify</td></tr><tr><td>Inventory</td><td>Update inventory</td><td>Brightpearl</td><td align="center"><strong>↔</strong></td><td>Shopify</td></tr><tr><td>Products</td><td>Create and update products</td><td>Shopify</td><td align="center"><strong>→</strong></td><td>Brightpearl</td></tr><tr><td>Refunds</td><td>Update order refunds</td><td>Shopify</td><td align="center"><strong>→</strong></td><td>Brightpearl</td></tr></tbody></table>

{% hint style="info" %}
For detailed information, please refer to the [Available process flows](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl) section.
{% endhint %}

## Overview

{% embed url="<https://www.loom.com/share/f9a6f623350e4bf5802b8cef25ec4641>" %}

## How it Works&#x20;

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](https://shopify.dev/docs/api/admin-graphql/latest/queries/companies) drives data extraction from Shopify. &#x20;
* Patchworks custom scripts handle data comparisons, mapping, deduplication, and transformation.
* Fully customisable cross-reference lookups enable 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](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl).

## 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](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl) section of this documentation.
* **Patchworks knowledge.** Process flows included with this blueprint offer 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](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/installation-guide-shopify-and-brightpearl).