Mirakl Connector Features

Mirakl is a leading enterprise marketplace platform that enables businesses to sell across top global marketplaces. By connecting your Mirakl Seller Portal with Odoo using the Mirakl Connector, you can automate key operations including Master Data imports, product listing synchronization, inventory updates, order imports, and shipment tracking — all managed directly within Odoo.

Note

The connector does not support creating new products on Mirakl directly from Odoo. Products must first be staged in the Mirakl Seller Portal before they can be imported into Odoo.

Supported Features

  • Data Synchronization

    • Imports Master Data (logistic classes, channels, shipping zones, carriers, offer states, and product categories), product listings, and orders from Mirakl into Odoo. Exports inventory levels and fulfillment status from Odoo to Mirakl. Eliminates manual data entry and keeps both platforms aligned.

  • Inventory Management

    • The connector enables centralized inventory management by automatically calculating your available local Odoo stock and exporting it to Mirakl using bulk file uploads. This ensures your active offers always reflect accurate availability, preventing overselling.

  • Product / Listing Management

    • Imports existing Mirakl products into Odoo as Listing records and links them to local Odoo products by SKU. Each imported listing captures the product description, product references (EAN/UPC/ISBN/MPN/SKU), Offer State (product condition), Logistic Class, Shipping Zone, and Channel.

    • Stock levels for imported listings can be pushed back to Mirakl using the Export Inventory operation or the automated stock export scheduled action.

  • Order Management

    • Imports orders from Mirakl into Odoo as Sale Orders, including:

      • Product name, quantity, and unit price per line.

      • Shipping costs and delivery carrier per order line.

      • Taxes mapped according to the instance Tax System configuration.

    • Automatically detects when an already-imported order becomes fulfilled (SHIPPED, RECEIVED, or CLOSED) on Mirakl and validates the corresponding Odoo delivery order, updating tracking details in the process.

    • Captures marketplace cancellations: if an order is canceled on Mirakl, the connector cancels the Odoo Sale Order and associated delivery pickings, and posts the Mirakl cancellation reason code and label in the order chatter.

  • Customer Management

    • Creates or updates separate billing and shipping partner records in Odoo for each imported order. When Create Company Contact? is enabled on the instance and the customer provided a company name, a parent company record is created and linked to both contacts.

  • Multi-Channel Selling

    • Supports Mirakl Channels. Products and orders are mapped to the correct channel code, enabling accurate multi-storefront management within a single Odoo instance.

  • Multi-Instance Support

    • Connect multiple Mirakl marketplaces or shops to a single Odoo database. Each instance maintains its own API credentials, warehouse, pricelist, scheduled actions, workflow configuration, and order status filters.

  • Automation and Workflow

    • Automates order import, stock export, and fulfillment status export via configurable scheduled actions. Three scheduled actions are created automatically when a new instance is confirmed: Import Orders (every 15 minutes), Export Product’s Stock to Mirakl (every 25 minutes), and Export Order Status/Tracking Information to Mirakl (every 25 minutes).

    • Supports automated order processing (auto-confirm, auto-invoice, auto-payment) via Financial Workflow Configuration, matched per Payment Type and Financial Status.

  • Shipping and Tracking

    • When a delivery order is validated in Odoo, the connector sends the tracking number and carrier information to Mirakl and marks the order as SHIPPED.

    • When orders are imported with a fulfilled status from Mirakl, the connector automatically validates the corresponding Odoo delivery and creates the related stock moves.

  • Queue-Based Processing

    • Bulk operations such as order and product imports are processed by a background Queue Job system, keeping Odoo responsive during large syncs. Failed queue lines display the exact error message and can be retried individually. All operation results are logged at Marketplaces ‣ Queues ‣ Logs.

Synchronization Capabilities

Orders

Import

Inventory / Stock

Export

Fulfillment Status

Export

Benefits

  • Streamlined Operations

    • Centralizes management of orders, inventory, and product listings in Odoo, eliminating manual data entry between platforms and reducing the risk of errors.

  • Accurate Inventory

    • Scheduled stock exports ensure Mirakl listings always reflect current Odoo stock levels, reducing the risk of overselling or stockouts and protecting seller health metrics.

  • Faster Order Fulfillment

    • Automated order import and workflow processing reduces manual steps from order receipt to invoice and payment, accelerating the fulfillment cycle.

  • Traceability

    • Every import and export operation is logged. Detailed queue job logs allow quick identification and resolution of synchronization failures without reprocessing entire batches.

Conclusion

The Mirakl Connector for Odoo provides a reliable integration for businesses selling on Mirakl marketplaces. By importing orders and product listings from Mirakl and exporting inventory levels and fulfillment status back to Mirakl, the connector reduces manual work, improves data accuracy, and supports scalable marketplace operations.

Note

The connector synchronizes data as described above. All other Mirakl Seller Portal actions such as catalog creation, pricing rules, and policy management must be managed directly within the Mirakl platform.

See also