← Retour à tous les articles

Erreurs de validation Peppol BIS 3.0 courantes et comment les corriger

SealDoc Team · · 8 min de lecture

Les échecs de validation Peppol BIS 3.0 tombent dans un ensemble prévisible de catégories. Les messages d’erreur référencent des codes de règles métier (BR-xx) et des numéros de termes métier (BT-xx) de la norme EN16931, dont la compréhension nécessite de consulter la spécification. Cet article associe les erreurs les plus courantes à leurs causes et fournit des corrections concrètes.

Tous les exemples utilisent la syntaxe UBL 2.1. Pour les équivalents CII, voir UBL vs CII.

BR-01 à BR-06 : champs d’en-tête obligatoires manquants

Ces règles imposent la présence des champs obligatoires de niveau supérieur. Elles échouent lorsqu’un élément est absent ou vide.

RègleChampBTCorrection
BR-01Identifiant de spécificationBT-24Ajouter CustomizationID avec l’URI Peppol BIS 3.0 exact
BR-02Numéro de factureBT-1Ajouter un élément ID non vide
BR-03Date d’émission de la factureBT-2Ajouter IssueDate au format AAAA-MM-JJ
BR-04Code de devise de la factureBT-5Ajouter DocumentCurrencyCode avec le code ISO 4217
BR-05Nom du vendeurBT-27Ajouter AccountingSupplierParty/Party/PartyName/Name
BR-06Nom de l’acheteurBT-44Ajouter AccountingCustomerParty/Party/PartyName/Name

La valeur de BT-24 : BR-01 vérifie uniquement que CustomizationID est présent. Une valeur erronée est détectée par la règle Peppol PEPPOL-EN16931-R004, qui est fatale : la valeur doit commencer par l’identifiant Peppol BIS 3.0 et ne doit pas contenir ::. Une erreur fréquente est l’URI de base EN16931. Une autre est le suffixe ::2.1, qui appartient à l’identifiant de type de document Peppol et non à CustomizationID :

Incorrect (base EN16931) :

<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>

Correct (Peppol BIS 3.0) :

<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>

R004 vérifie que la valeur commence par cet identifiant et ne contient pas ::. Voir l’introduction à Peppol BIS 3.0 pour comprendre pourquoi c’est important.

BR-CO-10 : la somme des montants de lignes ne correspond pas au total

[BR-CO-10]-Sum of Invoice line net amount (BT-106) = 
sum of Invoice line net amount (BT-131).

Cette règle exige que LegalMonetaryTotal/LineExtensionAmount (BT-106) soit égal à la somme de toutes les valeurs InvoiceLine/LineExtensionAmount (BT-131).

L’échec est presque toujours une erreur d’arrondi. Chaque montant net de ligne (BT-131) peut comporter au plus deux décimales (BR-DEC-23), donc chaque ligne est d’abord arrondie. BR-CO-10 compare ensuite BT-106 à la somme de ces montants de ligne arrondis. Si vous calculez BT-106 à partir des valeurs brutes non arrondies et n’arrondissez que le total, les deux peuvent différer d’un centime.

Incorrect (addition des valeurs brutes, arrondi du total une seule fois) :

// Line 1: 3 × 33.335 = 100.005, so BT-131 = 100.01
// Line 2: 3 × 33.335 = 100.005, so BT-131 = 100.01
// BT-106 from the raw sum: 200.01
// Sum of the line amounts (BT-131): 200.02, so BR-CO-10 fails

L’écart augmente avec le nombre de lignes dont le montant brut se termine par une fraction de centime.

Approche correcte : arrondir chaque montant net de ligne à deux décimales, puis additionner les montants arrondis :

var lineNetAmounts = invoiceLines
    .Select(l => Math.Round(l.Quantity * l.UnitPrice, 2, MidpointRounding.AwayFromZero))  // BT-131
    .ToList();
var lineNetTotal = lineNetAmounts.Sum();  // BT-106, already two decimals

BR-CO-14 : échec arithmétique du montant de TVA de la facture

[BR-CO-14]-Invoice total VAT amount (BT-110) = 
sum of VAT category tax amount (BT-117).

Le montant total de TVA dans TaxTotal/TaxAmount doit être égal à la somme des valeurs TaxTotal/TaxSubtotal/TaxAmount pour toutes les catégories fiscales.

Pour une facture à taux unique, cela semble trivial, mais des échecs se produisent lorsque :

  • Il y a plusieurs taux de TVA et TaxTotal/TaxAmount est calculé à partir du total global plutôt qu’à partir des montants par catégorie, chacun arrondi à deux décimales (BR-CO-17)
  • Le TaxSubtotal/TaxAmount d’une catégorie est absent ; chaque catégorie doit en avoir un, même 0.00 pour le taux zéro et l’exonération (BR-46, BR-Z-09, BR-E-09)
  • Le TaxAmount au niveau TaxTotal est calculé indépendamment des montants TaxSubtotal

Correction : calculer d’abord toutes les valeurs TaxSubtotal/TaxAmount, les additionner et utiliser cette somme comme valeur TaxTotal/TaxAmount. Ne pas calculer TaxTotal/TaxAmount séparément.

BR-CO-16 : montant dû au paiement

[BR-CO-16]-Amount due for payment (BT-115) = 
Invoice total with VAT (BT-112) - Paid amount (BT-113) + Rounding amount (BT-114).

Si BT-113 (montant payé) et BT-114 (montant d’arrondi) ne sont pas présents, cela se simplifie en BT-115 = BT-112. L’échec survient lorsque PayableAmount et TaxInclusiveAmount diffèrent de plus de la tolérance d’arrondi autorisée.

Cause courante : calculer PayableAmount à partir des montants de ligne arrondis et TaxInclusiveAmount à partir d’un calcul de total séparé qui produit un résultat légèrement différent.

Correction : calculer un total général canonique unique et l’utiliser à la fois pour TaxInclusiveAmount et PayableAmount.

BR-S-08 et BR-S-09 : cohérence du taux et du montant de TVA

[BR-S-08]-For each different value of VAT category rate (BT-119) where the 
VAT category code (BT-118) is "S", the VAT category taxable amount (BT-116) 
in a VAT breakdown (BG-23) shall equal the sum of Invoice line net amounts 
(BT-131) where the VAT category code of the Invoice line (BT-151) is "S" 
and the VAT rate for the Invoice line (BT-152) equals the VAT category rate.

Cette règle regroupe toutes les lignes par taux de TVA et vérifie que le montant imposable dans chaque TaxSubtotal correspond à la somme des lignes à ce taux. Elle échoue lorsque :

  • Une ligne a un taux de TVA sans TaxSubtotal correspondant
  • Un TaxSubtotal existe pour un taux mais aucune ligne n’utilise ce taux
  • Les différences d’arrondi s’accumulent entre les calculs au niveau des lignes et des sous-totaux

Correction : construire les éléments TaxSubtotal dynamiquement à partir des lignes, en regroupant par (code de catégorie TVA, taux TVA), plutôt que de les construire indépendamment.

BR-E-01 / BR-AE-01 : autoliquidation et factures exonérées de TVA

[BR-E-01]-An Invoice that contains an Invoice line (BG-25), a Document level 
allowance (BG-20) or a Document level charge (BG-21) where the VAT category 
code (BT-151) is "E" shall contain exactly one VAT breakdown...

Les factures avec TVA exonérée (E), autoliquidation (AE) ou taux zéro (Z) nécessitent des structures TaxCategory spécifiques qui diffèrent des factures à taux standard (S).

Erreurs courantes :

  • Utiliser la valeur S pour ID sur toutes les lignes quel que soit le traitement TVA réel
  • Omettre les éléments TaxExemptionReasonCode ou TaxExemptionReason requis pour les catégories exonérées
  • Absence de AccountingSupplierParty/Party/PartyTaxScheme lorsque la facture utilise l’autoliquidation

Pour l’autoliquidation (AE), l’identifiant TVA du schéma fiscal de l’acheteur doit être présent, et l’identifiant TVA du vendeur doit également être présent.

Règles d’extension allemandes : XRechnung (BR-DE)

XRechnung, la CIUS allemande d’EN16931, ajoute des règles BR-DE au-delà de la base EN16931. Elles proviennent de la validation KoSIT pour XRechnung, et non de Peppol BIS, qui a ses propres règles allemandes (DE-R). Messages courants :

BR-DE-TMP-32 : un message d’information, pas une erreur. XRechnung demande la date de livraison ou de prestation : la date de livraison effective (BT-72), une période de facturation (BG-14) ou une période sur chaque ligne de facture (BG-26). En UBL, BT-72 est Delivery/ActualDeliveryDate au format AAAA-MM-JJ.

BR-DE-16 : si la facture utilise la catégorie de TVA S, Z, E, AE, K, G, L ou M, au moins l’un de ces éléments doit être présent : l’identifiant TVA du vendeur (BT-31), un numéro d’immatriculation fiscale (BT-32) ou le représentant fiscal (BG-11). L’absence des trois entraîne un rejet. Un vendeur sans identifiant TVA fournit BT-32 avec le numéro d’immatriculation fiscale.

BR-DE-15 : BT-10 est obligatoire ; pour les acheteurs publics, il contient le Leitweg-ID.

Déboguer efficacement

La sortie d’erreur Schematron inclut un emplacement XPath :

<svrl:failed-assert location="/Invoice[1]/cac:LegalMonetaryTotal[1]">
  <svrl:text>[BR-CO-10]-Sum of Invoice line net amounts...</svrl:text>
</svrl:failed-assert>

Utilisez l’emplacement XPath pour naviguer directement vers l’élément défaillant. Pour les règles arithmétiques, ajoutez une sortie de débogage qui enregistre les valeurs brutes avant arrondi pour tracer l’origine de la divergence.

Les fichiers XSLT précompilés des versions GitHub de Peppol BIS sont les artefacts de validation de référence. Exécutez-les avec Saxon HE comme décrit dans la génération de factures Peppol BIS 3.0 en C#. Utiliser la dernière version est important : les ensembles de règles sont mis à jour à chaque version de Peppol BIS, et une règle qui passe sur un ancien XSLT peut échouer sur la version actuelle.

SealDoc et les erreurs de validation

SealDoc contrôle chaque facture qu’il génère par rapport aux versions figées des ensembles de règles de son format ; pour Peppol BIS 3.0, il s’agit du schéma UBL 2.1, des règles EN16931 et des règles Peppol BIS. En cas d’échec de validation, l’API refuse la facture avec une réponse 422 qui indique chaque constat avec son code, son message et son emplacement.

Pour les organisations qui déboguent un pipeline de génération de factures existant, le validateur public SealDoc vérifie la conformité PDF/A-3 et ZUGFeRD/Factur-X/XRechnung et affiche les premières erreurs qu’il trouve, avec la règle dans chaque message.

Vérifier si un numéro de TVA est enregistré sur Peppol →
← Retour à tous les articles