Przeglądanie historii księgowań ERP
Gdy przepływ pracy księguje do ERP — przez krok Księgowanie dokumentów (zobacz Księgowanie dokumentów w systemach ERP) lub przez własny krok księgowania systemu, taki jak zapis dziennika lub ręczny czek Sage 100, zapis dziennika Sage Intacct lub NetSuite, dokument Acumatica, Business Central lub Xero, zapis dziennika Dynamics 365 Finance & Operations, Oracle Fusion, Workday Financials lub SAP S/4HANA Cloud albo dokument SAP — PlaidCloud zapisuje każdą próbę księgowania w trwałym rejestrze dla każdego tenanta, dzięki czemu ten sam dokument nigdy nie zostanie zaksięgowany dwukrotnie. ERP Post History to widok tylko do odczytu nad tym rejestrem: każda próba i jej bieżący stan, z własnym numerem dokumentu ERP i znacznikami czasu, z filtrowaniem według projektu.
Uzupełnia on tabelę wyników dla poszczególnych uruchomień, którą zapisuje krok księgowania: tabela wyników to wyniki jednego uruchomienia, a Post History to trwały zapis ze wszystkich uruchomień i przepływów pracy, który śledzi każde księgowanie przez cały cykl życia, zamiast zamrażać je w chwili zakończenia uruchomienia.
Co pokazuje każde księgowanie
Dział zatytułowany „Co pokazuje każde księgowanie”Każdy wiersz to jeden dokument zaksięgowany (lub próbowany) do jednego środowiska ERP na jednym połączeniu:
| Pole | Znaczenie |
|---|---|
ledger_id |
Identyfikator wiersza w rejestrze. |
project_id |
Projekt, z którego wykonano księgowanie. |
connection_id |
Użyte połączenie ERP. |
environment_id |
Środowisko połączenia, do którego księgowano (na przykład piaskownica a produkcja). |
natural_key |
Klucz biznesowy dokumentu, wyznaczony przez krok księgowania. |
mode |
live dla prawdziwego księgowania, simulate dla tego, co zaksięgowałoby uruchomienie symulowane. |
state |
Bieżący stan cyklu życia księgowania (zobacz niżej). |
confirmation_id |
Własny numer dokumentu ERP, gdy ERP go przypisze. Nigdy nie jest ustawiony dla księgowania symulowanego. |
run_id |
Uruchomienie przepływu pracy, które wykonało księgowanie. |
submitted_at, created_at, updated_at |
Kiedy księgowanie zostało przesłane, po raz pierwszy zapisane i ostatnio zmienione. |
Księgowanie wykonane w trybie symulacji ma mode równe simulate, co pozwala odróżnić je od prawdziwego na pierwszy rzut oka — zobacz Księgowania symulowane poniżej.
Stany cyklu życia
Dział zatytułowany „Stany cyklu życia”Księgowanie przechodzi przez te stany, gdy ERP je przetwarza:
| Stan | Znaczenie |
|---|---|
preflighted |
Zwalidowane i zarezerwowane, jeszcze nie wysłane do ERP. |
submitted |
Wysłane do ERP; wynik nie jest jeszcze znany. |
pending |
Przyjęte do przetwarzania asynchronicznego; oczekuje na wynik końcowy. |
posted |
Potwierdzone jako zaksięgowane; confirmation_id zawiera numer dokumentu ERP. |
rejected |
ERP odrzucił księgowanie. |
in_doubt |
Nie udało się potwierdzić wyniku — człowiek musi sprawdzić bezpośrednio w ERP przed jakąkolwiek ponowną próbą. |
reversed |
Wcześniej zaksięgowany dokument został stornowany. |
Rejestr księgowań pokazuje te same księgowania we własnym, prostszym zestawie stanów.
Księgowania symulowane
Dział zatytułowany „Księgowania symulowane”Uruchomienie rozpoczęte w trybie symulacji waliduje to, co wysłałby krok księgowania, ale nigdy nie kontaktuje się z ERP. To, co zaksięgowałby krok księgowania, jest zapisywane tutaj, z mode równym simulate, abyś mógł je przeglądać tak samo jak prawdziwe księgowanie — wraz z jego natural_key — bez confirmation_id, ponieważ żaden ERP go nie widział.
Symulowane dokumenty kroku Księgowanie dokumentów są tutaj również zapisywane, z mode równym simulate, z wyjątkiem dokumentów dla systemu księgowanego przez agenta PlaidCloud (takiego jak SAP lokalny i Sage 100), które pojawiają się tylko w Rejestrze księgowań jako Zostałby zaksięgowany.
Wpis symulowany nigdy nie zajmuje ani nie blokuje miejsca, które chroni idempotentny zapis prawdziwego księgowania. Jeśli później uruchomisz ten sam dokument na żywo, prawdziwe księgowanie przebiegnie i zastąpi zapis symulowany. Obszar roboczy bez skonfigurowanego rejestru księgowań nadal normalnie waliduje uruchomienie symulowane — po prostu nic tu nie zapisuje.
Wyczyść symulowane wpisy projektu niezależnie od prawdziwych za pomocą DELETE /rest/v1/analyze/erp/write/history/simulated?project_id=<project> (opcjonalnie zawężone przez connection_id) lub narzędzia MCP erp_clear_simulated_postings z tymi samymi argumentami. W obu przypadkach usuwane są tylko wiersze symulowane — prawdziwe księgowanie nigdy nie jest dotykane. To samo czyszczenie usuwa też dokumenty uruchomień Księgowanie dokumentów w projekcie, które były wykonane w trybie Simulate, oraz własne kopie księgowań symulowanych w Rejestrze księgowań. Odpowiedź podaje cleared (wiersze historii i dokumenty uruchomień Simulate) oraz sims_cleared (kopie w Rejestrze).
Odczytywanie historii
Dział zatytułowany „Odczytywanie historii”Ograniczaj każdy odczyt do jednego projektu, do którego masz dostęp. Potrzebujesz dostępu do odczytu tego projektu — tego samego dostępu, którego wymaga reszta Twojej pracy w projekcie.
Przez REST
Dział zatytułowany „Przez REST”GET /rest/v1/analyze/erp/write/history?project_id=<project>Opcjonalne parametry zapytania zawężają wynik:
| Parametr | Efekt |
|---|---|
connection_id |
Tylko księgowania wykonane na tym połączeniu. |
state |
Tylko księgowania w tym stanie (na przykład state=in_doubt). |
mode |
live lub simulate. Bez tego parametru księgowania prawdziwe i symulowane są pokazywane razem. |
limit |
Rozmiar strony (domyślnie 100). |
cursor |
next_cursor z poprzedniej strony. |
Wyniki wracają od najnowszych. Gdy strona zapełni się do limit, odpowiedź zawiera next_cursor; przekaż go z powrotem jako cursor, aby odczytać następną stronę, i zatrzymaj się, gdy next_cursor jest null.
Przez MCP
Dział zatytułowany „Przez MCP”Wywołaj narzędzie erp_post_history z tymi samymi argumentami — project_id (wymagany) oraz opcjonalnymi connection_id, state, mode, limit i cursor. Zwraca te same wiersze, stronicowane w ten sam sposób.
Typowe przeglądy
Dział zatytułowany „Typowe przeglądy”- Wszystko, co nadal jest niepewne w projekcie:
state=in_doubt— księgowania do potwierdzenia ręcznie w ERP. - Co zaksięgowało konkretne uruchomienie: odczytaj historię projektu i dopasuj po
run_id. - Czy dokument faktycznie został zaksięgowany: znajdź jego wiersz i odczytaj
stateorazconfirmation_id.