Scénarios d'intégration e-Invoicing et checklist
Cette page concerne les scénarios e-Invoicing : émission et réception de factures, suivi des statuts et points de contrôle d'intégration.
Émission d'une facture
Avant l'envoi d'une facture, l'ERP ou la Solution Compatible détermine l'adressage destinataire via Directory Service, puis dépose le flux via Flow Service.
Réception d'une facture entrante
Le SI appelant :
- recherche les flux entrants disponibles ;
- récupère les métadonnées ;
- récupère le document original ou la représentation disponible ;
- conserve les identifiants nécessaires à la corrélation.
Suivi des statuts
Deux niveaux doivent être distingués :
- statut technique du flux : résultat des contrôles et de l'intégration technique ;
- statut métier de la facture : porté par les flux de cycle de vie associés.
Un succès HTTP ou un acquittement technique positif ne permet pas, à lui seul, de déduire le statut métier final de la facture.
Checklist projet
- Les credentials sont séparés par environnement et stockés dans un coffre de secrets.
-
tenantSlug,Organization-Id,legalUnitId,onboardingRequestId,apiAccessId,clientId,flowIdettrackingIdsont conservés lorsque pertinents. - La révélation ou rotation d'un secret n'est déclenchée qu'au bon moment opérationnel.
- Le lookup Directory Service est réalisé avant émission lorsque l'adressage doit être déterminé ou vérifié.
- Le suivi asynchrone et le polling respectent les règles de résilience.
- Les réponses
429 Too Many Requestssont traitées avec temporisation et backoff. - Les erreurs HTTP immédiates sont distinguées des rejets métier asynchrones.
- Le parcours standard utilise l'onboarding de la Tenant Public API.
- Les opérations historiques MANUAL ne sont utilisées qu'en SANDBOX et uniquement lorsqu'elles sont autorisées.
- Les statuts techniques sont distingués des flux de cycle de vie métier.
e-Reporting
La disponibilité de l'e-Reporting doit être vérifiée dans le Swagger/OpenAPI SANDBOX et dans la documentation publiée pour cet environnement.