Skip to content

Configuration

“SilentJMA” edited this page Jun 18, 2026 · 1 revision

Configuration

Adding a Mirakl Store

  1. Go to Mirakl → Stores in the WordPress admin.
  2. Click Add New Store.
  3. Fill in the fields:
Field Description
Store Name A unique identifier for this store (used in admin and database)
API Endpoint Your Mirakl MMP API base URL (e.g., https://your-mirakl-instance.mirakl.net)
API Key The API key for the Mirakl shop
Shop ID (Optional) The Mirakl shop ID
Active Toggle to enable/disable this store
Store Language Locale for delivery notes and attribute filtering (e.g., de_DE, en_US, fr_FR)
Shipping Method WooCommerce shipping method assigned to this store's orders
Shipping Label Prefix Prefix for the shipping method label
  1. Click Test Connection to verify API access.
  2. Click Save Store.

Editing a Store

Click any store row in the Stores table. The form pre-populates with existing values. Modify as needed and save.

Deleting a Store

Use the Delete action on the Stores table. This removes credentials, sync history, and store-specific mappings from the database.

Setting Up Synchronization

  1. Go to Mirakl → Sync Schedule.
  2. Toggle each sync type you want to enable:
Sync Type Description
Order Import Create WooCommerce orders from Mirakl sales
Stock Sync Push WooCommerce stock levels to Mirakl
Price Sync Push WooCommerce prices to Mirakl (PRI01)
Product Import Import products from Mirakl to WooCommerce
  1. Set the interval for each enabled sync type (5/10/15/30 min or hourly).
  2. Click Save Settings.

Sync jobs run on WordPress cron. Each sync type has an independent lock (via Mirakl_Sync_Lock) that prevents concurrent runs for the same store+type combo.

Store Language & Locale

The Store Language setting controls:

  • Delivery Notes — The language used in PDF delivery notes (DE, EN, FR, NL, ES)
  • Attribute Mapping — VL11 value-list filtering; only values whose locale suffix matches the store language are shown in the autocomplete

The locale is stored in the mirakl_api_settings table and is accessible via the mirakl_connector_api_credentials filter for programmatic overrides.

Shipping Method Per Store

Each store can have a unique WooCommerce shipping method and label prefix assigned. When Mirakl orders are imported, the configured shipping method is applied to the WooCommerce order automatically.

Clone this wiki locally