Aller au contenu

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.

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.

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.

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).

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.

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.

  • 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 state et confirmation_id.