Codes d'Erreur XRechnung : Guide Complet de Dépannage 2025
Dans ce guide des erreurs :
Comprendre la Validation XRechnung et les Codes d'Erreur
La validation XRechnung s'effectue à plusieurs niveaux : validation du schéma, règles métier (BR) et règles spécifiques à l'Allemagne (BR-DE). Comprendre ces codes d'erreur vous aide à identifier et corriger rapidement les problèmes avant la soumission.
Les codes d'erreur suivent un format structuré :
- BR-XX : Règles métier standard européennes de la norme EN 16931
- BR-DE-XX : Règles métier spécifiques à l'Allemagne
- Erreurs de schéma : Violations de structure et de syntaxe XML
- Erreurs de validation : Problèmes de cohérence des données et de calcul
Erreurs de Règles Métier (BR) - Norme Européenne
BR-01 : Numéro de Facture Requis
Message d'erreur : "Une facture doit avoir un numéro de facture (BT-1)."
Cause : Numéro de facture manquant
Solution : Ajouter un numéro de facture unique dans le champ BT-1
Exemple : <cbc:ID>RE-2025-001234</cbc:ID>
BR-02 : Date d'Émission de la Facture Requise
Message d'erreur : "Une facture doit avoir une date d'émission (BT-2)."
Cause : Date de facture manquante ou invalide
Solution : Ajouter la date d'émission au format AAAA-MM-JJ
Exemple : <cbc:IssueDate>2025-01-16</cbc:IssueDate>
BR-04 : Code de Type de Facture Requis
Message d'erreur : "Une facture doit avoir un code de type de facture (BT-3)."
Cause : Spécification du type de facture manquante
Solution : Ajouter le code de type (380 pour facture, 381 pour avoir)
Exemple : <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
BR-16 : Montant Net de Ligne Requis
Message d'erreur : "Une ligne de facture doit avoir un montant net de ligne (BT-131)."
Cause : Montant net manquant pour la ligne de facture
Solution : S'assurer que chaque ligne a quantité × prix unitaire = montant net de ligne
BR-45 : Catégorie de TVA Requise
Message d'erreur : "Chaque ventilation de TVA doit avoir un code de catégorie de TVA (BT-118)."
Cause : Catégorie de TVA manquante dans la ventilation fiscale
Solution : Ajouter le code de catégorie de TVA approprié (S, AA, Z, E, etc.)
BR-49 : Moyen de Paiement Requis
Message d'erreur : "Une instruction de paiement doit spécifier le code de type de moyen de paiement (BT-81)."
Cause : Spécification de la méthode de paiement manquante
Solution : Ajouter le code de moyen de paiement (30=virement, 59=SEPA)
Erreurs Spécifiques à l'Allemagne (BR-DE)
BR-DE-1 : Leitweg-ID Requis
Message d'erreur : "L'élément 'Référence acheteur' (BT-10) doit être transmis (Leitweg-ID)."
Cause : Leitweg-ID manquant ou incorrect pour les factures B2G
Solution : Ajouter le Leitweg-ID exact fourni par l'autorité publique
Critique : Doit correspondre exactement, y compris les traits d'union et la casse
BR-DE-2 : Adresse Électronique du Vendeur Requise
Message d'erreur : "L'élément 'Adresse électronique du vendeur' (BT-34) doit être transmis."
Cause : ID de point de terminaison électronique du vendeur manquant
Solution : Ajouter un identifiant PEPPOL ou une adresse e-mail comme point de terminaison
Exemple : DE:VAT:DE123456789 ou facture@entreprise.de
BR-DE-16 : Numéro de TVA Requis pour Certains Codes Fiscaux
Message d'erreur : "Dans la facture, au moins l'un des éléments 'Identifiant TVA du vendeur' (BT-31) ou 'Identifiant d'enregistrement fiscal du vendeur' (BT-32) doit être transmis."
Cause : Utilisation des codes fiscaux S, Z, E, AE, K, G, L ou M sans numéro de TVA
Solution : Ajouter l'identifiant TVA du vendeur (USt-IdNr.)
Format : DE123456789 (code pays + numéro)
BR-DE-19 : Conditions de Paiement pour l'Escompte
Message d'erreur : "Les conditions de paiement (BT-20) doivent spécifier les conditions d'un escompte."
Cause : Offre d'escompte sans conditions appropriées
Solution : Inclure le pourcentage et la période d'escompte dans les conditions de paiement
Exemple : "#SKONTO#TAGE=14#PROZENT=2.00#"
Erreurs de Validation de Schéma
Structure XML Invalide
Erreur : "Le contenu de l'élément 'Invoice' n'est pas complet"
Cause : Éléments XML requis manquants ou ordre incorrect
Solution : S'assurer que tous les éléments obligatoires sont présents dans le bon ordre
- Vérifier les déclarations d'espaces de noms
- Vérifier que l'ordre des éléments correspond au schéma
- S'assurer qu'il n'y a pas de balises de fermeture manquantes
Type de Données Invalide
Erreur : "Un contenu invalide a été trouvé commençant par l'élément"
Cause : Type de données incorrect (par ex., texte dans un champ numérique)
Solution : S'assurer des types de données corrects :
- Montants : Décimal avec max 2 décimales
- Dates : Format AAAA-MM-JJ
- Codes : Uniquement les valeurs de liste de codes valides
Erreurs d'Espace de Noms
Erreur : "Impossible de trouver la déclaration de l'élément"
Cause : Déclarations d'espaces de noms manquantes ou incorrectes
Solution : Vérifier les espaces de noms corrects pour la syntaxe UBL ou CII
UBL : xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
Erreurs de Calcul et de Logique
BR-CO-10 : Erreur de Somme des Montants de Ligne
Erreur : "Somme des montants nets de ligne = Montant total de la facture hors TVA"
Cause : Les lignes ne totalisent pas le sous-total
Solution : Recalculer : La somme de tous les montants nets de ligne doit égaler le sous-total de la facture
Vérifier : Σ(Montants de ligne) = Sous-total de la facture
BR-CO-14 : Erreur de Calcul de TVA
Erreur : "Montant total de TVA de la facture = Σ Montants de taxe par catégorie de TVA"
Cause : Les calculs de TVA ne correspondent pas
Solution : S'assurer que la TVA est calculée correctement pour chaque catégorie
Formule : Montant imposable × Taux de TVA = Montant de TVA
BR-CO-15 : Erreur de Total de Facture
Erreur : "Montant total de la facture avec TVA = Montant total hors TVA + Total TVA de la facture"
Cause : Calcul du total général incorrect
Solution : Vérifier : Sous-total + Total TVA = Total général
Erreurs de Format et de Type de Données
Erreurs de Format de Date
Problèmes Courants :
- Format incorrect : Doit être AAAA-MM-JJ (pas JJ.MM.AAAA)
- Dates invalides : Vérifier les dates impossibles (par ex., 2025-13-32)
- Zéros initiaux manquants : Utiliser 2025-01-05, pas 2025-1-5
Erreurs de Format de Montant
Problèmes Courants :
- Séparateur décimal : Utiliser un point (.) et non une virgule (,)
- Décimales : Maximum 2 pour les montants monétaires
- Montants négatifs : Utiliser le signe moins, pas de parenthèses
Correct : 1234.56 | Incorrect : 1.234,56
Erreurs de Liste de Codes
Problèmes Courants :
- Devise invalide : Utiliser les codes ISO 4217 (EUR, USD, GBP)
- Pays invalide : Utiliser ISO 3166-1 Alpha-2 (DE, FR, IT)
- Unité invalide : Utiliser les codes UN/ECE Recommandation 20
Erreurs de Routage et de Transmission
Leitweg-ID Introuvable
Erreur : "Le Leitweg-ID n'a pas pu être attribué"
Cause : Leitweg-ID inconnu ou inactif
Solution :
- Vérifier le Leitweg-ID avec le destinataire
- Vérifier les fautes de frappe (sensible à la casse !)
- S'assurer que l'ID est toujours actif
Taille de Fichier Dépassée
Erreur : "Taille de fichier maximale dépassée"
Cause : Fichier de facture trop volumineux (généralement >15 Mo)
Solution :
- Supprimer les pièces jointes intégrées
- Envoyer les pièces jointes séparément
- Optimiser la structure du fichier
Étapes de Dépannage
Dépannage Étape par Étape
-
Utiliser les Validateurs Officiels
- Validateur KoSIT pour la conformité XRechnung
- Validateurs spécifiques au portail
-
Vérifier la Hiérarchie des Erreurs
- Corriger d'abord les erreurs de schéma
- Puis les violations de règles métier
- Enfin les erreurs de calcul
-
Valider par Rapport aux Exemples
- Comparer avec des exemples fonctionnels
- Utiliser les cas de test officiels
-
Tester avec une Facture Minimale
- Commencer uniquement avec les champs obligatoires
- Ajouter progressivement les champs optionnels
Corrections Rapides Courantes
- ✓ Vérifier le Leitweg-ID caractère par caractère
- ✓ S'assurer que toutes les dates utilisent le format AAAA-MM-JJ
- ✓ Vérifier manuellement les calculs de TVA
- ✓ Vérifier les codes de devise et de pays
- ✓ Valider que le vendeur a une adresse électronique
- ✓ Confirmer le numéro de TVA lors de l'utilisation de catégories imposables
Évitez les Erreurs de Validation avec Notre Convertisseur
Notre convertisseur XRechnung valide automatiquement votre facture et fournit des messages d'erreur clairs avec des solutions :
- Validation en temps réel lors de la saisie des données
- Explications d'erreur claires en langage simple
- Vérification automatique des calculs
- Conformité de format garantie
🚀 Prêt à convertir vos factures ?
Commencez dès aujourd’hui à convertir des factures PDF en XRechnung, ZUGFeRD et autres formats. Essai gratuit de 3 jours inclus.