PEPPOL-EN16931-R004 est une erreur fatale de validation de l'BIS Billing ation Peppol. Cela signifie que l'identifiant de spécification dans BT-24, représenté par cbc:CustomizationID, ne respecte pas le format d'identifiant requis pour une facture ou une note de crédit Peppol BIS Billing 3.0. Le document n'est pas conforme et ne doit pas être envoyé via le réseau Peppol tant que la valeur n'aura pas été corrigée.
| Champ d'application | Valeur |
| Règle | PEPPOL-EN16931-R004 |
| Gravité | Mortel |
| Couche de validation | Peppol BIS |
| Champ concerné | cbc:CustomizationID (BT-24) |
| S'applique à | Facture et note de crédit UBL |
| Release décrit | Peppol BIS Billing 3.0.21 |
Signification de cette erreur
CustomizationID indique au validateur et au système destinataire quelles spécifications et règles métier le document prétend respecter. Pour un document Peppol standard « BIS Billing 3.0 », cette valeur identifie à la fois la conformité à la norme EN 16931 et la spécification d'utilisation « Peppol Billing ».
Il ne s'agit pas d'un identifiant de participant Peppol et il ne permet pas d'identifier l'expéditeur ni le destinataire. Il diffère également de ProfileID, qui identifie le processus métier dans le cadre duquel le document est échangé.
Ce que vérifie la norme PEPPOL-EN16931-R004
La règle OpenPeppol actuelle vérifie que le CustomizationID:
- commence par l'identifiant Peppol BIS Billing 3.0 requis ; et
- ne contient pas de suffixe de version avec deux deux-points, écrit sous la forme
::.
Pour une facture ou une note de crédit standard au format Peppol BIS Billing 3.0, utilisez la valeur canonique ci-dessous exactement telle qu'elle est indiquée :
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0
Conservez-la sous la forme d'une chaîne continue. Bien que le test de validation normalise les espaces avant de vérifier la valeur, l'utilisation de la valeur canonique, sans espaces, sauts de ligne ni suffixes ajoutés, permet d'éviter toute ambiguïté et toute erreur de mappage.
Pourquoi les suffixes de version ne fonctionnent pas
OpenPeppol a mis à jour la règle R004 (erreur fatale) de la version 3.0.21 de l'BIS Billing Peppol afin de préciser explicitement cette exigence : CustomizationID ne doit pas comporter d'informations relatives à la version. L'release a été publiée en mai 2026 et est entrée en vigueur le 17 août 2026. Une valeur copiée à partir d'une ancienne implémentation peut donc ne pas passer la validation actuelle si elle se termine par un suffixe de version tel que ::2.1 ou ::3.0.
Causes courantes
- Spécification incorrecte : l'ERP ou le convertisseur insère un identifiant correspondant à un autre CIUS, format ou réseau.
- Identifiant incomplet : la valeur fait référence à la norme EN 16931, mais omet la partie « BIS Billing » de Peppol.
- Informations sur la version ajoutées : la valeur se termine par un suffixe composé de deux deux-points, ce que la règle actuelle rejette.
- Élément manquant ou vide :
cbc:CustomizationIDest absent, vide ou écrit dans un espace de noms XML incorrect. Cela peut également déclencher l'erreur BR-01. - Mappage de source incorrect : un modèle, un mappage de middleware ou un paramètre d'exportation génère une valeur erronée pour chaque document.
Comment corriger la norme PEPPOL-EN16931-R004
- Ouvrez le fichier XML généré. Localiser
cbc:CustomizationIDprès du début de la racineInvoiceouCreditNoteélément. - Vérifiez la valeur complète. Recherchez un identifiant tronqué, une valeur provenant d'un autre format, une faute de frappe ou un élément ajouté à la fin.
::suffixe de version. - Définissez l'identifiant canonique. Pour la norme Peppol « BIS Billing 3.0 », remplacez la valeur par l'identifiant indiqué ci-dessus.
- Corrigez la configuration source. Mettez à jour l'exportation ERP, le modèle de document ou le mappage de transformation à l'origine de cette valeur. La modification d'un seul fichier XML ne permet pas de résoudre l'erreur sous-jacente.
- Créez et validez un nouveau document. Exécutez le fichier XML complet à l'aide des outils de validation Peppol actuels ( BIS Billing ) avant de tenter à nouveau la transmission.
Si le document s'appuie délibérément sur un CIUS, une spécification nationale ou un profil PINT différent, ne remplacez pas l'identifiant sans réfléchir. Vérifiez que le CustomizationID exigées par cette spécification et valider le document par rapport à l'ensemble de règles correspondant.
Exemples XML
Conforme à la norme Peppol « BIS Billing » 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
Incorrect : identifiant incomplet
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>
Incorrect : informations sur la version ajoutées
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>
Si BR-01 apparaît également
La norme BR-01 exige que chaque facture et chaque note de crédit comporte un identifiant de spécification dans le champ BT-24. Si CustomizationID est manquant, vide ou non reconnu dans l'espace de noms attendu ; un validateur peut alors signaler à la fois le code d'erreur BR-01 et le code R004. Corrigez la présence, l'espace de noms et la valeur de l'élément, puis validez le document régénéré. Ne considérez pas ces deux messages comme des erreurs sans rapport entre elles.
Les identifiants « CustomizationID » et « ProfileID » ne sont pas interchangeables.
| Élément | Objectif |
cbc:CustomizationID | Indique la spécification et l'ensemble de règles auxquelles le document se conforme. |
cbc:ProfileID | Identifie le processus métier dans le cadre duquel le document est échangé. |
Modification ProfileID ne permettra pas de résoudre l'erreur PEPPOL-EN16931-R004. L'erreur concerne CustomizationID.
Recommandations connexes
Source normative
Les exigences de validation et les tests de conformité sont publiés par OpenPeppol. Cet article présente les explications pratiques et les conseils de mise en œuvre de Qvalia. Veillez à toujours utiliser les éléments de validation applicables au document ainsi que la version actuelle de Peppol release.