Skip to main content

Mirakl Store Management

The ECOSIRE Mirakl Store Management module integrates your Mirakl marketplace accounts with Odoo ERP. Mirakl is the world's leading marketplace platform powering 400+ enterprise marketplaces including Adeo, Carrefour, Macy's, Best Buy, and many more. This module connects to any Mirakl-operated marketplace through a single unified API, enabling you to manage multi-marketplace operations from a single Odoo instance.

Compatibility: Odoo 17 / 18 / 19 Price: $499 (one-time) License: Up to 3 domain activations

Key Features​

  • Universal Mirakl Marketplace API integration (works with any Mirakl operator)
  • API key authentication with operator-specific base URLs
  • Bidirectional product and offer synchronization
  • Automatic order import and fulfillment management
  • Real-time inventory and price updates
  • Offer validation and status monitoring
  • Multi-marketplace management from a single Odoo instance
  • Document and invoice exchange with operators
  • Returns and refund processing
  • Multi-company record rules for isolated data management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A seller account on one or more Mirakl-powered marketplaces
  • Mirakl API key from the operator portal for each marketplace

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-mirakl-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for "ECOSIRE Mirakl Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Mirakl API Credentials​

  1. Log in to the operator's Seller Portal (URL provided by the marketplace operator)
  2. Navigate to Account Settings then API or Integrations
  3. Generate or copy your API Key for this marketplace
  4. Note the Operator Base URL (e.g., https://marketplace.operator.com)
  5. Repeat for each Mirakl marketplace you operate on

Step 2: Connect in Odoo​

  1. Navigate to Mirakl Store Management > Configuration
  2. Create a new configuration per marketplace and enter:
    • API Key (api_key) -- your Mirakl seller API key
    • Operator URL (operator_url) -- the base URL of the operator's Mirakl instance
    • Marketplace Name -- a descriptive label for this connection
  3. Click Test Connection to verify API access
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product and Offer Sync​

  • Choose sync direction: Mirakl to Odoo, Odoo to Mirakl, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product attribute mapping to the operator's catalog schema
  • Monitor offer validation status and approval workflows

Inventory Sync​

  • Map Odoo warehouses to Mirakl fulfillment settings
  • Set buffer stock quantities per marketplace to prevent overselling
  • Enable real-time stock and price updates

Order Sync​

  • Enable automatic order import with order status polling
  • Map Mirakl payment methods to Odoo payment journals
  • Configure shipment confirmation to acknowledge orders on the marketplace

Initial Sync​

  1. Go to Mirakl Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodAPI Key in Authorization header
Base endpoint{operator_url}/api (configurable per marketplace)
Products endpoint/products
Offers endpoint/offers
Orders endpoint/orders
API versionMirakl API v1
Key config fieldsapi_key, operator_url

Dashboard​

The built-in OWL 2 dashboard provides real-time visibility into your integration:

  • 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
  • Sales Trend chart (Chart.js line chart) with interactive date filtering
  • Order Status breakdown (doughnut chart) showing distribution across statuses
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
  • Activity feed showing recent sync log entries with type indicators
  • Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
  • Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
  • Auto-refresh every 60 seconds with dark mode support

Troubleshooting​

IssueSolution
Connection failedVerify API key and operator URL; confirm the URL includes the protocol (https://)
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Offers rejectedReview offer data against the operator's catalog requirements
Orders not importingVerify order status filters and date range settings
401 UnauthorizedRegenerate API key in the operator's Seller Portal
Wrong operator URLConfirm the base URL with your marketplace operator contact
Product schema mismatchMap attribute fields to the operator-specific taxonomy
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on