Skip to main content
ERPNext Decathlon Marketplace Connector — A build-to-order Frappe app that connects Decathlon Marketplace (Mirakl-based) to E — 1/1Illustrative preview

A build-to-order Frappe app that connects Decathlon Marketplace (Mirakl-based) to ERPNext

— syncing orders, offers, inventory, pricing, shipping, and settlements.

ECOSIRE scopes, builds, installs, and supports it for your sports and outdoor brand.

What is ERPNext Decathlon Marketplace Connector?

A build-to-order Frappe app that connects Decathlon Marketplace (Mirakl-based) to ERPNext — syncing orders, offers, inventory, pricing, shipping, and settlements. ECOSIRE scopes, builds, installs, and supports it for your sports and outdoor brand. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Mirakl OR11 order polling on a Frappe `scheduler_events` cron, de-duplicated by Mirakl order id and materialized as native ERPNext Sales Orders
Dedicated marketplace customer, price list, and warehouse mapping so Decathlon orders never contaminate your direct-sales pipeline
Two-way inventory sync: projected qty from ERPNext `Bin` pushed to Mirakl offer stock; acknowledged orders decrement the same source of truth
Offer and catalog publish via `OF21`, staged from `hooks.py` `doc_events` on Item and Item Price so ERPNext edits propagate without a separate console
Shipping and tracking writeback (Mirakl `ST11`/`ST12`) triggered on Delivery Note submit, including carrier code and tracking number
Marketplace order state transitions (accept, ship, receive) driven from ERPNext document workflow, not manual clicks in the seller portal
Settlement reconciliation that matches Mirakl commission, refunds, and payout feeds against ERPNext Sales Invoices and Payment Entries, flagging variances
`Decathlon Settings` single DocType for shop credentials, API base URL, warehouse list, and account mappings — no hardcoded secrets
`Decathlon Order`, `Decathlon Offer`, and `Decathlon Sync Log` DocTypes for a full, queryable audit trail of every API push and pull
`@frappe.whitelist()` methods for manual resync, single-order replay, and offer re-publish, callable from the UI or the Frappe REST API
Client scripts adding 'Resync to Decathlon' and 'Open on Decathlon' buttons on the relevant ERPNext forms
`Decathlon Manager` role profile plus DocType-level permissions to scope marketplace operations to the right users
Idempotent, retry-safe API calls with rate-limit backoff and errors surfaced into `Decathlon Sync Log` rather than swallowed
Fee and tax mapping so Mirakl operator commission lands on the correct expense account and marketplace VAT is handled per your accounting setup
Compatible with Frappe/ERPNext v15 and v16, packaged as a standard installable Frappe app on your own bench

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Sports and outdoor brands selling on Decathlon Marketplace hit the same wall: Decathlon runs on Mirakl, and ERPNext core has no concept of a Mirakl operator. So orders get re-keyed by hand from the Decathlon seller portal into ERPNext Sales Orders, stock levels drift between what ERPNext thinks you have and what the marketplace advertises, tracking numbers get pasted twice, and month-end settlement reconciliation becomes a spreadsheet exercise where Mirakl commission, refunds, and payouts never quite tie back to your ERPNext accounts. ERPNext gives you excellent inventory, pricing, and accounting primitives — Item, Warehouse, Bin, Sales Order, Delivery Note, Sales Invoice, Payment Entry — but nothing that speaks the Mirakl OR/PA/S/OF API dialect that Decathlon exposes to its sellers.

We build a proper Frappe app — installed into your own ERPNext bench, not a hosted middleman — that closes that gap. The app ships a Decathlon Settings single DocType holding your Mirakl shop credentials and API base URL, plus DocTypes such as Decathlon Offer, Decathlon Order, and Decathlon Sync Log that give you an auditable record of every push and pull. Inbound orders are polled from the Mirakl OR11 order feed on a Frappe scheduler_events cron, de-duplicated by Mirakl order id, and materialized as native ERPNext Sales Orders against a dedicated customer and price list, with marketplace fees mapped to the correct income/expense accounts. Catalog and offers flow the other way: hooks.py doc_events on Item and Item Price stage OF21 offer updates so a price or listing change in ERPNext publishes to Decathlon without a separate console.

Inventory stays honest with two-way sync. A scheduler job reads projected quantity from ERPNext Bin per configured warehouse and pushes available-to-sell offer stock to Mirakl, while acknowledged marketplace orders decrement the same source of truth — so you are not overselling gear you have already committed elsewhere. When you ship, the app writes the carrier and tracking number back to Decathlon (ST11/ST12) the moment a Delivery Note is submitted, and transitions the Mirakl order state accordingly. Settlement reconciliation pulls the Mirakl accounting/payout feeds and matches operator commission, refunds, and payouts against ERPNext Sales Invoices and Payment Entries, flagging variances instead of hiding them. Every integration point is exposed as a @frappe.whitelist() method so your team can trigger a manual resync, and a role profile (Decathlon Manager) plus DocType permissions keep marketplace operations scoped to the right users. Client scripts add resync and "view on Decathlon" actions right on the relevant forms.

Because this is build-to-order, nothing ships until we agree on scope. We start with a short scoping call, confirm your Mirakl API access, your warehouse and price-list layout, your tax and fee account mapping, and your Frappe/ERPNext version (v15 or v16). We then build against a staging copy of your data, run UAT with you, and only cut over to production on a scheduled window with a documented rollback. Typical delivery is one working week from confirmed scope, depending on how many marketplace edge cases (multi-warehouse, partial shipments, refund handling) you need on day one versus a later phase. You receive the full source, a git repository handover, technical and user documentation, a training session, and a post-go-live support window.

What you get

  • Installable Frappe app source code for your ERPNext version (v15 or v16), built to your confirmed scope
  • Installation and configuration on your environment, including `Decathlon Settings`, warehouse, price-list, and account mappings
  • Technical documentation: DocType reference, hooks and scheduler events, API method reference, and configuration guide
  • User guide plus a live training session for your marketplace operations team
  • UAT on a staging copy of your data with a documented, tested rollback plan before production cutover
  • Post-go-live support window for bug fixes and configuration adjustments
  • Git repository handover with full commit history so your team owns and can extend the code
  • Field and account mapping sheet documenting how Decathlon/Mirakl data maps to ERPNext fields

Who this is for

Sports and outdoor brand selling on Decathlon Marketplace

A brand already live (or onboarding) on Decathlon's Mirakl marketplace that runs ERPNext as its ERP and wants orders, stock, and settlements flowing automatically instead of being re-keyed from the seller portal.

ERPNext operations / marketplace manager

The person responsible for keeping listings, prices, and available stock accurate across channels. They need a single source of truth in ERPNext and a reliable resync when a marketplace edge case appears, without living in the Decathlon console.

Finance / accounting lead

Owns month-end and needs Mirakl commission, refunds, and payouts to reconcile cleanly against ERPNext Sales Invoices and Payment Entries, with variances flagged rather than buried in a spreadsheet.

Multi-channel ecommerce brand scaling onto Decathlon

An outdoor or sporting-goods seller already on other channels, adding Decathlon as a new marketplace and wanting the same disciplined ERPNext-centric fulfilment and inventory model applied to it.

How ERPNext Decathlon Marketplace Connector Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Decathlon/Mirakl supportPurpose-built for Decathlon's Mirakl API (OR/OF/ST/PA feeds)Depends entirely on your developer's Mirakl knowledgeGeneric marketplace app, often Amazon/eBay-first, Mirakl an afterthoughtNo concept of Mirakl or Decathlon at all
Inventory syncTwo-way, driven from ERPNext `Bin` projected qty per warehouseBuilt to spec but you own every edge caseOften one-way or single-warehouse onlyManual — you update stock in the seller portal by hand
Settlement reconciliationMirakl commission/refunds/payouts matched to Invoices and Payment EntriesPossible but rarely scoped in a DIY buildUsually out of scope; orders onlySpreadsheet reconciliation by finance
Where it runsNative Frappe app on your own bench, full source handed overYour own bench, but you carry all build riskOften a hosted SaaS holding your credentialsN/A
ERPNext version fitBuilt and tested for v15/v16 against your dataWhatever your team targetsMay lag behind current ERPNext releasesShips with core, no connector
Delivery modelBuild-to-order, one working week from confirmed scope, UAT + rollbackWeeks to months, timeline depends on your teamInstant install but generic; heavy config to fitImmediate but nothing to configure
Auditability`Decathlon Sync Log` records every API push/pullOnly if your developer builds loggingVaries; often opaque hosted logsNone
Ongoing ownershipGit repo handover + support window; you can extend itYou own it fully but built it yourselfLocked to vendor roadmap and subscriptionN/A

Frequently Asked Questions about ERPNext Decathlon Marketplace Connector

How long does delivery take?

This is a build-to-order product, so there is no instant download. Typical delivery is one working week from confirmed scope, depending on how many marketplace edge cases (multi-warehouse, partial shipments, refund handling) you need at go-live versus in a later phase. We give you a firm timeline after the scoping call.

How do support and updates work after go-live?

Every build includes a post-go-live support window for bug fixes and configuration adjustments. Because you receive the full source and git repository, your own team can maintain and extend the app. We also offer ongoing support and version-upgrade retainers (for example, moving from ERPNext v15 to v16 or adapting to Mirakl API changes) as a separate agreement.

Do I need my own Decathlon / Mirakl API access?

Yes. Decathlon Marketplace runs on Mirakl, and you (the seller) hold the shop credentials and API key. We configure the connector against your credentials in the `Decathlon Settings` DocType. Confirming that access is one of the first steps in the scoping call.

Which ERPNext versions are supported?

We build for Frappe/ERPNext v15 and v16, packaged as a standard installable Frappe app on your own bench. If you are on an older version, we will flag that during scoping and discuss an upgrade path or a targeted backport.

Is this a hosted service or does it run on my own ERPNext?

It runs on your own ERPNext bench as a native Frappe app — no external middleman holds your data or credentials. Scheduler jobs, DocTypes, and whitelisted methods all live inside your instance, so you keep full control and a complete audit trail in `Decathlon Sync Log`.

Will Decathlon orders interfere with my direct sales?

No. Orders are mapped to a dedicated marketplace customer, price list, and warehouse, so Decathlon volume is cleanly separated in your ERPNext reporting and inventory while still flowing through native Sales Orders, Delivery Notes, and Sales Invoices.

Can you handle settlement reconciliation, not just orders?

Yes. The connector pulls the Mirakl accounting and payout feeds and matches operator commission, refunds, and payouts against your ERPNext Sales Invoices and Payment Entries, flagging variances so month-end ties out instead of becoming a manual spreadsheet.

Request a quote

ERPNext Decathlon Marketplace Connector

A build-to-order Frappe app that connects Decathlon Marketplace (Mirakl-based) to ERPNext — syncing orders, offers, inventory, pricing, shipping, and settlements. ECOSIRE scopes, builds, installs, and supports it for your sports and outdoor brand.

  • Mirakl OR11 order polling on a Frappe `scheduler_events` cron, de-duplicated by Mirakl order id and materialized as native ERPNext Sales Orders
  • Dedicated marketplace customer, price list, and warehouse mapping so Decathlon orders never contaminate your direct-sales pipeline
  • Two-way inventory sync: projected qty from ERPNext `Bin` pushed to Mirakl offer stock; acknowledged orders decrement the same source of truth
  • Offer and catalog publish via `OF21`, staged from `hooks.py` `doc_events` on Item and Item Price so ERPNext edits propagate without a separate console

Request a Quotation

Tell us about your ERPNext Decathlon Marketplace Connector requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.