Transaktionsprotokolle

Transaktionsprotokolle sind die einzelnen Finanzbuchungen Ihres Mirakl-Kontos. Jede Gebühr, jede Provision, jede Rückerstattung und jede Auszahlung, die der Betreiber Ihnen bucht, erscheint als eine Zeile. Rechnungen fassen sie zusammen — die Transaktionsprotokolle sind die Quelldaten, aus denen diese Summen entstehen.

Wo Sie es finden

Öffnen Sie Mirakl Dashboard → Schnellstart → Transaktionsprotokolle. Die Seite heißt Transaktionsprotokolle und hat zwei Karten:

Seller-Payment-Transaktionen (TL02) — die eigentlichen Buchungen.
Export-Aufträge — von Ihnen gestartete Massen-Exporte.

Karte Seller-Payment-Transaktionen

Spalten: Verbindung, Typ, Betrag, Währung, Bestellung, Transaktionsdatum, Erstellt.

Filter in der Seitenleiste: Verbindung, Transaktionstyp.

Werkzeugleiste:

Aktualisieren — lädt die Liste aus der lokalen Datenbank neu.
Synchronisieren — öffnet den Dialog Transaktionsprotokolle synchronisieren, in dem Sie eine Verbindung wählen; das Plugin holt dann neue Buchungen von diesem Betreiber.
Verlauf exportieren — öffnet den Dialog Transaktionsverlauf exportieren (siehe unten).

Aktion pro Zeile: Details anzeigen — öffnet einen Dialog mit allen Originaldaten der Buchung vom Betreiber.

Erkannte Transaktionstypen sind u. a. Bestellbetrag, Provisionsgebühr, Rückerstattung Bestellbetrag, Rückerstattung Provisionsgebühr, Versandbetrag, Rückerstattung Versandbetrag, Auszahlung, Manuelle Gutschrift und Manuelle Rechnung. Jeder Betreiber kann weitere ergänzen.

Karte Export-Aufträge

Zeigt die von Ihnen gestarteten Massen-Exporte und deren Status (Ausstehend, Läuft, Abgeschlossen, Fehler). Sobald ein Auftrag fertig ist, erscheint in der Zeile die Aktion Herunterladen.

Was gespeichert wird

Pro Buchung speichert das Plugin:

die Transaktions-ID des Betreibers,
den Typ (ein Textwert des Betreibers — die erkannten Codes sehen Sie im Filter Transaktionstyp),
das Transaktionsdatum,
Betrag und Währung,
die zugeordnete Mirakl-Bestellung (leer bei Buchungen, die nicht zu einer einzelnen Bestellung gehören, z. B. monatliche Gebühren),
die vollständigen Originaldaten des Betreibers, abrufbar über Details anzeigen.

Hintergrund-Synchronisation

Das Plugin holt für jede Verbindung neue Buchungen nach Zeitplan. Der Standard-Abstand ist einmal alle 24 Stunden. Mirakl nennt für diesen Endpunkt eine weiche Grenze von etwa 20 Aufrufen pro Tag, daher sollten Sie nicht unter 6 Stunden gehen.

Eine zweite geplante Aufgabe läuft jede Minute und prüft den Stand laufender Massen-Exporte — sobald ein Export fertig ist, erscheint in der Karte Export-Aufträge die Aktion Herunterladen.

Erst-Import

Wenn Sie für eine Verbindung erstmals den Bestellimport aktivieren, holt das Plugin alle Buchungen im Erst-Import-Zeitraum nach. Bei Konten mit jahrelanger Historie wählen Sie im Assistenten ein eher kürzlich liegendes Startdatum, um nicht Millionen alter Zeilen zu ziehen.

Massen-Export

Brauchen Sie mehr Historie, als die laufende Synchronisation abdecken würde (z. B. alle Provisionen eines Quartals für den Jahresabschluss), nutzen Sie die Aktion Verlauf exportieren:

Klicken Sie auf der Seite Transaktionsprotokolle auf Verlauf exportieren. Der Dialog Transaktionsverlauf exportieren öffnet sich.
Wählen Sie eine Verbindung, ein Von Datum und ein Bis Datum.
Optional ein Wert in Transaktionstyp-Filter (z. B. ein bestimmter Typcode) — leer lassen für alle Typen.
Klicken Sie auf Export starten.

Der Auftrag erscheint in der Karte Export-Aufträge mit Status Ausstehend. Das Plugin fragt den Betreiber im Hintergrund regelmäßig ab; ist der Export fertig, erscheint in der Zeile die Aktion Herunterladen. Das Ergebnis ist eine einzige CSV-Datei, die der Betreiber serverseitig erzeugt hat.

Konfiguration

Öffnen Sie Mirakl → Einstellungen, Reiter Sync, Karte Rechnungen & Transaktionsprotokolle:

Transaktionsprotokoll-Synchronisierung aktivieren (TL02) — standardmäßig aus.
Transaktionsprotokoll-Sync-Intervall — wie oft neue Buchungen geholt werden. Werte: 6 / 12 / 24 Stunden. Standard: 24 Stunden.
Poll-Intervall für Transaktionsprotokoll-Export — wie oft der Stand laufender Massen-Exporte geprüft wird. Werte: 30 Sekunden / 1 Minute / 5 Minuten. Standard: 1 Minute.