Type de document incohérent
Le document ressemble à un avoir, mais le code ou le profil indique encore une facture standard.
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.
Les blocages fréquents sur un avoir
Référence de facture absente
Le lien vers la facture corrigée manque ou n’est pas exploitable par le système destinataire.
Montants et TVA inversés
Le signe des montants, la base taxable et la TVA ne suivent pas toujours la même convention selon les exports ERP.
Contexte France incomplet
Endpoint électronique, mentions ou données de routage peuvent manquer pour le parcours France 2026.
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.
Le document ressemble à un avoir, mais le type reste celui d’une facture.
- Cause possible
- Le code document, le profil ou le contexte métier n’a pas été adapté lors de l’export ERP.
- Donnée à vérifier
- Type de document, référence à la facture initiale, sens des montants.
- Ce que FacturX API peut faire
- Signaler l’incohérence et guider le champ à corriger.
- Ce que l’ERP doit fournir
- 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.
- Cause possible
- Convention de signe différente entre l’ERP, le PDF visuel et le XML CII.
- Donnée à vérifier
- Montant HT, TVA, TTC, base taxable et signe attendu par ligne.
- Ce que FacturX API peut faire
- Détecter les incohérences arithmétiques et appliquer seulement les corrections déterministes.
- Ce que l’ERP doit fournir
- La convention métier retenue quand le fichier source ne suffit pas.
La référence de facture initiale est absente ou inexploitable.
- Cause possible
- L’avoir a été généré hors du flux de facture initiale ou sans lien structuré.
- Donnée à vérifier
- Identifiant de la facture corrigée, date, motif et relation documentaire.
- Ce que FacturX API peut faire
- Remonter la donnée manquante dans le diagnostic.
- Ce que l’ERP doit fournir
- 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.
- Cause possible
- Données de routage, endpoint électronique ou mentions spécifiques absentes.
- Donnée à vérifier
- Données destinataire, routage, contexte France CTC si applicable.
- Ce que FacturX API peut faire
- Séparer le résultat EN16931 du contexte France 2026.
- Ce que l’ERP doit fournir
- 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.
- Cause possible
- Export manuel, régénération partielle ou XML embarqué obsolète.
- Donnée à vérifier
- Numéro, dates, parties, totaux, lignes et profil déclaré.
- Ce que FacturX API peut faire
- Comparer les couches lisibles et indiquer la source la plus fiable quand elle est présente.
- Ce que l’ERP doit fournir
- Une source structurée à jour si le PDF et le XML sont contradictoires.
La correction saine : diagnostic puis données structurées
Ne demandez pas à vos utilisateurs de modifier un export XML à la main. Le modèle produit FacturX API
est plus propre : le scan indique les champs manquants ou incohérents, puis votre ERP fournit les
compléments dans invoice_data
JSON au moment de l’appel /convert.
Quand une correction est déterministe, elle peut être automatisée et tracée. Quand elle dépend d’une décision métier, FacturX API doit la signaler clairement au lieu de l’inventer.
À ne pas promettre
- • 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 ;
- • pas de statut légal final affiché par le validateur.
Parcours recommandé
-
Étape 1
Scanner l’avoir
Identifier les couches qui passent et celles qui bloquent : PDF, XML, EN16931, France CTC, absence de soumission PA.
-
Étape 2
Lire les champs demandés
Conserver uniquement les compléments utiles au cas réel, sans redemander les informations déjà extraites.
-
Étape 3
Appeler /convert avec invoice_data
Envoyer le PDF ou XML source avec les données structurées ERP qui manquent au fichier initial.
-
Étape 4
Contrôler le résultat généré
Relancer les contrôles techniques et intégrer le fichier dans votre parcours PA/SC sans présumer l’acceptation finale.
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.