Skip to content

Carrier Management

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

Carrier Management

The plugin synchronizes carrier codes from Mirakl and allows per-channel mapping to WooCommerce shipping methods.

Access

Navigate to Mirakl → Carriers.

Features

Carrier List

Displays all carriers fetched from the Mirakl CA01 API, showing:

  • Code — Mirakl carrier code
  • Label — Human-readable carrier name
  • Standard Code — Standardized carrier code (if applicable)
  • Tracking URL — URL template for tracking (auto-filled or custom)

Per-Channel Carrier Mapping

Each store can have per-channel carrier overrides:

  1. Select a store from the dropdown
  2. For each channel, select a carrier code and (optionally) set a tracking URL
  3. Save to apply

Mappings are stored in the mirakl_carrier_mapping table.

Carrier Sync

Carriers are fetched from Mirakl via the CA01 API. The sync runs:

  • Automatically when the carrier management page is loaded
  • Via the Sync Carriers button on the page

Database Tables

Table Purpose
{$prefix}mirakl_carriers Carrier codes, labels, standard codes, tracking URLs
{$prefix}mirakl_carrier_mapping Per-channel carrier mappings (store → channel → carrier)

Usage in Order Sync

When an order is imported from Mirakl and marked as shipped:

  1. The carrier code from the order is looked up in local mapping
  2. If a tracking URL template exists, it's populated with order details
  3. The WooCommerce order's shipping meta is updated (_carrier_code, _tracking_number)
  4. These values are used in subsequent tracking update calls to Mirakl

Clone this wiki locally