Dokumentanforderungen

Einige Mirakl-Betreiber verlangen, dass Händler für jede Bestellung eine offizielle Rechnung oder Gutschrift hochladen, anstatt sie automatisch vom Marktplatz generieren zu lassen. Der Betreiber sendet diese als Dokumentanforderungen — eine pro Bestellung oder Gutschrift — und das Plugin holt sie vom Betreiber und listet sie hier auf.

Diese Seite zeigt offene Anforderungen, in welchem Zustand jede ist, und lässt Sie sie durch Hochladen der PDF- oder cXML-Datei direkt erfüllen, ohne das Shopware-Admin zu verlassen.

Wo zu finden

Öffnen Sie im Dashboard die Karte Quick Start und klicken Sie die Kachel Dokumentanforderungen. Dies öffnet die Seite Dokumentanforderungen.

Was angezeigt wird

Kartentitel auf der Seite: Dokumentanforderungen (DR11). Spalten:

Spalte	Bedeutung
Request ID	Die Betreiber-seitige Kennung der Anforderung.
Type	Rechnung oder Gutschrift.
Entity type	Worauf die Anforderung sich bezieht (typischerweise die Bestellung).
State	Einer von Staging, Zu bearbeiten, Ausgestellt, Storniert.
Document number	Die Dokumentnummer, die Sie (oder der Betreiber) vergeben haben.
Issue date	Wann das Dokument ausgestellt wurde.
Due date	Wann der Betreiber die Erfüllung erwartet.
Last updated	Zeitstempel der letzten Aktivität.
Verbindung	Zu welcher Mirakl-Verbindung diese Anforderung gehört.

Die Seitenleiste bietet:

Verbindung — nach Mirakl-Verbindung filtern.
State — nach Anforderungsstatus filtern.
Type — nach Rechnung / Gutschrift filtern.
Aktualisieren — zieht die aktuelle Liste.

Anforderungen vom Betreiber synchronisieren

Die Symbolleiste hat eine Von Mirakl synchronisieren-Aktion. Klicken öffnet den Dialog Dokumentanforderungen synchronisieren — wählen Sie eine Mirakl-Verbindung, bestätigen Sie, und das Plugin zieht jede offene Anforderung, die der Betreiber aktuell für diese Verbindung hat.

Dokumentanforderungen werden auch automatisch vom geplanten Task Dokumentanforderungs-Synchronisation gezogen (standardmäßig aus — aktivieren Sie ihn unter Mirakl → Einstellungen → Sync-Einstellungen, wenn Sie Hintergrund-Polling wollen).

Eine Anforderung erfüllen

Zeilen in Zu bearbeiten haben eine Erfüllen (PDF/cXML hochladen)-Aktion. Klicken öffnet den Dialog Dokumentanforderung erfüllen:

Document number — erforderlich.
Issue date — erforderlich.
Due date — optional.
Total (excl. tax) — optional.
Total tax — optional.
Files (PDF or cXML only) — der eigentliche Dokumentanhang.

Bestätigen Sie mit Erfüllen, und die Datei wird an den Betreiber gesendet. Die Zeile wechselt zu Ausgestellt, sobald Mirakl den Upload akzeptiert.

Bedeutung der Zustände

Zustand	Was es bedeutet
Staging	Der Betreiber bereitet die Anforderung vor — noch nicht aktionsfähig.
Zu bearbeiten	Bereit zur Erfüllung. Die Aktion Erfüllen ist aktiviert.
Ausgestellt	Sie haben sie erfüllt; der Betreiber hat die Datei.
Storniert	Der Betreiber hat die Anforderung storniert — keine Aktion erforderlich.

Tipps & Fallstricke

Verwandt

Rechnungen — Rechnungen, die das Plugin vom Betreiber zieht (anderer Ablauf)
Bestelldokumente — Dokumente, die an die Bestellung angehängt sind (Lieferschein, Versandschein usw.)
Bestellungsimport — wie Bestellungen ins Shopware kommen
Einstellungen — Dokumentanforderungs-Synchronisation für periodisches Hintergrund-Polling aktivieren