Transaction logs

Transaction logs to pojedyncze, liniowe rekordy finansowe Twojego konta Mirakl. Każda opłata, prowizja, zwrot i wypłata, którą operator zaksięguje na Twoim koncie, pojawia się jako jeden wiersz. Faktury agregują te dane — transaction logs to materiał źródłowy, z którego powstają te sumy.

Gdzie to znaleźć

Otwórz Mirakl Dashboard → Quick Start → Transaction Logs. Strona ma tytuł Transaction Logs i zawiera dwie karty:

Seller Payment Transactions (TL02) — same transakcje.
Export jobs — eksporty zbiorcze, które uruchomiłeś.

Karta Seller Payment Transactions

Kolumny: Connection, Type, Amount, Currency, Order, Transaction date, Created.

Filtry w panelu bocznym: Connection, Transaction type.

Pasek narzędzi:

Refresh — odświeża listę z lokalnej bazy.
Sync — otwiera okno Sync transaction logs, w którym wybierasz jedno z połączeń, a plugin pobiera nowe transakcje od tego operatora.
Export history — otwiera okno Export transaction history (patrz niżej).

Akcja w wierszu: Show details — otwiera okno z pełnymi danymi transakcji od operatora (surowe pola).

Rozpoznawane typy transakcji to między innymi Order amount, Commission fee, Refund order amount, Refund commission fee, Shipping amount, Refund shipping amount, Payout, Manual credit i Manual invoice. Każdy operator może dodać własne.

Karta Export jobs

Pokazuje uruchomione eksporty zbiorcze i ich status (Pending, Running, Completed, Error). Gdy eksport się zakończy, w wierszu pojawia się akcja Download.

Co jest zapisywane

Dla każdej transakcji plugin zapisuje:

identyfikator transakcji u operatora,
Type (etykieta tekstowa, której używa operator — rozpoznawane kody widać w filtrze Transaction type),
datę transakcji,
kwotę i walutę,
powiązane zamówienie Mirakl (puste przy transakcjach niepowiązanych z konkretnym zamówieniem, np. miesięczne opłaty),
pełne dane od operatora, dostępne przez Show details.

Synchronizacja w tle

Plugin pobiera nowe transakcje z każdego połączenia zgodnie z harmonogramem. Domyślny interwał to raz na 24 godziny. Mirakl podaje miękki limit około 20 wywołań dziennie dla tego punktu API, dlatego nie warto schodzić poniżej 6 godzin.

Druga zadanie cykliczne uruchamia się co minutę i sprawdza status uruchomionych eksportów zbiorczych — gdy się zakończą, na karcie Export jobs pojawia się akcja Download.

Pierwszy import

Gdy po raz pierwszy włączasz import zamówień dla połączenia, plugin uzupełnia wszystkie transakcje w oknie pierwszego importu. Dla kont z wieloletnią historią ustaw w kreatorze niedawną datę pierwszego importu, żeby nie pobierać milionów starych wierszy.

Eksport zbiorczy

Gdy potrzebujesz więcej historii, niż obejmuje normalna synchronizacja (na przykład wszystkie prowizje za dany kwartał na potrzeby zamknięcia roku), użyj akcji Export history:

Kliknij Export history na stronie Transaction Logs. Otwiera się okno Export transaction history.
Wybierz Connection, From date i To date.
Opcjonalnie wpisz wartość w Transaction type filter (na przykład konkretny kod typu) — zostaw puste dla wszystkich typów.
Kliknij Start export.

Zadanie zostaje dodane do karty Export jobs ze statusem Pending. Plugin w tle odpytuje operatora, a gdy eksport jest gotowy, w wierszu pojawia się akcja Download. Wynikiem jest pojedynczy plik CSV wygenerowany po stronie operatora.

Konfiguracja

Otwórz Mirakl → Settings, zakładka Sync, karta Invoicing & Transaction Logs Sync:

Enable Transaction Log Sync (TL02) — domyślnie wyłączone.
Transaction Log Sync Interval — jak często pobierać nowe transakcje. Wartości 6 / 12 / 24 godziny. Domyślnie 24 godziny.
Transaction Log Export Poll Interval — jak często sprawdzać status eksportów zbiorczych. Wartości 30 sekund / 1 minuta / 5 minut. Domyślnie 1 minuta.

Wskazówki

Powiązane tematy

Invoices — zagregowany widok tych transakcji
Order import
Sync logs
Background tasks