Bestelldokumente

Mirakl-Betreiber führen pro Bestellung einen Satz an Dokumenten: Kundenrechnungen, Gutschriften, Lieferscheine, Zollrechnungen und so weiter. P2Lab Mirakl spiegelt diesen Satz in Shopware auf der Bestelldetailseite und unterstützt beide Richtungen — Sie können ein vom Betreiber gesendetes Dokument herunterladen und ein eigenes hochladen. Zusätzlich kann das Plugin in Shopware erzeugte Dokumente (z. B. die Rechnungs-PDF) automatisch übertragen.

Wo Sie es finden

Öffnen Sie eine beliebige Shopware-Bestellung, die aus Mirakl importiert wurde. Das Plugin fügt der Standard-Bestelldetailseite einen Reiter Mirakl hinzu; innerhalb dieses Reiters gibt es drei Unterreiter: Übersicht, Nachrichten und Dokumente.

Der Unterreiter Dokumente zeigt eine Karte mit dem Titel Dokumente und zwei Aktionen in der Werkzeugleiste:

Synchronisieren — holt sofort die aktuelle Dokumentliste dieser Bestellung vom Betreiber.
Dokument hochladen — öffnet den Dialog Dokument zu Mirakl hochladen.

Was die Liste zeigt

Die Dokumenttabelle hat folgende Spalten:

Dateiname
Typ — Art des Dokuments. Erkannt werden u. a. Kundenrechnung, Gutschrift, Lieferschein, Zollrechnung und Sonstige. Jeder Betreiber kann weitere Codes verwenden.
Richtung — Eingehend (Betreiber → Shopware) oder Ausgehend (Shopware → Betreiber).
Quelle — Auto (Shopware) (automatisch übertragen, weil Shopware ein Dokument erzeugt hat), Manuell (Shopware) (von Ihnen über den Dialog Dokument hochladen hochgeladen) oder Mirakl-Sync (vom Betreiber heruntergeladen).
Status — Phase im Lebenszyklus: Ausstehend, Wird hochgeladen, Hochgeladen, Synchronisiert, Heruntergeladen, Fehler.
Größe
Erstellt

Jede Zeile bietet folgende Aktionen:

Herunterladen — speichert die Datei lokal.
Upload wiederholen — erscheint nur bei fehlgeschlagenen ausgehenden Zeilen.
Fehlerdetails anzeigen — öffnet einen Dialog mit der Antwort des Betreibers.
Löschen — entfernt den Eintrag in Shopware.

Ein Dokument hochladen

Klicken Sie in der Werkzeugleiste auf Dokument hochladen.
Wählen Sie unter Dokumenttyp einen der vom Betreiber zugelassenen Typen.
Wählen Sie unter Dateien die hochzuladende(n) Datei(en).
Klicken Sie auf Hochladen.

Die Datei wird als ausgehende Zeile mit Status Ausstehend angelegt und im Hintergrund an den Betreiber übertragen. Bei Erfolg wechselt der Status auf Hochgeladen oder Synchronisiert.

Auto-Upload aus Shopware

Das Plugin kann in Shopware erzeugte PDFs automatisch an die passende Mirakl-Bestellung anhängen. Erzeugen Sie in Shopware ein Dokument (die Rechnungs-PDF, einen Lieferschein usw.) für eine aus Mirakl stammende Bestellung, läuft Folgendes:

Die Zuordnungstabelle Dokument-Auto-Upload der Verbindung wird geprüft — sie sagt „Shopware Rechnung entspricht Mirakl Kundenrechnung” und so fort.
Existiert ein passender Eintrag und ist der Auto-Upload-Schalter der Verbindung aktiv, erscheint das erzeugte PDF in der Liste Dokumente mit Quelle = Auto (Shopware).
Anschließend wird es im Hintergrund an Mirakl hochgeladen — denselben Weg wie ein manueller Upload.

Die Zuordnung konfigurieren Sie im Setup-Assistenten der Verbindung (Schritt 11) oder jederzeit später über das Kontextmenü der Zeile in Mirakl → Einstellungen → Verbindungen → Dokument-Auto-Upload.

Der Auto-Upload spart bei den häufigsten Dokumenten (vor allem der Kundenrechnung) den manuellen Klick pro Bestellung und verhindert Eskalationen seitens des Betreibers wegen fehlender Belege auf großen Verbindungen.

Dokumentanforderungen

Betreiber können außerdem Dokumentanforderungen ausstellen — formale Anfragen wie „bitte senden Sie eine Zollerklärung zu dieser Bestellung bis Datum X”. Sie werden getrennt abgerufen und auf einer eigenen Seite angezeigt:

Öffnen Sie Mirakl Dashboard → Schnellstart → Dokumentanforderungen. Die Seite trägt den Titel Dokumentanforderungen (DR11).
Jede Anforderung hat einen Status (Vorbereitung, Zu bearbeiten, Ausgestellt, Storniert), einen Typ (Rechnung oder Gutschrift), ein Fälligkeitsdatum und eine Aktion Erfüllen (PDF/cXML hochladen), die den Dialog Dokumentanforderung erfüllen öffnet.

Hintergrund-Synchronisation

Das Plugin holt regelmäßig neue Dokumente vom Betreiber. Der Standard-Abstand ist 30 Minuten, und Dokumente werden bei abgeschlossenen Bestellungen noch 30 Tage lang synchronisiert — innerhalb dieser Frist können geschlossene Bestellungen noch eine Endrechnung oder eine Gutschrift erhalten.

Dokumentanforderungen werden getrennt abgefragt, standardmäßig einmal pro Tag (so empfiehlt es der Betreiber).

Um eine einzelne Bestellung sofort zu aktualisieren, verwenden Sie die Schaltfläche Synchronisieren auf der Dokumente-Karte.

Erst-Import

Wenn Sie für eine Verbindung erstmals den Bestellimport aktivieren, holt das Plugin außerdem die komplette Dokument-Historie für jede Bestellung innerhalb des Erst-Import-Zeitraums nach. Wird der Lauf unterbrochen, setzt er an der unterbrochenen Stelle wieder ein.

Konfiguration

Öffnen Sie Mirakl → Einstellungen, Reiter Sync, Karte Dokumentensynchronisierung (Mirakl → Shopware):

Bestelldokument-Synchronisierung aktivieren (OR72) — standardmäßig aus.
Dokumentensync-Intervall — wie oft neue Dokumente abgerufen werden. Werte von 5 Minuten bis 24 Stunden. Standard: 30 Minuten.
Dokumente für geschlossene Bestellungen synchronisieren (Tage) — wie lange nach Abschluss einer Bestellung weiter nach Dokumenten gesucht wird. Werte: 1 / 3 / 5 / 7 / 14 / 30 Tage. Standard: 30.
Dokumentanforderungs-Synchronisierung aktivieren (DR11) — standardmäßig aus.
Dokumentanforderungs-Sync-Intervall — Werte von 1 Stunde bis 24 Stunden. Standard: 24 Stunden.