> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.accounteditor.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Brightpearl Integration — Shopify Order Editing Sync (Account Editor)

### Purpose

**Help merchants using Brightpearl understand why post-purchase edits sometimes don’t sync — and exactly how to configure Brightpearl so Account Editor order edits are respected end-to-end.**

**This article directly prevents:**

* **Wrong items being shipped**
* **Address changes being ignored**
* **“Account Editor didn’t work” support tickets**

### ⭐ Why This Matters

**Brightpearl is a pull-based OMS.**
**It imports orders from Shopify, then manages fulfillment downstream.**
**If Brightpearl is not configured to accept Shopify order edits:**

* **Product swaps won’t sync**
* **Quantity changes won’t apply**
* **Added or removed items won’t appear**
* **Fulfillment teams will ship the original order, not the edited one**

**👉 Account Editor did its job — Brightpearl simply ignored the updates.**

**This is the #1 Brightpearl-related cause of incorrect fulfillment after order editing.**

## **⚙️ How Account Editor + Brightpearl Work Together**
**Account Editor**
* **Edits the existing Shopify order**
* **Updates line items, quantities, variants, address, totals**
* **Logs changes in the Shopify order timeline**

**Brightpearl**
* **Pulls order data from Shopify**
* **Applies its own internal rules**
* **Requires explicit permission to accept edits**

**➡️ If Brightpearl’s *“Enable order edits”* setting is OFF, all Shopify edits are silently discarded.**

## **🚨 Symptoms of Incorrect Brightpearl Configuration**
**If you see any of these, this article applies to you:**

* **❌ Shopify shows updated items, Brightpearl does not**
* **❌ Fulfillment picked the wrong SKU**
* **❌ Variant swaps missing in Brightpearl**
* **❌ Quantity changes ignored**
* **❌ Order edits appear correct in Shopify Admin only**

**These are not bugs — they are configuration issues.**

## **🪜 Required Setup — Enable Order Edits in Brightpearl**
### **✅ Step-by-Step Configuration**

1. **Log in to Brightpearl**
2. **Go to Settings**
3. **Open the Orders tab**
4. **Enable (tick): “Allow order edits” / “Enable order edits”**
5. **Click Save**

![Brightpearl Orders Settings showing “Enable order edits” checked](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/image_i7s9f2.png)


## **🔄 What Happens After Enabling This Setting**
**Once enabled, all Account Editor changes sync correctly, including:**

* **✅ Product variant swaps**
* **✅ Quantity increases / decreases**
* **✅ Item additions or removals**
* **✅ Address updates**
* **✅ Order total changes**

**Brightpearl will now:**
* **Re-read the Shopify order**
* **Import the final, edited version**
* **Keep fulfillment aligned with customer changes**

## **🧪 Verification Checklist (Highly Recommended)**
**After setup, perform this quick test:**

1. **Place a test order in Shopify**
2. **Edit the order using Account Editor:**
3. **Swap a variant or change quantity**
4. **Open the order in Shopify Admin**
5. **Confirm edits are visible**
6. **Open the same order in Brightpearl**
7. **Confirm edits match Shopify**

**✅ If both match → setup is complete**
**❌ If not → proceed to troubleshooting below**

## **⚠️ Common Issues & Fixes**
| **Issue** | **Likely Cause** | **Fix** |
| ---- |
| **Brightpearl shows old items** | **Order edits disabled** | **Enable “order edits”** |
| **Some edits sync, others don’t** | **Order imported too early** | **Delay import (see Flow guide)** |
| **Fulfillment already started** | **Order pulled before edit window ended** | **Hold order before sync** |
| **Quantities mismatch** | **Manual override in Brightpearl** | **Refresh order / resync** |

## **🧠 Best Practices (Strongly Recommended)**

* **⏱️ Delay Brightpearl order import until the edit window ends**
* **🔁 Pair this setup with Shopify Flow holds**
* **🧪 Always test edits before going live**
* **📊 Use Analytics to confirm edits occurred before fulfillment**

**👉 Brightpearl *should never see an order while it’s still editable.***

## **🔗 Related Guides**

[**→ 3PL & OMS Integrations Overview**](https://help.accounteditor.com/en/article/3pl-oms-integrations-with-account-editor-overview-109htqb/)
[**→ Automation & Shopify Flow (Hold Orders Before Sync)**](https://help.accounteditor.com/en/article/automation-use-cases-with-account-editor-shopify-flow-1tzi5b1/)
[**→ Editing Eligibility & Restrictions**](https://help.accounteditor.com/en/article/editing-eligibility-restrictions-subscriptions-bundles-product-types-1bis0nl/)
[**→ Integration Troubleshooting (Edits Not Applying)**](https://help.accounteditor.com/en/article/integration-troubleshooting-why-order-edits-dont-apply-account-editor-gb1pfk/)

## **🆘 Need Help?**
**If edits still don’t sync after enabling this setting:**

**Contact Account Editor Support**
**Share:**
** Store URL**
** Order number**
** Screenshot of Brightpearl Orders settings**

**We’ll help confirm whether the issue is:**
* **Timing**
* **Flow logic**
* **Brightpearl override behavior**

### **✅ Summary**
**Account Editor edits Shopify orders correctly**
**Brightpearl must allow order edits**
**One checkbox prevents most fulfillment mistakes**
**Proper setup = fewer returns, fewer tickets, happier customers**