Aller au contenu principal

Cycle de vie et statuts

Une facture possède un cycle de vie métier qui évolue indépendamment du traitement purement technique du fichier.

C'est l'une des distinctions les plus importantes à comprendre avant d'intégrer le Flow Service.

Deux niveaux de statut​

Statut technique​

Le statut technique indique le résultat du traitement du flux par la plateforme :

  • la requête a-t-elle été acceptée ?
  • le document a-t-il pu être traité ?
  • les contrôles techniques ont-ils abouti ?

Un 202 Accepted indique par exemple que le dépôt a été accepté pour traitement asynchrone.

L'acquittement technique ultérieur fournit le résultat des contrôles du flux.

Statut métier​

Le statut métier décrit ce qui arrive à la facture dans son cycle de traitement :

  • mise à disposition ;
  • prise en charge ;
  • approbation ou refus ;
  • litige ;
  • paiement ;
  • encaissement ;
  • autres événements applicables au scénario.

Ces événements sont transportés séparément de la facture.

Le rôle du CDAR​

Le CDAR est un document XML utilisé pour transmettre un événement de cycle de vie associé à une facture.

Il ne transporte pas la facture elle-même.

Facture
   ↓
événement métier dans l'ERP
   ↓
CDAR
   ↓
POST /v1/flows
   ↓
événement transmis dans l'écosystème

Qui émet un statut ?​

Tous les statuts ne sont pas produits par le même acteur.

Selon l'événement, le rôle attendu peut appartenir à l'émetteur de la facture, à son destinataire ou à la plateforme.

L'intégration doit donc vérifier la cohérence entre le rôle de l'organisation qui publie un événement et la nature du statut envoyé.

Ne pas déduire un statut métier d'un succès technique

Un code HTTP de succès ou un acquittement technique positif ne signifie pas que la facture a été approuvée, payée ou encaissée.

Suivre une facture​

Pour réconcilier correctement le cycle de vie :

  1. conservez le flowId des flux ;
  2. conservez votre identifiant métier de corrélation lorsque vous en utilisez un ;
  3. recherchez les nouveaux flux de manière différentielle ;
  4. distinguez les factures des flux de cycle de vie ;
  5. rattachez les événements métier à la facture concernée ;
  6. conservez l'ordre chronologique des événements.

➡️ Factures et cycle de vie — API
➡️ Publier un statut CDAR
➡️ Exemples fonctionnels des neuf statuts CDAR
➡️ Acquittements et erreurs