RAU Mirakl Order Sync for WooCommerce

Pitanja i odgovori

Which marketplaces does this work with?

Any marketplace running on the Mirakl platform that gives sellers API access. That includes retailers such as Carrefour, Decathlon, Leroy Merlin, Auchan, Fnac Darty, El Corte Inglés and MediaMarktSaturn, among many others. The plugin talks to the standard Mirakl seller API rather than to one specific marketplace, so if your seller account provides an API URL and a shop API key, it should connect.

Do I need a Mirakl API key, and where do I find it?

Yes. The key comes from your seller account on the marketplace, usually under Settings → API in the Mirakl back office. It authenticates your shop, so treat it like a password. If you cannot see an API section, ask the marketplace’s seller support to enable API access for your account.

Can I connect more than one Mirakl shop?

Yes, there is no limit. Each shop is added separately with its own API URL, key and Mirakl shop ID, and each has its own settings for scheduled imports, auto-accept, order status, pricing, carrier and country handling. One API key that manages several shops is also supported — that is what the Mirakl Shop ID field is for.

How often are orders imported?

You choose. The automatic import can run every five minutes, every fifteen minutes, hourly, twice daily or daily. You can also run an import manually at any time from the Import Orders tab, either for a date range or for specific Mirakl order IDs. Scheduled imports rely on WP-Cron, so on a quiet site consider a real server cron for reliable timing.

Will the same order be imported twice?

No. Every imported order is stored with its Mirakl order reference, and the plugin checks for that reference — in every order status, including the trash — before creating anything. Each shop is imported by one run at a time, so a manual import cannot overlap the scheduled one. Re-running an import updates the existing orders instead of duplicating them.

What happens to orders the customer has not paid yet?

On Mirakl an order is only paid once it reaches the SHIPPING state; before that (WAITING_DEBIT, WAITING_DEBIT_PAYMENT) it has no shipping address and may never be paid. By default such orders are imported as “Pending payment” — no order emails, no invoice, no stock reduction — and switched to your import status automatically once Mirakl reports them paid. You can pick another holding status per shop, or choose not to import unpaid orders at all. Cancelled and refused orders are never imported, and an imported order that Mirakl cancels is cancelled in WooCommerce too.

My prices include VAT. Are the order totals correct?

Yes. Each shop has a “Marketplace prices include tax” option. On Automatic it follows the tax mode the marketplace sends with the order, or your WooCommerce “Prices entered with tax” setting. When prices include tax, the plugin takes the tax out using your WooCommerce tax rates, so the order total equals what the customer paid.

Does it work with High-Performance Order Storage (HPOS)?

Yes. The plugin declares HPOS compatibility and works with both the legacy post-based order storage and the newer high-performance order tables.

Can it accept Mirakl orders automatically?

Yes, per shop. Marketplaces usually require orders to be accepted within a set window or they are cancelled, so you can enable auto-accept for shops where you always fulfil, and leave it off for shops where you want to check stock first.

How do tracking numbers get back to Mirakl?

When you complete an order in WooCommerce, the plugin sends the tracking number and carrier to Mirakl first, then confirms the shipment. Tracking numbers are read from DHL for WooCommerce, WooCommerce Shipment Tracking, Advanced Shipment Tracking and Germanized shipments; other shipping plugins can supply one through the ramos_tracking_info filter. Carrier code, name and tracking URL are set per shop. If no tracking number is found, the shipment is still confirmed. You can turn this off in Settings if you prefer to confirm shipments in the marketplace portal yourself.

What happens if a Mirakl order contains a SKU that is not in my store?

Products are matched by SKU — by default your own offer SKU first, then the marketplace’s product SKU (you can reverse that per shop, or map products in code with the ramos_match_product filter). If a SKU does not exist in WooCommerce, the plugin can create a placeholder product so the order still imports with correct totals rather than failing. That option is per shop, and can be left off if you would rather the mismatch be visible.

Orders are not importing. How do I find out why?

Turn on logging in Settings and check WooCommerce → Status → Logs, source ramos-order-sync. Every API call and import run is recorded there, including authentication failures and empty date ranges. The Test connection button on each shop is the quickest way to confirm the API URL and key are correct.

Can I change how orders are imported from my own code?

Yes. Filters: ramos_should_import_order (skip an order entirely), ramos_import_order_status (the WooCommerce status for each Mirakl state), ramos_match_product, ramos_tracking_info, ramos_prices_include_tax, ramos_paid_order_states, ramos_cancelled_order_states, ramos_notify_unpaid_cancellation and ramos_api_request_args. Actions: ramos_before_order_save, ramos_order_imported and ramos_order_updated. Each is documented in the plugin source.

What happens to my data if I uninstall the plugin?

Uninstalling removes the plugin’s own settings, including your saved shops and API keys. Orders that were already imported stay in WooCommerce, because they are ordinary WooCommerce orders.