Introduction

P2Lab Mirakl is a Shopware 6 plugin that connects your shop to a Mirakl marketplace as a seller account. Mirakl is the platform behind many large operator marketplaces — the seller-side interface is the same across all of them, so the plugin works the same whichever marketplace you sell on.

What it does

The plugin adds a single Mirakl entry to the main Shopware admin sidebar, under the Catalogues group. Clicking it opens the Dashboard, which is the starting point for everything else. From there, the Quick Start card has a tile for each of the plugin’s pages:

Settings — three tabs: Connections (where you add and manage your marketplaces), Sync (turn individual syncs on or off and adjust their schedule), and Options (log retention and detail level).
Categories, Product Attributes, Offer Fields, Offer States, Reason Codes — the marketplace’s own reference data, refreshed on demand or by the setup wizard.
Attribute Mappings and Offer Field Mappings — where you tell the plugin how your Shopware data fills the marketplace’s fields. Both pages can auto-suggest mappings and can export or import their settings as a file.
Catalog (also called the Product Catalog) — the Shopware products you’ve chosen to send to the marketplace, each with its own export status (Pending, Queued, Processing, Exported, Retry, Error).
Offers — your live offers on each marketplace, with their current sync state.
Orders — Mirakl orders that have been turned into Shopware orders. Each order has its own Overview and Customer tabs; messages, documents, invoices and transaction logs are reached from related pages.
Logs and API Logs — what every scheduled run and every conversation with the marketplace looked like, with request and response details.

In the background, the plugin runs a set of scheduled tasks that take care of the regular work: sending your product catalogue out, pushing stock and price updates, importing orders, fetching messages and documents, and pulling invoices and transaction logs. You decide which ones are active and how often they run under Mirakl → Settings → Sync.

Who it is for

Multi-channel sellers who already use Shopware for their own shop and want to expand onto a Mirakl marketplace without re-uploading their catalogue.
Operations teams managing orders across Shopware and one or more marketplaces, who want to ship, refuse and message customers from a single admin.
Agencies onboarding their clients onto Mirakl marketplaces, looking for a repeatable wizard-driven process instead of one-off CSV imports.

The plugin is built specifically for Mirakl marketplaces — not a generic marketplace connector — and it assumes you already have a seller account approved by the marketplace you want to connect to.

What you need

Shopware 6.6 — the plugin is built for the 6.6 line of Shopware.
A working background worker — the plugin uses background processes for everything that takes longer than a few seconds (see Installation for the commands).
A working scheduled task runner — without it, the recurring syncs (stock, orders, etc.) never start by themselves.
A Mirakl seller account on at least one marketplace, along with the marketplace’s web address, your seller API key and your Shop ID.

What you get out of the box

Long jobs resume themselves. Sending a large catalogue or importing thousands of historical orders is split into batches and the next batch is picked up automatically. If a job is interrupted, it continues where it left off the next time.
Built-in rate-limit handling. When the marketplace asks the plugin to slow down, the plugin waits the requested amount of time and retries — you don’t need to fiddle with throttling settings.
Each marketplace is kept separate. Categories, attributes and mappings are stored per Connection, so the same Shopware category can map to completely different marketplace categories on different operators without any conflict.
A full record of every action. Every sync run and every call to the marketplace is logged with the request, the response, the status and the duration.