Corriger
Quand l’erreur est arithmétique, structurelle ou déductible sans ambiguïté.
Avoir Factur-X
Un avoir Factur-X invalide n’est pas un simple problème de PDF
Les avoirs concentrent plusieurs sources d’erreur : type de document, référence à la facture initiale, montants négatifs ou inversés, TVA, dates et données de routage. Le bon réflexe est de diagnostiquer le fichier, puis de corriger uniquement ce qui est déterministe ou fourni par votre ERP.
La décision à prendre avant correction
Un avoir invalide n’appelle pas toujours une réparation automatique. Il faut d’abord savoir si l’information existe dans le fichier ou si elle doit revenir de l’ERP.
Compléter
Quand la référence, le motif ou une donnée de routage doit être fourni par la source métier.
Escalader
Quand le PDF, le XML et l’ERP ne racontent pas le même événement de facturation.
Diagnostiquer sans inventer la donnée métier
Les exemples ci-dessous sont volontairement génériques. Ils montrent comment répartir le travail entre le diagnostic FacturX API et la source ERP quand une information manque.
| Symptôme | Cause possible | Donnée à vérifier | Ce que FacturX API peut faire | Ce que l’ERP doit fournir |
|---|---|---|---|---|
| Le document ressemble à un avoir, mais le type reste celui d’une facture. | Le code document, le profil ou le contexte métier n’a pas été adapté lors de l’export ERP. | Type de document, référence à la facture initiale, sens des montants. | Signaler l’incohérence et guider le champ à corriger. | La nature exacte du document et la référence métier de l’avoir. |
| Les montants ou la TVA sont inversés selon les lignes. | Convention de signe différente entre l’ERP, le PDF visuel et le XML CII. | Montant HT, TVA, TTC, base taxable et signe attendu par ligne. | Détecter les incohérences arithmétiques et appliquer seulement les corrections déterministes. | La convention métier retenue quand le fichier source ne suffit pas. |
| La référence de facture initiale est absente ou inexploitable. | L’avoir a été généré hors du flux de facture initiale ou sans lien structuré. | Identifiant de la facture corrigée, date, motif et relation documentaire. | Remonter la donnée manquante dans le diagnostic. | La référence source ; FacturX API ne doit pas l’inventer. |
| Le fichier passe une partie des contrôles mais bloque sur le contexte France. | Données de routage, identifiants de routage ou mentions spécifiques absents. | Données destinataire, routage, contexte France CTC si applicable. | Séparer le résultat EN16931 du contexte France 2026. | Les données de routage et de contexte qui ne sont pas dans le fichier. |
| Le PDF et le XML ne racontent pas exactement la même facture. | Export manuel, régénération partielle ou XML embarqué obsolète. | Numéro, dates, parties, totaux, lignes et profil déclaré. | Comparer les couches lisibles et indiquer la source la plus fiable quand elle est présente. | Une source structurée à jour si le PDF et le XML sont contradictoires. |
Ce que FacturX API peut clarifier
Le scan indique les champs manquants ou incohérents. Ensuite, votre ERP peut fournir les
compléments dans invoice_data
au moment de l’appel /convert.
Les corrections automatisées restent limitées aux cas déterministes.
Ce que ça ne doit pas masquer
- • pas de reconstruction fiscale sans source ERP ;
- • pas d’acceptation PA déduite du scan ;
- • pas de correction silencieuse d’un montant significatif ;
- • pas de référence de facture initiale inventée.
Et après ?
Traiter le cas proprement
Choisissez l'étape suivante pour activer FacturX API sur votre stack. Tous les liens sont internes pour garder le suivi clair.