# 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](/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl.md) 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](/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl.md).

## 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](/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/available-process-flows-shopify-and-brightpearl.md) 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](/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl/installation-guide-shopify-and-brightpearl.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-brightpearl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.