Stock sync

Stock sync is a separate, lighter path for stock-only changes. Where offer sync re-uploads the whole offer record, stock sync uses Mirakl’s dedicated stock endpoint that only updates available quantity. It costs less of the operator’s API quota and turns around faster, so stock changes typically reach Mirakl in seconds.

Automatic stock sync

You don’t need to click anything for normal stock movements. When a product’s stock changes in Shopware — whether you edited it by hand, an order reduced it, or stock came back through a return — the plugin marks the offer mapping for that product as needing a stock push and the upload runs in the background within seconds.

So in practice: sell a unit, the stock drops in Shopware, and Mirakl shows the new quantity almost immediately.

Scheduled fallback

In case an event was missed (worker downtime, crash, configuration change), the plugin also re-checks the queue on a schedule. By default the check runs every 15 minutes. You can change it to 2, 5, 10, 15, 30 or 60 minutes under Stock Sync Interval in Mirakl → Settings → Sync.

Manual sync

From Dashboard → Quick Actions → Sync Stock Now — runs a full stock sync for the chosen connection straight away (the same code path the scheduler uses).

Where to configure

Mirakl → Settings → Sync tab, Sync Settings card:

• Enable Stock Sync — master switch. Default: on.
• Stock Sync Interval — how often the scheduled fallback wakes up. Default: 15 minutes.

There is no per-connection on/off. To temporarily exempt one connection from stock sync, pause the connection at the operator side or deactivate its offer mappings.

Where you see the stock value

Stock values shown in Mirakl appear in the In Stock column on Offer Mappings (alongside Available, which factors in already-reserved units). After a stock change you can verify the round-trip from there.

Tips & gotchas

Tip

Don’t switch stock sync off to save operator quota — the stock endpoint is one of the cheapest, and the plugin already skips uploads when nothing actually changed. Turning it off mostly causes overselling.

Caution

Stock sync never sends negative numbers — negative Shopware stock becomes zero on Mirakl. If you rely on negative stock as a flag in Shopware, expose that meaning through a separate offer field mapping (for example a custom field that converts negative stock to a status string) rather than the stock value itself.

Note

Stock sync ignores offer mappings whose product hasn’t yet been added to the Mirakl catalogue (catalog status not yet Exported). It also ignores mappings whose Shopware product has been deleted — those mappings move to Error so you can clean them up.

Caution

Stock and full offer updates are tracked separately. If a Shopware save changed both price and stock, the plugin sends the stock update via stock sync and the offer update via offer sync. You don’t have to pick one — both run.

Related

• Offer sync — full offer update (price, lead time, custom fields)
• Mapping offer fields — stock can also be sent as part of a full offer update via the Effective Stock source type
• Sync logs
• Background tasks