Skip to main content
Talk to an expert
Mirakl logo

Mirakl marketplace integration for ecommerce

Orders from sellers flow cleanly into your commerce estate. iWeb integrates Mirakl with your PIM, commerce platform, OMS and ERP so seller catalogue, pricing and stock stay synchronised, orders are captured with full audit trail, and returns close end-to-end without manual rework. Works with Adobe Commerce, Magento Open Source, Shopify Plus, BigCommerce and other storefronts.

Also searched as: marketplace connector, feed integration, channel plugin, app.

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

What a Mirakl integration gives you.

Sellers stay in sync

Your seller base sees accurate, current catalogue data, pricing and availability without manual email or spreadsheet updates. Sellers can confidently list and fulfil from your shared inventory.

Orders flow to finance

Seller orders land in your ERP with correct line-item detail, customer references, and GL codes ready for invoicing and reconciliation. No manual order re-entry or finance reconciliation gaps.

Stock stays authoritative

Your WMS or ERP remains the source of truth for stock. Mirakl and seller channels always see current availability, reducing oversell risk and return friction.

Returns close quickly

Return requests from Mirakl trigger WMS RMAs and close out with refund status visible in Mirakl. Sellers know when refunds have been processed.

Commission auditing works

Seller payouts and commissions reconcile directly to order-capture data in your ERP, enabling audit trails and dispute resolution without spreadsheet forensics.

02 · When it's worth it

Where a Mirakl integration earns its place.

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

Publish catalogue and pricing to Mirakl sellers in near-real-time
Ingest seller-fulfiled orders and track them through your ERP and WMS
Sync stock levels and availability rules across first-party and seller channels
Reconcile seller payouts and commissions against marketplace performance
Handle seller returns and refunds with visibility into your main fulfilment flow
Manage seller incentives and pricing rules without manual data entry
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.

No native seller mapping

Mirakl does not automatically align seller product hierarchies with your canonical taxonomy or attribute sets. Manual rules or middleware must resolve seller variants to your SKU model.

Order routing ambiguity

Mirakl does not determine which orders go to which fulfilment centre or seller warehouse. You must build routing rules in your OMS or order-capture layer to avoid split shipments or inventory conflicts.

No built-in ERP sync

Mirakl does not post orders directly to your ERP or push invoices back to your finance system. A middleware layer is required to map Mirakl order IDs, seller details and line items to your GL codes and nominal accounts.

Stock allocation gaps

Mirakl shows available stock but does not reserve inventory across multiple sellers or reserve channels. You must implement pre-order validation and stock-hold logic in your warehouse system to prevent double-allocation.

Seller return workflows

Mirakl does not natively integrate with WMS pick-and-return flows. Returns initiated in Mirakl must be manually matched to RMAs in your WMS, creating reconciliation risk.

04 · The real work

Seller order capture and stock synchronisation expose a tension between Mirakl's marketplace logic and your ERP's transactional skeleton; bridging the two requires clear routing rules, deduplication discipline and idempotency guardrails.

05 · Where it sits

Where this integration sits in your estate.

Mirakl 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 Mirakl with the commerce core you already have, or the one you are moving to.

System of record
Source / owner
Mirakl
Multi-seller marketplace and order orchestration platform
  • Seller onboarding and profile management
  • Seller-authored product listings and ratings
  • Commission and payout calculation
  • Marketplace order capture and status tracking
  • Seller performance metrics and reporting
iWeb integration layer
Customer-facing commerce
Commerce platform
Adobe CommerceMagento Open SourceShopify PlusBigCommerceOther storefronts
  • Canonical product data and taxonomy (sourced from PIM)
  • Stock levels and warehouse availability
  • First-party order capture and checkout
  • Customer accounts and billing address
  • Storefront experience and merchandising
Connected neighbours
Integration layer
PIM
Product attributes, families, images and descriptions flow to Mirakl so sellers list against consistent taxonomy.
Integration layer
WMS
Stock levels sync to Mirakl; seller orders and returns route to WMS for picking, packing and RMA processing.
Integration layer
ERP
Seller orders are captured as invoices; commissions and payouts are extracted for supplier settlement and finance reconciliation.
Integration layer
OMS
Orders from Mirakl and your storefront are routed, split and fulfilled; status updates flow back to both channels.
Integration layer
Data warehouse
Seller performance, marketplace trends and commission variance are extracted for BI and marketplace health monitoring.
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)
  • PIM (for catalogue syndication)
  • WMS (for order fulfilment and returns)
  • ERP (for order capture and payout settlement)
  • OMS (for order routing and multi-channel orchestration)
  • Data warehouse (for seller and marketplace analytics)
  • Payment gateway (for seller payout processing)
  • Tax engine (for seller-specific tax treatment)
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 MIRAKL
From MIRAKL
BOTH WAYS
Catalogue and pricing feed: Product attributes, descriptions, images, families and variants flow from your PIM or commerce platform into Mirakl for seller visibility
Pricing rules, customer tiers and channel-specific overrides are published to control seller list prices and promotional rates.
Stock and availability: Stock levels and warehouse availability are sent to Mirakl to inform seller stock-outs, backorder rules and reserve thresholds
Real-time or batch updates prevent oversell across seller channels.
Seller orders and shipments: Orders placed with seller fulfillment, along with seller shipment tracking and status events, flow into your OMS and ERP for order acknowledgement, invoicing and reconciliation.
Seller performance and payouts: Commission fees, seller ratings, return rates and payout summaries are extracted from Mirakl into your finance system for seller settlement and performance analytics.
Returns and refunds: Return requests initiated in Mirakl trigger RMA workflows in your WMS and ERP
Refund status and restocking confirmation flow back to Mirakl to close the return lifecycle.
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
    Catalogue syndication engine

    We build feeds that map your product taxonomy, attributes and images to Mirakl seller schemas. Channel-specific variants and pricing rules are applied during export so sellers receive complete, governance-ready data.

  2. 02
    Stock allocation and sync

    We implement intelligent stock-hold logic that reserves inventory across sellers and channels without requiring WMS customisation. Allocation rules prevent oversell while keeping seller visibility current.

  3. 03
    Order and payout capture

    We build middleware that transforms Mirakl orders into ERP invoices, captures seller payout details, and routes fulfilment instructions to your WMS. GL codes, tax treatment and customer references flow automatically.

  4. 04
    Return and refund closure

    We integrate Mirakl RMA events with your WMS and ERP returns workflows. Refund status updates loop back to Mirakl so sellers and buyers see the full return lifecycle.

  5. 05
    Observability and exception handling

    We monitor catalogue feed freshness, order capture latency, and stock sync drift. Failed orders, mismatched returns and stock conflicts trigger alerts so your team stays ahead of seller complaints.

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
DataChannel-specific listing data
Source / ownerMirakl
Maintained byMarketplace operations team
NotesSeller product listings, titles, seller descriptions and images are authored in Mirakl and may diverge from your PIM canonical data.
DataChannel pricing and commissions
Source / ownerMirakl
Maintained byPricing and marketplace operations
NotesSeller commission rules, pricing overrides and promotional caps are set in Mirakl and extracted for ERP settlement and audit.
DataChannel stock and availability
Source / ownerWMS or ERP
Maintained byInventory operations
NotesBase inventory levels are authoritative in your WMS or ERP and synced to Mirakl to inform seller availability and backorder rules.
DataOrders and seller shipments
Source / ownerMirakl (ingestion) and OMS/ERP (settlement)
Maintained byOrder operations and finance
NotesMirakl captures seller orders and shipment events; your OMS routes fulfilment and your ERP acknowledges invoices and payout obligations.
DataReturns and refunds
Source / ownerMirakl (RMA initiation) and WMS/ERP (execution)
Maintained byFulfilment and customer service
NotesReturns are initiated in Mirakl but executed in your WMS and refunded in your ERP; refund status loops back to Mirakl for buyer visibility.
DataSeller performance and payouts
Source / ownerMirakl (aggregation) and ERP (settlement)
Maintained byFinance and marketplace operations
NotesSeller metrics and commission calculations originate in Mirakl and flow to ERP for supplier invoice matching and payment.
10 · Experienced integrator

Built this before

iWeb has integrated Mirakl across multiple retail and D2C estates. We understand how marketplace order flows nest inside OMS and ERP architectures, where stock synchronisation risks emerge, and how to build observability that keeps sellers and your finance team confident.

We map seller product hierarchies and variants to your canonical PIM and push updates to Mirakl with channel-specific overrides so sellers work with clean, current taxonomy.
We design stock-hold and allocation logic that prevents oversell across first-party and seller channels without requiring custom WMS logic.
We build order-capture middleware that transforms Mirakl orders into ERP invoices with correct GL codes, tax treatment and seller references for payout settlement.
We integrate Mirakl RMA events with WMS returns workflows and post refund status back to Mirakl to close the return lifecycle end-to-end.
We implement monitoring for feed freshness, order capture lag, commission reconciliation drift and API outage fallback so your team sees marketplace health in real-time.
11 · Before launch

What we test before launch.

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

Verify that product feed exports match PIM canonical data and seller-visible titles refresh within the defined SLA.
Confirm stock-sync does not oversell: test partial inventory scenarios and verify Mirakl backorder flags are set correctly.
Test order deduplication: inject the same Mirakl order ID twice and verify only one invoice lands in the ERP.
Validate return closure: initiate an RMA in Mirakl, confirm the WMS pick-slip generates, and verify refund status loops back to Mirakl within target time.
Run commission reconciliation: compare Mirakl payout summaries to order-line totals in ERP and confirm GL codes and tax treatment are correct.
Measure Mirakl API latency and implement fallback caching; confirm checkout does not stall if Mirakl is unavailable for 30 seconds.
Monitor alert thresholds: validate that feed staleness, order capture lag and stock-sync drift all trigger notifications to the ops team.
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.

Seller inventory oversell

If stock-sync frequency lags or Mirakl caches inventory for performance, sellers may list products already sold in your main storefront. Customers receive cancellations or delays, damaging seller ratings.

Orders lost or duplicated

If order IDs are not properly deduplicated between Mirakl and your OMS, or if network failures trigger retries, the same seller order may be ingested twice, creating duplicate invoices and payout confusion.

Seller returns orphaned

Seller return requests in Mirakl may not auto-generate RMAs in your WMS if mapping is manual or brittle. Returns pile up in Mirakl unactioned while your inventory counts diverge.

Commission reconciliation drift

If payout calculations are manual or sourced from two systems (Mirakl and ERP), discrepancies arise during high-volume periods. Seller disputes cascade and payment holds increase.

Catalogue publication gaps

If seller attribute mapping is incomplete or taxonomy changes are not version-controlled, older sellers continue listing against stale attribute sets while new sellers see the updated model. Catalogue quality fragments.

Mirakl downtime breaks checkout

If your commerce platform calls Mirakl stock or pricing APIs synchronously during checkout, Mirakl unavailability stalls orders. Fallback caching or circuit-breaker logic must be in place.

14 · Questions

Common questions about Mirakl integrations.

How do we keep seller product listings in sync with our main catalogue?

iWeb builds a feed that pushes your PIM or commerce product data to Mirakl at a defined frequency (hourly, daily, or event-driven). Channel-specific attributes, images and pricing rules are applied during export so sellers always see the latest versions without manual intervention.

What happens if a product is out of stock in our warehouse but a seller has already listed it in Mirakl?

iWeb implements stock-sync logic that marks products unavailable in Mirakl as soon as warehouse levels drop. Sellers see backorder flags and can opt to hold or cancel orders. If a seller has already sold the product, your OMS captures the order as backordered and initiates a hold or cancellation workflow.

How do seller orders get into our ERP?

iWeb extracts Mirakl orders in near-real-time and transforms them into invoices within your ERP. Seller name, commission rate, order total and line-item detail are mapped to your GL structure so finance can reconcile and settle seller payouts without manual re-entry.

What happens if a seller return is initiated in Mirakl?

iWeb captures the return request and auto-generates an RMA in your WMS using the seller's order reference. Once the WMS confirms restocking, iWeb posts a refund status back to Mirakl so the seller and buyer are notified the return is complete.

How do we prevent the same order being captured twice from Mirakl?

iWeb deduplicates orders using Mirakl order IDs and maintains an idempotency log in the middleware. If a Mirakl order is re-transmitted due to a network retry, the duplicate is detected and ignored, preventing duplicate invoices.

Can we see which orders came from sellers versus our own storefront?

Yes. iWeb adds a seller reference or fulfillment-type flag to every order captured from Mirakl so you can filter, report and route seller orders separately from first-party orders in your OMS and ERP.

What if Mirakl goes down during peak trading?

iWeb implements fallback logic so that stock and pricing cached locally remain current and your storefront checkout does not stall. Orders already captured are queued and processed as soon as Mirakl recovers. Alert thresholds notify your team of sustained outages.

How do seller commissions get calculated and audited?

iWeb extracts commission rules and seller performance metrics from Mirakl, matches them against order-line detail in your ERP, and generates a payout file. Your finance team can audit commission calculations and dispute resolution sits in one system.

Can sellers use their own tax IDs or is tax treatment standardized?

iWeb captures seller tax registration and status from Mirakl and applies the correct tax treatment in your ERP invoices. Seller-specific VAT or sales-tax rules can be configured so each seller settlement is tax-accurate.

How often does catalogue data update in Mirakl?

iWeb can push updates on a schedule you define (hourly, twice daily, daily) or event-driven when your PIM detects changes. Most retailers run daily or event-triggered syncs to balance freshness and API throughput.

What happens if a seller cancels or returns a large order after we have already committed stock to fulfillment?

iWeb monitors cancellation and return events from Mirakl and posts them to your WMS and ERP in real-time so your team can reverse allocations, cancel pick tickets and credit the seller immediately. Stock counts reconcile without manual intervention.

How do we know if our Mirakl integration is healthy and up-to-date?

iWeb provides dashboards and alerts for key metrics: catalogue feed freshness, order capture latency, stock-sync drift, return closure time and commission reconciliation gaps. Thresholds trigger notifications so your team can act before buyers or sellers are impacted.

Next step

Have a Mirakl 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 →