Skip to main content
Talk to an expert
Brightpearl by Sage ERP system

Brightpearl integration for ecommerce fulfilment

Orders from all channels dispatched correctly without fulfillment delays. iWeb integrates Brightpearl into your commerce estate so orders from storefronts, marketplaces, and partner channels flow into one fulfillment queue, dispatch tracking is published back to shoppers in real-time, and returns close the refund loop without manual accounting. Works with Adobe Commerce, Magento Open Source, Shopify Plus, BigCommerce and other storefronts.

Also searched as: shipping connector, warehouse integration, fulfilment plugin, app.

BrightpearliWeb integration layeryour storefront
Works with - Adobe Commerce · Magento Open Source · Shopify Plus · BigCommerce · Other storefronts
01 · What you get

What a Brightpearl integration gives you.

One fulfillment queue for all channels

Orders from your storefronts, marketplaces, and partner channels all arrive in Brightpearl in the same format. Warehouse teams see one list of picks and packs, not separate workflows per channel.

Real-time tracking published to shoppers

Once Brightpearl confirms dispatch, tracking numbers and carrier links flow automatically back to your commerce checkout and customer account so shoppers do not need to chase tracking via email.

Stock visibility that survives the sale

Stock reserved and picked in Brightpearl is reflected in real-time inventory in your ERP and storefronts. Overselling across channels is prevented because all channels read the same stock source.

Returns that close the refund loop

When a returned item arrives at the warehouse and is processed in Brightpearl, stock is restored, a refund is triggered in ERP, and the customer sees the credit in their account without manual accounting intervention.

Carrier costs and compliance managed centrally

Shipping rates, label formats, and carrier compliance rules are configured once in Brightpearl. Regional carriers or service level changes are updated in one place, not across multiple integrations.

Fulfillment exceptions are visible and actionable

When orders cannot be dispatched (out-of-stock, address issue, carrier failure), they surface in an exception queue with context so fulfillment teams can resolve them without guessing what went wrong.

02 · When it's worth it

Where a Brightpearl integration earns its place.

If two or more of these are true, the integration usually pays for itself quickly.

Routing orders from multiple channels to the right warehouse based on stock and location rules
Generating shipping labels, tracking numbers, and dispatch confirmations across carriers
Managing stock movements, stock transfers between locations, and inventory reconciliation
Handling returns, RMAs, and refund authorization tied to original orders
Publishing real-time tracking updates back to commerce storefronts and customer accounts
Capturing and resolving fulfillment exceptions (out-of-stock, carrier failures, address issues)
03 · The limits

Where off-the-shelf connectors fall short.

Vendor connectors are fine for simple cases. Here's where the real ones need more.

Channel-specific order attributes not preserved

Brightpearl's standard model may not capture channel-specific metadata (marketplace order IDs, seller SKUs, channel-mandated packing rules) without custom attribute mapping. Returns routed back to a channel may lose this context.

Limited ERP credit note automation

Brightpearl does not natively generate or route credit notes to ERP on return completion. Finance teams may need manual workflows or custom connectors to close the refund loop for accounting.

Carrier rule logic is static by default

Carrier selection, label formats, and shipping rules are configured inside Brightpearl but require manual rule updates when carrier contracts change or regional carriers are added. Dynamic carrier routing rules are not standard.

Stock allocation across locations is not intelligent

Brightpearl can route orders to warehouses, but does not optimize allocation by delivery postcode, carrier cost, or fulfillment speed without custom business logic layered on top.

Returns workflow does not auto-map to original order context

When a return is initiated from commerce, Brightpearl requires the original order reference to link items and authorize refunds. Partial returns or items ordered via different channels may need manual reconciliation.

04 · The real work

The tension in multi-channel fulfillment is not the software but ownership: when an order sits unshipped or a return lacks a refund, it is rarely because Brightpearl is broken; it is because the bridge between order entry, stock reservation, dispatch, and refund closing is assumed, not built.

05 · Where it sits

Where this integration sits in your estate.

Brightpearl holds the commercial record. The iWeb integration layer manages the rules, mappings, monitoring and exceptions. The commerce platform presents the customer-facing experience. The estate map helps agree ownership before anything is built.

No platform lock-in. We integrate Brightpearl with the commerce core you already have, or the one you are moving to.

System of record
Source / owner
Brightpearl
Order orchestration and fulfillment execution platform
  • Dispatch routing decisions and warehouse allocation
  • Picking and packing instruction generation
  • Shipping label generation and carrier integration
  • Stock reservation and movement tracking
  • Returns receipt and RMA processing
iWeb integration layer
Customer-facing commerce
Commerce platform
Adobe CommerceMagento Open SourceShopify PlusBigCommerceOther storefronts
  • Order placement and checkout
  • Customer address and delivery preference input
  • Order confirmation and status visibility
  • Return initiation
  • Tracking and despatch notification display
Connected neighbours
Integration layer
ERP (stock, GL, invoicing)
Stock levels and locations pulled into Brightpearl; dispatch and movement events flow back for reconciliation and order closing.
Integration layer
OMS or order queue
Orders from all channels are normalized and queued here before being routed into Brightpearl for allocation and dispatch.
Integration layer
Marketplace connectors
Marketplace-specific order data and return rules flow through this layer into Brightpearl and tracking flows back to marketplace.
Integration layer
Carrier and shipping provider APIs
Brightpearl requests labels, manifests, and tracking updates from carriers; tracking is captured and published downstream.
Integration layer
Accounting and finance
Dispatch confirmations and returns trigger invoice, credit note, and cash reconciliation in ERP and accounting systems.
Two-way sync where relevant
06 · Surrounding systems

Systems this integration usually sits next to.

Examples, not a closed list. iWeb is platform-agnostic on both sides: we wire this integration into whatever ecommerce platform and surrounding systems your estate already runs.

Ecommerce platforms (examples)
  • Adobe Commerce
  • Magento Open Source
  • Shopify Plus
  • BigCommerce
  • Other storefronts
Surrounding systems (examples)
  • ERP (SAP, Sage, NetSuite, Microsoft Dynamics)
  • Order Management System (OMS)
  • PIM (product data and channel content)
  • Marketplace connectors (Amazon, eBay, Etsy)
  • Carrier integrations (DHL, Royal Mail, FedEx, UPS)
  • Payment processors and accounting systems
Not sure?

Not sure if this works with your stack?

Tell us what you’re using and what needs to connect. We’ll give you a straight view on what’s possible, what might be awkward, and the safest way to approach it.

07 · Data flows

The data flows we wire.

Each flow has a direction and an owner. We agree both before a line of code is written.

Into COMMERCE & ERP
From COMMERCE & ERP
BOTH WAYS
Order and fulfillment instruction ingestion: Orders, line items, customer addresses, and fulfillment preferences flow from commerce platforms and OMS into Brightpearl
The system uses these to create picking instructions, generate labels, and sequence dispatch.
Tracking and dispatch confirmation: Once orders are packed and shipped, Brightpearl publishes tracking numbers, carrier references, estimated delivery dates, and despatch confirmations back to commerce platforms and customer accounts.
Stock movement and dispatch events: Stock reservations, picking confirmations, and dispatch events flow from Brightpearl to your ERP so that financial records, inventory reports, and fulfilment KPIs stay synchronized with warehouse reality.
Returns, RMAs and stock restoration: Return authorizations flow from commerce into Brightpearl; once returns are received and processed at the warehouse, stock is restored and credit notes or refund triggers flow back to ERP and commerce.
Stock availability and location rules: Stock levels and warehouse location hierarchies are pulled from ERP into Brightpearl to inform allocation logic, picking sequences, and fulfillment routing decisions.
Multi-channel order normalization: Orders from marketplace channels, storefronts, and partner sales channels are normalized into Brightpearl's dispatch model so all fulfillment happens from a single queue.
08 · How we build it

How iWeb configures the integration around your business.

Same method on every integration. The decisions come before the code.

  1. 01
    Design the order entry point

    We build the bridge from your commerce platforms and OMS into Brightpearl so orders, addresses, line items, and fulfillment preferences arrive normalized and complete. We define which channel orders route to which warehouse.

  2. 02
    Map returns and RMA workflows

    We connect return initiations from commerce into Brightpearl, route refund triggers to ERP, and ensure stock restoration happens in the correct warehouse location and cost centre.

  3. 03
    Integrate ERP stock and location hierarchy

    We pull stock and warehouse location data from your ERP into Brightpearl so allocation logic is always informed by true availability. We handle stock-movement confirmations flowing back to ERP.

  4. 04
    Configure carrier and label generation

    We set up label formats, carrier selection rules, and tracking number capture so Brightpearl generates compliant labels and publishes tracking data to commerce and customer accounts automatically.

  5. 05
    Build observability and exception handling

    We implement dashboards and alerting so fulfillment teams see dispatch lag, carrier failures, and unshipped orders in real-time. We design fallback queues so exceptions do not silently block dispatch.

  6. 06
    Test and validate multi-channel fulfillment

    We run orders from each of your sales channels through Brightpearl in pre-launch testing to ensure all channels are routed correctly, labels are generated for all carriers, and tracking flows back without gaps.

09 · Ownership

Who owns what.

The single most important table in any integration. One system owns each field; everything else reads it.

Data
Source / owner
Maintained by
Notes
DataDispatch instructions and fulfillment routing rules
Source / ownerBrightpearl
Maintained byFulfillment or operations team
NotesCommerce feeds orders; Brightpearl decides which warehouse and service level. Changes to routing logic (e.g., new warehouse, regional carrier) are made in Brightpearl and flow back to commerce visibility.
DataDespatch confirmation and tracking numbers
Source / ownerBrightpearl
Maintained byWarehouse or carrier integration
NotesOnce orders are packed and shipped, Brightpearl captures tracking and publishes it back to commerce and customer accounts. ERP records the dispatch event for order closing.
DataStock movements, reservations, and warehouse locations
Source / ownerBrightpearl (operational) / ERP (financial and perpetual)
Maintained byWarehouse team (Brightpearl) and finance (ERP)
NotesStock is reserved in Brightpearl at picking; movements and dispatch are confirmed back to ERP for reconciliation. ERP remains the system of record for stock cost and GL posting.
DataReturns authorizations and RMA decisions
Source / ownerCommerce / OMS initiates; Brightpearl governs warehouse processing
Maintained byReturns or customer service team
NotesReturns flow from commerce into Brightpearl where they are processed at the warehouse. Once received and assessed, refund triggers and stock restoration flow back to ERP and commerce.
DataCarrier selection and label generation rules
Source / ownerBrightpearl
Maintained byLogistics or fulfillment team
NotesCarrier rules are configured in Brightpearl (service level, zone, weight-based logic). Changes must be versioned and communicated so all orders use the current rules.
DataOrder acknowledgement and status updates
Source / ownerBrightpearl
Maintained byBrightpearl integration and ERP order processing
NotesOnce an order is allocated and ready to pick in Brightpearl, the status flows back to commerce and ERP for visibility. Customers see order confirmed, then in fulfillment, then dispatched.
10 · Experienced integrator

Built this before

iWeb has built multiple Brightpearl integrations into commerce estates where order volume, channel complexity, and warehouse geography demand reliable fulfillment orchestration. We understand how Brightpearl sits between commerce, ERP, and logistics networks, and where the common ownership and data-flow gaps arise.

We design order entry flows from multiple commerce platforms and OMS systems into Brightpearl so all channels feed one fulfillment queue without blocking or silent failures.
We build the return and RMA workflows so refunds close in ERP, stock is restored to the correct warehouse location, and credits appear in customer accounts without manual intervention.
We integrate Brightpearl with ERP stock and location hierarchies so allocation logic is always informed by true availability and dispatch events reconcile back to perpetual inventory.
We implement observability, exception queues, and fallback buffering so fulfillment teams see dispatch lag, carrier failures, and unshipped orders in real-time and can resolve them before they reach customers.
We handle multi-carrier label generation, tracking capture, and publication so customers see tracking links in their accounts and commerce order pages within minutes of dispatch.
11 · Before launch

What we test before launch.

Every one of these is rehearsed before a customer ever sees the integration.

Orders from each sales channel reach Brightpearl with complete address, SKU, and fulfillment preference data. Validate that no orders arrive incomplete or misrouted.
Out-of-stock orders are caught and held in an exception queue with context, not silently dropped. Confirm fulfillment team visibility into why each exception occurred.
Tracking numbers generated by Brightpearl reach customer accounts and commerce order pages within 15 minutes of dispatch. Check that no tracking is lost due to API timeout or retry failure.
Stock movements in Brightpearl are reflected in ERP within 1 hour so perpetual inventory and fulfillment allocation stay synchronized. Test stock depletion across channels to confirm no oversell.
Returns initiated in commerce reach Brightpearl, generate RMA numbers, and trigger refund authorization in ERP. Verify that stock is restored to the correct warehouse location.
Carrier rules (service level, weight threshold, regional carrier) are applied consistently to all orders. Test orders with different weights and postcodes to confirm correct carrier is selected.
If Brightpearl is unavailable for 10 minutes, orders queue and resume processing without data loss or race condition once Brightpearl recovers. Validate fallback resilience and observability.
12 · Failure points

Common risks and where they bite.

We name these on day one. A risk written down is a risk you can plan around.

Orders stuck in a dispatch queue because of incomplete or conflicting data

If order addresses, SKU references, or fulfillment preferences are not normalized before they reach Brightpearl, orders may fail validation and hang in a queue waiting for manual correction. This delays dispatch and frustrates customers.

Oversell across channels because stock is not synchronized

If Brightpearl is fed stock from ERP but your storefronts are reading an older snapshot, the same item can be sold twice. When the second order arrives in Brightpearl and stock is exhausted, the order cannot be fulfilled.

Tracking data lost because the carrier integration fails silently

If the carrier API breaks or times out after a label is generated, Brightpearl may have a tracking number internally but fail to publish it back to commerce. Customers see no tracking even though the parcel is in transit.

Returns flow into Brightpearl but do not close in ERP

If the RMA workflow in Brightpearl is not wired to trigger credit notes or refund payments in ERP, stock is restored but no refund is issued. Customers complain; finance sees inventory reconciliation gaps.

Fulfillment rules drift when carriers or locations change

Carrier selection rules, warehouse location hierarchies, and label formats are configured in Brightpearl but are not documented or versioned. When a carrier contract changes or a new warehouse opens, the rules are updated ad hoc and some orders may route to the wrong place.

Channel-specific order context is lost during normalization

When orders from different channels are normalized into Brightpearl's generic format, marketplace-specific metadata (seller SKUs, channel gift messages, channel-mandated packing) is dropped. Returns routed back to the channel lack this context.

14 · Questions

Common questions about Brightpearl integrations.

How do orders from different sales channels get into Brightpearl?

Each channel (storefront, marketplace, B2B portal) publishes orders to an OMS or integration queue in a normalized format. iWeb builds the bridge from that queue into Brightpearl so all orders arrive with customer address, line items, SKU references, and fulfillment preferences. Brightpearl then applies routing rules to assign the order to a warehouse.

What happens if an order cannot be fulfilled from the assigned warehouse?

If the assigned warehouse is out of stock, Brightpearl can reroute the order to an alternate warehouse or hold it in an exception queue. The exception queue alerts fulfillment teams with context (why it failed, which warehouse has stock, estimated delay). Without this visibility, orders sit silent and dispatch is delayed.

How does tracking data get back to customers and our storefronts?

Once a label is generated in Brightpearl and the order is handed to a carrier, the tracking number is captured. iWeb ensures this tracking data flows back to your commerce platform and customer accounts in real-time so customers see their tracking link without delay.

How are stock levels kept in sync between Brightpearl and our ERP?

Stock is pulled from your ERP into Brightpearl to inform allocation and picking. As orders are picked and shipped, stock movements flow back to ERP so your perpetual inventory stays accurate. Without this synchronization, ERP stock reports lag reality and overselling becomes likely.

What happens when a customer initiates a return?

Returns flow from your commerce platform or OMS into Brightpearl with the original order reference. Brightpearl generates an RMA number and receipt instructions. Once the item arrives at the warehouse and is processed, Brightpearl triggers stock restoration and a refund authorization flows to ERP and back to the customer.

How are carrier rules and label formats kept up-to-date?

Carrier selection rules (service level, zone, weight thresholds), label formats, and manifest requirements are configured in Brightpearl. When carriers change or service levels shift, the rules are updated centrally. iWeb ensures these changes are documented and tested so no orders use outdated rules.

What happens if the carrier API fails during label generation?

If the carrier API times out or rejects a request, Brightpearl typically retries automatically. However, if the failure persists, the order hangs in a dispatch queue waiting for manual intervention. iWeb builds observability so these failures surface immediately so fulfillment teams can resolve them before customers complain about missing tracking.

Can Brightpearl allocate orders to the warehouse closest to the customer?

Brightpearl supports custom routing rules based on warehouse location, service level, and inventory availability. iWeb can build business logic that routes orders to the nearest warehouse or the fastest fulfillment option. This requires mapping customer postcodes to fulfillment zones within Brightpearl's configuration.

How are returns processed if the item was sold via a marketplace?

Marketplace returns are initiated on the marketplace and flow into your OMS or commerce system, then into Brightpearl. iWeb ensures marketplace-specific return requirements (restocking fee, condition assessment) and seller SKU references are preserved so Brightpearl returns the item to the correct location and the marketplace refund is authorized correctly.

What happens to orders if Brightpearl is temporarily unavailable?

If Brightpearl is down, orders queued for dispatch cannot be allocated to a warehouse. iWeb designs fallback buffering so orders do not back up in commerce; instead, they wait in a resilient queue. Once Brightpearl recovers, orders are reprocessed and dispatch resumes without data loss.

How are fulfillment exceptions monitored and resolved?

iWeb builds dashboards and alerting so fulfillment teams see exceptions in real-time: out-of-stock orders, address validation failures, carrier rejections, and unshipped orders by age. Each exception includes context and suggested actions so teams can resolve them quickly without manual investigation.

How do we test that Brightpearl works correctly before launch?

iWeb runs test orders from each of your sales channels through Brightpearl to verify orders are routed to the correct warehouse, labels are generated for all carriers, tracking flows back to commerce, and returns are processed end-to-end. We validate that stock is reserved, dispatched, and reconciled correctly in ERP.

What data is needed in the order for Brightpearl to fulfill it successfully?

Orders must include valid customer address, line items with correct SKU references, quantity, and delivery postcode. Fulfillment preferences (express, standard, gift wrap) and any marketplace-specific metadata must also be present. iWeb validates orders before they enter Brightpearl so incomplete orders are rejected with clear feedback rather than failing silently.

How are inventory adjustments (damage, theft, cycle count) handled?

Stock adjustments are typically made in your ERP or Brightpearl depending on where the issue was discovered. iWeb ensures adjustments flow to both systems so the stock in Brightpearl and the financial records in ERP stay aligned. Without this, fulfillment allocation becomes unreliable.

Next step

Have a Brightpearl integration brief?

Send the brief, or tell us what is breaking. You will get a written response from a senior expert: the integration boundary, the realistic shape, the risks worth naming, and what it takes to support after launch.
Talk to an expertOr browse all integrations →