ReturnMate logoReturnMate

Brightpearl + ReturnMate

BetaThis integration is production-deployed and merchant-usable today. We're still expanding feature coverage and may iterate on behaviour as we learn from real usage. No service interruptions are expected.

ReturnMate mirrors Brightpearl products, suppliers, customers, orders and warehouses, and posts the return paperwork back: stock corrections as units are received or written off, sales credits when refunds are issued, and purchase credits when the warranty cost belongs to the supplier.

§ 01 — Capabilities

What the Brightpearl connection actually does.

  • Mirrors products, suppliers, customers, sales orders, purchase orders and warehouses
  • Posts return receipts and write-offs as warehouse stock corrections
  • Posts sales credits when refunds are issued
  • Posts purchase credits for supplier-responsible warranty cost — the supplier-recovery channel
  • Delta sync on a cursor — only changed records move after the first mirror
  • Warehouse mapping with per-document posting toggles
§ 02 — In practice

Where it earns its place.

Refund on the RMA, sales credit in Brightpearl

The refund event posts a sales credit through the Brightpearl order service — the customer-side paperwork exists the moment the money moves.

Supplier faults become purchase credits

A technician-confirmed fault attributed to a supplier posts a purchase credit — Brightpearl carries the recovery document, ReturnMate carries the evidence.

Stock corrections from dispositions

Restocks and write-offs post as stock corrections against the mapped warehouse, with first-posted-wins dedupe so a changed decision never double-counts units.

§ 03 — Setup

Connect Brightpearl.

  1. Connect with your API credentials

    Settings → Integrations → ERP → Brightpearl. Credentials are stored encrypted per shop; a connection test probes the warehouse list to confirm access.

  2. Map warehouses and set posting toggles

    Map Brightpearl warehouses to ReturnMate locations, choose a default, and enable the document types you want posted.

  3. Run the first mirror

    The initial sync pages through your records in resumable batches; delta sync keeps the mirror current afterwards.

§ FAQ

Questions about Brightpearl.

Which plans include the Brightpearl integration?

ERP integration is available on the Scale and Enterprise plans.

Are Brightpearl goods-in notes and stock levels synced?

Not yet — both are on the adapter roadmap (each is a per-order or per-product API in Brightpearl, so they need their own paging strategy). Products, suppliers, customers, orders, POs and warehouses mirror today.

What happens if a document type is not supported?

The posting pipeline is capability-aware: unsupported document types are skipped and recorded against the RMA rather than failed, so the return keeps moving and nothing silently errors.

§ Enquire

Ask about the Brightpearl integration.

Tell us how you ship with Brightpearl

Volumes, lanes, whether you already have an account — we'll come back within one business day.

Wire your stack together.

Start free — 5 returns a month on the Free plan, no credit card required. Billed through Shopify.