Consulter l'historique des comptabilisations ERP
Lorsqu’un workflow comptabilise dans un ERP (via l’étape Comptabiliser des documents, consultez Comptabiliser des documents dans les systèmes ERP, ou via l’étape de comptabilisation propre à un système, par exemple une écriture de journal ou un chèque manuel Sage 100, une écriture de journal Sage Intacct ou NetSuite, un document Acumatica, Business Central ou Xero, une écriture de journal Dynamics 365 Finance & Operations, Oracle Fusion, Workday Financials ou SAP S/4HANA Cloud, ou un document SAP), PlaidCloud enregistre chaque tentative de comptabilisation dans un registre durable propre au locataire, afin que le même document ne soit jamais comptabilisé deux fois. L’historique des comptabilisations ERP est la vue en lecture seule de ce registre : chaque tentative et son état en direct, avec le numéro de document et les horodatages propres à l’ERP, filtrable par projet.
Il complète la table de résultat par exécution qu’écrit une étape de comptabilisation : la table de résultat contient les résultats d’une seule exécution, tandis que l’historique des comptabilisations est l’enregistrement permanent de toutes les exécutions et de tous les workflows, et suit chaque comptabilisation tout au long de son cycle de vie complet au lieu de la figer au moment où l’exécution s’est terminée.
Ce que montre chaque comptabilisation
Section intitulée « Ce que montre chaque comptabilisation »Chaque ligne correspond à un document comptabilisé (ou dont la comptabilisation a été tentée) dans un environnement ERP sur une connexion :
| Champ | Signification |
|---|---|
ledger_id |
L’identifiant de la ligne dans le registre. |
project_id |
Le projet depuis lequel la comptabilisation a été effectuée. |
connection_id |
La connexion ERP utilisée. |
environment_id |
L’environnement de la connexion dans lequel la comptabilisation a eu lieu (par exemple test ou production). |
natural_key |
La clé métier du document, telle que l’étape de comptabilisation l’a déterminée. |
mode |
live pour une comptabilisation réelle, simulate pour ce qu’une exécution simulée aurait comptabilisé. |
state |
L’état actuel du cycle de vie de la comptabilisation (voir ci-dessous). |
confirmation_id |
Le numéro de document propre à l’ERP, une fois que l’ERP en attribue un. Jamais renseigné pour une comptabilisation simulée. |
run_id |
L’exécution du workflow qui a effectué la comptabilisation. |
submitted_at, created_at, updated_at |
Quand la comptabilisation a été soumise, enregistrée pour la première fois et modifiée pour la dernière fois. |
Une comptabilisation effectuée en mode Simulation porte le mode simulate, ce qui la distingue d’un coup d’œil d’une comptabilisation réelle ; consultez Comptabilisations simulées ci-dessous.
Les états du cycle de vie
Section intitulée « Les états du cycle de vie »Une comptabilisation passe par ces états au fur et à mesure que l’ERP la traite :
| État | Signification |
|---|---|
preflighted |
Validée et réservée, pas encore envoyée à l’ERP. |
submitted |
Envoyée à l’ERP ; le résultat n’est pas encore connu. |
pending |
Acceptée pour un traitement asynchrone ; en attente d’un résultat final. |
posted |
Comptabilisation confirmée ; confirmation_id contient le numéro de document de l’ERP. |
rejected |
L’ERP a refusé la comptabilisation. |
in_doubt |
Le résultat n’a pas pu être confirmé : une personne doit vérifier directement dans l’ERP avant toute nouvelle tentative. |
reversed |
Un document précédemment comptabilisé a été extourné. |
Le Registre des écritures affiche ces mêmes comptabilisations avec son propre jeu d’états, plus simple.
Comptabilisations simulées
Section intitulée « Comptabilisations simulées »Une exécution lancée en mode Simulation valide ce qu’une étape de comptabilisation enverrait, mais ne contacte jamais l’ERP. Ce qu’une étape de comptabilisation aurait comptabilisé est enregistré ici, avec le mode simulate, afin que vous puissiez l’examiner comme une comptabilisation réelle, y compris sa natural_key, sans confirmation_id, puisqu’aucun ERP ne l’a jamais vue.
Les documents simulés d’une étape Comptabiliser des documents sont également enregistrés ici, avec le mode simulate, à l’exception de ceux d’un système comptabilisé via l’agent PlaidCloud (comme SAP sur site et Sage 100), qui n’apparaissent que dans le Registre des écritures sous Serait comptabilisé.
Une entrée simulée n’occupe ni ne bloque jamais l’emplacement qui protège l’écriture idempotente d’une comptabilisation réelle. Si vous exécutez ensuite le même document en réel, la comptabilisation réelle se déroule et remplace l’enregistrement simulé. Un espace de travail sans registre de comptabilisation configuré valide quand même normalement une exécution simulée ; il n’enregistre simplement rien ici.
Effacez les entrées simulées d’un projet indépendamment des entrées réelles avec DELETE /rest/v1/analyze/erp/write/history/simulated?project_id=<project> (éventuellement restreint avec connection_id), ou avec l’outil MCP erp_clear_simulated_postings et les mêmes arguments. Dans les deux cas, seules les lignes simulées sont supprimées (une comptabilisation réelle n’est jamais touchée). Le même effacement supprime aussi les documents des exécutions Comptabiliser des documents du projet qui se sont déroulées en mode Simulation, ainsi que les copies propres au Registre des écritures des comptabilisations simulées. La réponse indique cleared (lignes d’historique et documents des exécutions simulées) et sims_cleared (copies du Registre).
Lire l’historique
Section intitulée « Lire l’historique »Limitez chaque lecture à un projet auquel vous avez accès. Vous avez besoin d’un accès en lecture à ce projet, le même accès que celui qu’exige le reste de votre travail sur le projet.
Via REST
Section intitulée « Via REST »GET /rest/v1/analyze/erp/write/history?project_id=<project>Des paramètres de requête facultatifs restreignent le résultat :
| Paramètre | Effet |
|---|---|
connection_id |
Uniquement les comptabilisations effectuées sur cette connexion. |
state |
Uniquement les comptabilisations dans cet état (par exemple state=in_doubt). |
mode |
live ou simulate. Sans ce paramètre, les comptabilisations réelles et simulées s’affichent ensemble. |
limit |
Taille de la page (100 par défaut). |
cursor |
Le next_cursor de la page précédente. |
Les résultats sont renvoyés du plus récent au plus ancien. Lorsqu’une page atteint limit, la réponse contient un next_cursor ; renvoyez-le comme cursor pour lire la page suivante, et arrêtez-vous lorsque next_cursor est nul.
Appelez l’outil erp_post_history avec les mêmes arguments : project_id (obligatoire) et, facultativement, connection_id, state, mode, limit et cursor. Il renvoie les mêmes lignes, paginées de la même façon.
Revues courantes
Section intitulée « Revues courantes »- Tout ce qui est encore incertain pour un projet :
state=in_doubt— les comptabilisations à confirmer à la main dans l’ERP. - Ce qu’une exécution précise a comptabilisé : lisez l’historique du projet et filtrez sur
run_id. - Si un document a réellement été comptabilisé : trouvez sa ligne et lisez
stateetconfirmation_id.