Invoices

In addition to your orders, Mirakl operators issue invoices against your seller account — operator commission, marketplace fees, payment notices. These are records on the operator’s side, separate from any commercial invoice you generate for the buyer. P2Lab Mirakl pulls them into Shopware so you can reconcile them with what hits your bank account.

Where to find it

Open Mirakl Dashboard → Quick Start → Invoices. The page title is Mirakl Invoices and the main card on the page is titled Operator Invoices (IV01).

The grid has these columns:

• Connection — which marketplace connection the invoice belongs to.
• Invoice number
• Type — Auto invoice, Manual invoice or Manual credit.
• Payment — current payment status: Pending, Paid or Failed.
• Total (incl. tax)
• Currency
• Created
• Last updated

Sidebar filters: Connection, Type, Payment status.

Toolbar buttons:

• Refresh — refreshes the list from the local database.
• Sync from Mirakl — opens the Sync invoices dialog, where you pick one of your connections and the plugin fetches new invoices from that operator.

Per-row action: Download PDF — downloads the operator’s PDF on demand.

What gets stored

For every invoice the plugin stores the metadata (invoice number, type, payment status, total, currency, dates) plus a reference to the operator’s PDF URL. The PDF itself is fetched from the operator the moment you click Download PDF, not stored locally.

Background sync

The plugin polls each connection for new invoices on a schedule. The default interval is once every 24 hours — Mirakl’s own recommendation for this endpoint — which is enough since most operators issue invoices on a daily or monthly cycle.

Initial import

The first time you turn on order import for a connection, the plugin also backfills every invoice from the initial-import window. If the run is interrupted it resumes where it stopped.

On-demand sync

Use the Sync from Mirakl toolbar button on the Invoices page when you need new invoices right now without waiting for the schedule. It opens a dialog where you pick a single connection and the plugin runs the same sync that would otherwise run on the schedule.

Configuration

Open Mirakl → Settings → Sync tab, Invoicing & Transaction Logs Sync card:

• Enable Invoice Sync (IV01) — default off.
• Invoice Sync Interval — how often to pull new invoices. Presets 6 / 12 / 24 hours. Default 24 hours (the operator’s recommendation).

Tips & gotchas

Tip

Invoices are the audit trail of what the operator actually charged you. Even if you never look at them in Shopware day-to-day, having them synced gives you a single place to reconcile against your bank statements when the monthly cycle closes.

Caution

The plugin stores invoice metadata and a reference to the operator’s PDF URL — not the PDF binary itself. If the operator rotates URLs or revokes access, the PDF stops being downloadable. For long-term archival, export the PDFs separately to your own storage on a schedule.

Note

Some operators issue one consolidated invoice per period (monthly), others one per order. The plugin does not care — it stores whatever the operator returns. Sort by Created to see which cycle your operator uses.

Related

• Transaction logs — the line-level financial records that add up to the invoice totals
• Order import — invoices reference orders, so import orders first
• Sync logs
• Background tasks