Erreurs de validation Peppol : codes de règle, causes et corrections

Une erreur de validation Peppol signifie que le fichier de facture structurée enfreint une règle de la norme européenne EN 16931 ou de Peppol BIS Billing 3.0, et qu'il a été refusé avant de partir. Ce n'est ni un échec de livraison ni un rejet par le client : le fichier n'a jamais atteint le client, qui n'a donc rien à comptabiliser, approuver ou rejeter.

Ce guide s'adresse à toute personne qui envoie des factures structurées, lit un rapport de validation ou utilise l'API OrdoGrid. Les messages affichés avant la validation, comme une autorisation manquante ou un client introuvable, et les rejets par le client sont traités dans Corriger un envoi Peppol en échec ou une facture Peppol refusée.

Erreur de validation, problème de livraison ou rejet ?

Traité signifie que le réseau a livré le fichier, pas que le client en a accepté le contenu ; une facture au contenu erroné doit quand même être corrigée par une note de crédit.

Comment fonctionne la validation Peppol

La validation passe par trois couches : le schéma XML UBL 2.1 (le fichier respecte-t-il la structure UBL ?), les règles métier EN 16931 (les données et les montants concordent-ils ?) et les règles Peppol BIS Billing (restrictions et listes de codes propres à Peppol). Une règle de niveau fatal (bloquante) refuse le fichier ; une règle de niveau warning (avertissement) informe seulement.

Schematron

Les fichiers de règles publiés par le CEN (EN 16931) et OpenPeppol (BIS Billing). Chaque assertion a un code comme BR-CO-14, un niveau (fatal ou warning), un emplacement dans le XML et un message qui cite les termes métier (numéros BT) concernés.

Quelle version s'applique. En octobre 2026, la version en vigueur est Peppol BIS Billing 3.0.21 (version de mai 2026), publiée le 20 mai 2026 et obligatoire depuis le 17 août 2026. OpenPeppol publie une version au printemps et une à l'automne, obligatoire environ trois mois plus tard (notes de version). La 3.0.21 a supprimé BR-CO-25 (échéance ou conditions de paiement) et durci PEPPOL-EN16931-R004 : l'identifiant de spécification ne peut plus se terminer par un suffixe de version comme ::2.1. La Belgique n'a pas de règles nationales dans BIS Billing ; son seul contrôle propre est PEPPOL-COMMON-R043.

Lire une ligne de rapport. « [BR-CO-14]-Invoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117) » donne la règle, puis les termes métier : BT-110 est le total de la TVA, BT-117 la TVA de chaque catégorie. Corrigez les données correspondant à ces termes ; un seul montant erroné déclenche souvent plusieurs règles BR-CO à la fois.

Ce qu'OrdoGrid contrôle avant un envoi Peppol

OrdoGrid se connecte à Peppol via un point d'accès certifié. Avant de transmettre un fichier, il construit l'UBL à partir de votre Profil entreprise, du client et de la facture, puis le valide selon le schéma UBL 2.1, les artefacts de validation EN 16931 1.3.16 et les règles Peppol BIS Billing 3.0.21. Seules les règles bloquantes arrêtent l'envoi. Si l'une échoue, rien n'est transmis : le résultat d'envoi affiche Des erreurs sont survenues. et, sur la ligne Peppol, le message en anglais « Official Peppol/EN16931 validation refused the emitted XML » ou un message semblable sur le schéma UBL 2.1. Les codes de règle ne s'affichent pas à l'écran. Après un refus, Peppol → Outbox affiche quand même la facture avec le badge Créé, et Envoyer indique Déjà envoyé via Peppol, alors que rien n'a été transmis ; une facture en Brouillon le reste aussi, sauf si l'e-mail est parti. Ici, Créé ne signifie pas que la facture est en route.

OrdoGrid prend lui-même en charge de nombreuses règles, car c'est lui qui génère le fichier à partir de vos données :

L'éditeur bloque aussi deux incohérences de TVA qui enfreindraient BR-S-05 : toutes les lignes à 0 % sous Standard (avertissement Attention : Régime standard incompatible avec TVA à 0%, puis une fenêtre avec Appliquer ce régime), et un mélange de lignes à 0 % et à d'autres taux sous Standard, refusé à l'envoi. N'appliquez un régime proposé que s'il est juridiquement correct : la suggestion d'OrdoGrid n'est pas une règle fiscale.

Ce qui reste de votre ressort :

Codes de règle : cause et correction

Une sélection de règles bloquantes, avec leur cause habituelle et leur correction. Les tolérances viennent des pages officielles des règles (règles BIS, règles EN 16931). CL001, R008, BR-09, BR-11 et BR-IC-11/12 figurent dans le tableau « Ce qui reste de votre ressort » ci-dessus.

Le contrôle du numéro d'entreprise. PEPPOL-COMMON-R043 divise les huit premiers chiffres par 97 et attend que les deux derniers chiffres valent 97 moins le reste. Avec l'exemple du SPF Finances, 0208:0308357159 : 03083571 divisé par 97 donne un reste de 38, et 97 − 38 = 59, les deux derniers chiffres. Une faute de frappe comme 0308357195 échoue. Les numéros d'entreprise attribués depuis septembre 2023 commencent par 1 : ils sont valables et doivent être acceptés tels quels. Le SPF Finances renvoie à lookup.peppol.org pour vérifier si un numéro est enregistré.

Les catégories de TVA qu'envoie OrdoGrid, et les règles que chacune déclenche :

La liste de codes (UNCL 5305) ne connaît pas de catégorie « franchise » : le régime de franchise est transmis en catégorie E avec un motif. OrdoGrid inscrit aussi chaque mention TVA, suivie de vos Notes, dans l'unique note du document (BT-22) que la règle R002 autorise.

Exemple chiffré : une facture, règle par règle

Imprimerie Dufour SRL (Namur) imprime pour Agence Lumen SRL (Bruxelles) : facture F-2026-0087 du 6 octobre 2026, échéance le 5 novembre 2026, bon de commande PO-4471.

Selon la méthode d'EN 16931, la TVA est calculée une seule fois sur la catégorie à 21 % : 462,50 € × 21 % = 97,125 €, arrondi à 97,13 €. Total TVAC : 462,50 € + 97,13 € = 559,63 € ; montant à payer 559,63 €.

Un tableur qui arrondit la TVA ligne par ligne obtient 44,63 € + 18,38 € + 34,13 € = 97,14 €. La suite dépend de l'export :

Dans OrdoGrid, TVA affiche 97,13 € et Total TVAC 559,63 € : le fichier respecte donc ces règles d'office. Le risque était ailleurs : le bon de livraison était joint en bon-de-livraison.docx. Avant l'envoi, la comptable :

1. Ouvre F-2026-0087 et vérifie N° bon de commande sous Documents et Références : PO-4471 devient la référence acheteur (R003).
2. Retire bon-de-livraison.docx et ajoute bon-de-livraison.pdf, exporté depuis Word (CL001).
3. Vérifie Options de TVA : Standard, toutes les lignes à 21 %.
4. Clique sur Aperçu du PDF, puis Envoyer, laisse Envoi électronique via Peppol coché, décoche Email (le PDF est déjà inclus dans le fichier Peppol : le client ne reçoit pas deux exemplaires) et clique sur Sauvegarder & Envoyer.
5. Suit la ligne dans Peppol → Outbox, avec Vérifier, jusqu'au statut Traité.

Avec le fichier Word encore joint, l'étape 4 aurait abouti à un refus et à une facture verrouillée.

Après un refus dans OrdoGrid

1. Gardez une trace du message. Faites une capture d'écran du résultat d'envoi avec le numéro de facture et l'heure : Peppol → Outbox affichera ensuite la facture avec le badge Créé, et non comme refusée.
2. Regardez la ligne Email. L'e-mail et Peppol partent en parallèle. Si Email était coché et a réussi, le client a déjà le PDF : n'envoyez pas d'autre copie. Pour une vente B2B belge soumise à l'obligation, ce PDF n'est pas la facture légale : la facture structurée doit encore être émise, l'étape 5 reste donc nécessaire.
3. Ne réessayez pas et ne créez pas de nouveau document. Pas de second Sauvegarder & Envoyer, pas de Dupliquer, pas de Note de crédit : la facture est verrouillée, et un second document pour la même vente risque d'entraîner une double comptabilisation.
4. Identifiez la cause probable dans le tableau « Ce qui reste de votre ressort ». Pour une Livraison intracommunautaire, envoyer la même facture par Email est une voie valable et une exception à l'étape 3 : utilisez Envoyer en ne cochant que Email, ou l'action d'envoi par e-mail de la liste des factures.
5. Contactez le support OrdoGrid avec le numéro de facture, la capture et la cause présumée. Si la facture doit finalement être remplacée, suivez l'avis du support et de votre comptable : lorsque le PDF a déjà été envoyé au client par e-mail, la correction est une note de crédit et une nouvelle facture (Corriger un envoi Peppol en échec ou une facture Peppol refusée).

Via l'API. Un envoi refusé à la validation renvoie une erreur HTTP 400 avec le code PEPPOL_XML_INVALID ; details.failures liste chaque règle en échec (id, location, message) et details.validation les versions utilisées. En cas d'échec sur le schéma UBL 2.1, les erreurs figurent dans details.schema_errors. Quand la validation refuse un appel POST /api/v1/peppol/send, cet appel a déjà créé la facture : elle reste dans OrdoGrid, verrouillée, avec son numéro. Ne refaites pas l'appel avec des données corrigées : vous créeriez une seconde facture pour la même vente. Si seule une pièce jointe a échoué (PEPPOL-EN16931-CL001), relancez la même facture avec POST /api/v1/peppol/invoices/{id}/send et des attachment_ids qui excluent ce fichier ; pour en garder le contenu, ajoutez-en une version PDF dans attachments. Pour toute autre règle, contactez le support OrdoGrid comme indiqué ci-dessus. Pour les nouvelles factures, utilisez des codes d'unité UN/ECE et les six types de pièces jointes Peppol. Il n'existe pas de mode test : chaque appel agit sur des données réelles et sur le réseau réel.

Cas particuliers et erreurs fréquentes

Preuves à conserver

• La capture du refus, avec numéro de facture, date et heure, et l'indication que l'e-mail est parti ou non.
• Pour les envois via l'API : la réponse d'erreur complète, avec details.failures et details.validation.
• Pour un rapport d'un autre outil : le rapport lui-même, avec les codes de règle et la version utilisée.
• Pour les factures envoyées : le XML et le PDF tels que transmis, qu'OrdoGrid archive avec leurs versions de validation et leurs empreintes SHA-256. Téléchargez-les depuis Peppol → Outbox (XML ou PDF, ou un ZIP des lignes sélectionnées).
• Une courte note sur ce qui a changé et pourquoi, pour votre comptable, si un numéro de facture reste inutilisé ou est remplacé.

Questions fréquentes

Pourquoi OrdoGrid refuse-t-il l'envoi alors que le PDF semble correct ?

Le PDF est une copie lisible. Peppol valide le XML structuré, qui est depuis le 1er janvier 2026 la facture légale pour les ventes B2B belges concernées. Une pièce jointe Word ou une adresse incomplète enfreint des règles que le PDF ne montre pas.

Une erreur de validation est-elle la même chose qu'une facture rejetée ?

Non. Une erreur de validation arrête le fichier avant la transmission : le client n'a rien reçu. Un rejet est une Invoice Response (RE) d'un client qui a reçu la facture.

Selon quelles règles Peppol OrdoGrid valide-t-il ?

Le schéma UBL 2.1, les artefacts de validation EN 16931 1.3.16 et les règles Peppol BIS Billing 3.0.21 (version de mai 2026, obligatoire depuis le 17 août 2026). Seules les règles bloquantes arrêtent un envoi.

Puis-je corriger la facture et la renvoyer après un refus ?

Pas vous-même : les montants, la TVA, le client et le numéro sont verrouillés dès qu'OrdoGrid prépare le fichier Peppol, avant la validation. Ne dupliquez pas la facture et n'établissez pas de note de crédit ; contactez le support OrdoGrid avec le numéro de facture et une capture.

Pourquoi le total de TVA ne correspond-il pas aux lignes ?

EN 16931 calcule la TVA par catégorie, pas par ligne. Quand un logiciel additionne la TVA arrondie des lignes pour le total mais calcule la ventilation par taux, BR-CO-14 échoue.

Pourquoi le numéro d'entreprise de mon client est-il refusé par la règle R043 ?

Une valeur 0208 doit compter exactement dix chiffres, sans BE, points ni espaces, et réussir le contrôle modulo 97 sur ses deux derniers chiffres. Vérifiez le numéro dans la BCE.

Un rapport de validation sans erreur signifie-t-il que ma TVA est correcte ?

Non. La validation contrôle la cohérence ; le bon taux, le bon régime et les mentions légales restent sous votre responsabilité.