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.
Contenu vérifié le 22 septembre 2026.
Type, référence et périmètre de contrôle
Le contrat d’intégration FacturX API accepte le code 381 pour un avoir. Ce code ne justifie pas d’inverser tous les montants : vérifiez la convention du format et l’opération réelle. La référence à une facture précédente appartient au groupe BG-3 ; son exigence dépend du cas et du profil, notamment des règles France CTC appliquées. Quand cette référence est fournie, BR-55 exige son identifiant BT-25. Une validation du XML ne décide ni de la justification fiscale de l’avoir ni de son acceptation par une PA.
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 les erreurs de type ou de profil relevées par les contrôles exécutés ; la nature métier du document reste à vérifier dans l’ERP. | 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. | Signaler les incohérences arithmétiques détectées ; une réparation ou une génération est une opération distincte du scan. | 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. | Signaler la référence manquante si le profil ou la cible exécutée l’exige. | 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é. | Restituer les contrôles exécutés ; leur résultat ne suffit pas à désigner la version métier faisant autorité. | Une source structurée à jour si le PDF et le XML sont contradictoires. |
Ce que FacturX API peut clarifier
Le scan distingue les erreurs détectées et les contrôles non évalués. Pour générer un nouveau fichier,
invoice_data
fournit une source structurée complète à
/convert, pas quelques champs isolés.
Les compléments documentaires utilisent les champs prévus par le contrat, notamment
invoice_patch.
Un candidat généré et revalidé ne rend pas rétroactivement valide le fichier soumis.
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.