Intégrer les engagements de dépense dans l'ERP

Objectif : transmettre à l'ERP les engagements de dépense validés ou disponibles dans Batis.

Parcours cible

1. Écouter le webhook lié aux contrats.
2. À réception de l'événement, identifier le contrat concerné et son contexte.
3. Appeler l'endpoint adapté pour récupérer les détails du document.
4. Rapprocher l'opération, l'entreprise et les références du système d'information tiers via le catalogue.
5. Créer ou mettre à jour l'engagement de dépense dans l'ERP.
6. Stocker le résultat d'intégration pour permettre les reprises.

Récupération des détails

Le webhook sert de déclencheur. Il ne remplace pas l'appel API de lecture : après réception, l'intégration appelle l'endpoint document avec les filtres utiles pour récupérer les informations à jour.

Exemples :

GET /document?type=st-contract&folderId={folderId}
GET /document?type=st-amendment&folderId={folderId}
GET /document?type=command-leading-contract&folderId={folderId}
GET /document?type=command-with-no-contract&folderId={folderId}

Le type exact dépend de la nature du contrat à intégrer. Les données retournées permettent ensuite de construire l'engagement dans le système cible.

Concepts impliqués

• documents ;
• dossiers ;
• catalogue ;
• webhooks.

Points d'attention

• Les références du système d'information tiers doivent être synchronisées avant l'intégration.
• Les statuts Batis doivent être convertis vers les statuts ERP.
• Les rejets ERP doivent être historisés et rejouables.