Docs

1 Pour commencer1.3

1.3

Le parcours d’une facture

Une facture, de l’export ERP aux événements de statut.

  • Dans le bac à sable
  • Pas encore dans le bac à sable

En termes simples

Cette page suit une facture depuis l’ERP du client jusqu’à la liste des factures en échec. Ce qui compte pour l’entreprise : quand une facture est erronée, la réponse nomme le champ dans l’export du client et indique qui le corrige, avant tout envoi. Dans le bac à sable hébergé, la dernière étape n’a pas encore de connexion à un pays.

Une facture, de l’export de l’ERP à la liste de suivi. La fiche jaune est la réponse qui nomme le champ dans l’export du client. Le cadre en pointillés est le réseau. Le bac à sable hébergé n’en a encore aucun de configuré.

Le parcours d’une factureHuit étapes, de l’export ERP à la liste de suivi. Après les règles du canal, la réponse est 202 avec un identifiant, ou 422 avec un code du catalogue. L’étape du réseau envoie la facture là où un canal a un identifiant d’accès ; le bac à sable hébergé n’en a pas encore.1Export ERPBusiness Central,JSON ou XML2EntréeAPI ou dépôt de fichier3Contrôle du schémaModèle de facture canonique4Règles du canalKoSIT, Schematron,schéma FA(3)202 + identifiant5File d’attenteVoie rapide : KSeF, Peppol,France, AllemagneVoie lente : ANAFrésultat de l’adaptateur6RéseauEnvoie là où un réseau est relié7Événements de statutUn par étape, dans l’ordrerejet définitif8Liste de suiviRejets définitifs422Code cataloguenomme le champretour à l’intégrateur
  1. La facture quitte l’ERP du client sous forme d’export d’ERP (Business Central ou SAP Business One), de JSON canonique ou de fichier XML finalisé.
  2. Elle arrive par POST /invoices, POST /invoices/xml ou un fichier dans le dossier de dépôt.
  3. Le modèle canonique contrôle la structure. Un échec nomme le champ.
  4. Les validateurs propres au canal s’exécutent : KoSIT pour l’Allemagne, Schematron pour Peppol, la France et la Roumanie, le schéma FA(3) pour la Pologne. La réponse est 202 avec un identifiant, ou 422 avec un code du catalogue qui nomme le champ, indique qui agit et donne une indication de correction.
  5. Une facture qui passe les contrôles attend dans une file d’attente. KSeF, Peppol, la France et l’Allemagne partagent la voie rapide. L’ANAF a sa propre voie lente.
  6. Un canal doté d’un identifiant d’accès au réseau envoie la facture. L’Allemagne n’a pas de réseau : sa facture s’arrête à ready et l’intégrateur livre le fichier. Un canal sans identifiant d’accès, comme aujourd’hui sur le bac à sable hébergé, n’envoie rien.
  7. Chaque résultat devient un événement de statut, conservé dans l’ordre. Voir statuts.
  8. Un rejet définitif arrive sur la liste de suivi. Les échecs temporaires donnent lieu à de nouvelles tentatives, et n’y arrivent que lorsque celles-ci sont épuisées.

Remarque

Un fichier XML finalisé prend un raccourci. Il passe un contrôle de sécurité et les validateurs du canal (étape 4), mais ni contrôle canonique ni mapping, et rejoint la file d’attente à l’étape 5.

POST /validate n’exécute que les étapes 3 et 4. Il ne stocke rien, n’envoie rien et répond toujours 200 avec un rapport. Voir essai à blanc.