Ironfang Finance - Référence des règles

UBL-CR-533 : Retirer UUID de l'identifiant d'objet de la ligne

Avertissement : EN 16931 ne prévoit pas cbc:UUID dans l'identifiant d'objet de la ligne. Le document reste valide ; retirez l'élément.

EN 16931Avertissement : le document reste valideLignes et prix

Sur cette page

La réponse courte

UBL-CR-533 est un avertissement émis lorsque cbc:UUID apparaît dans l'identifiant d'objet de la ligne (cac:InvoiceLine/cac:DocumentReference). EN 16931 n'a pas de terme métier pour cet élément : retirez-le.

L'avertissement seul ne rend pas le document invalide, mais d'autres règles vérifient toujours ce qui est présent. Retirer l'élément maintient le XML dans le modèle EN 16931, à partir duquel un destinataire intègre la facture.

Ce que la règle vérifie

La règle vérifie une seule chose : la présence de cac:InvoiceLine/cac:DocumentReference/cbc:UUID. Sa valeur n'est pas lue.

Elle s'exécute une seule fois sur l'ensemble du document et ne produit donc qu'un constat, quel que soit le nombre de lignes qui portent l'élément. Ce constat pointe vers la racine du document, et non vers l'élément : cherchez cac:InvoiceLine/cac:DocumentReference/cbc:UUID dans le XML.

Terme	Signification	Élément UBL
-	UUID (UBL uniquement, sans terme métier)	`cac:InvoiceLine/cac:DocumentReference/cbc:UUID`
BT-128	Identifiant d'objet de la ligne	`cac:InvoiceLine/cac:DocumentReference`

Comment une intégration en arrive là

Causes possibles, déduites de la forme de la règle et non d'une utilisation mesurée :

Le système source attribue un UUID à chaque enregistrement, et le mapping l'écrit partout où UBL 2.1 a un élément cbc:UUID.
Une bibliothèque UBL 2.1 générique écrit chaque élément et attribut pour lequel elle a une valeur, qu'EN 16931 l'utilise ou non.
Un mapping conçu pour un autre document basé sur UBL, comme une commande, un avis d'expédition ou un profil national, est réutilisé pour Peppol BIS Billing.

Comment corriger le document

Cessez d'écrire cac:InvoiceLine/cac:DocumentReference/cbc:UUID.
Si vous avez besoin de l'information, conservez-la dans vos propres registres : EN 16931 n'a pas de terme métier pour elle, un destinataire n'a donc aucun endroit convenu où la lire.
Validez à nouveau : l'avertissement disparaît. Si l'élément était le seul contenu de son parent, retirez aussi le parent : Peppol refuse les éléments vides (PEPPOL-EN16931-R008).

Valider votre facture corrigée

Avant et après

Ce sont des extraits, pas des documents complets. Les documents synthétiques complets dont ils proviennent sont liés ci-dessous.

Fragment de la facture avec l'avertissement : UUID dans l'identifiant d'objet de la ligne

<cac:DocumentReference>
  <cbc:ID schemeID="ABZ">LINE-OBJECT-001</cbc:ID>
  <cbc:UUID>6f4c3a9e-1b2d-4e5f-8a7b-9c0d1e2f3a4b</cbc:UUID>
  <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
</cac:DocumentReference>

Fragment de la facture corrigée : les mêmes lignes sans l'élément

<cac:DocumentReference>
  <cbc:ID schemeID="ABZ">LINE-OBJECT-001</cbc:ID>
  <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
</cac:DocumentReference>

La facture avec l'avertissement contient <cbc:UUID>6f4c3a9e-1b2d-4e5f-8a7b-9c0d1e2f3a4b</cbc:UUID> dans l'identifiant d'objet de la ligne, et la facture corrigée est le même document sans l'élément. La facture avec l'avertissement ne signale que celui-ci et est valide à toutes les étapes : elle serait donc acceptée en l'état.

Ce que le validateur a signalé

La facture avec l'avertissement est valide et signale l'avertissement UBL-CR-533. Le document corrigé passe toutes les étapes de validation sans constat.Télécharger le XML avec l'avertissement Télécharger le XML corrigé

Enregistré avec phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, le moteur du validateur gratuit, sur des données synthétiques. Un résultat enregistré est une preuve de non-régression pour ces documents ; ce n'est pas une certification.

Où la règle s'applique

S'applique de la même façon aux documents UBL Invoice et CreditNote, aux lignes de facture comme aux lignes d'avoir ; l'exemple enregistré est une facture.
L'avertissement vient des règles de l'étape EN 16931 pour la syntaxe UBL. Dans l'exemple enregistré, l'étape XSD réussit : l'élément est valide en UBL 2.1 et sort seulement du modèle EN 16931.

Portée et source

Rédigé pour Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, tel qu'appliqué aux documents Invoice et CreditNote en UBL 2.1. D'autres profils, syntaxes et versions peuvent définir cet identifiant autrement. Version du catalogue d'aide 2026-09-29.1 : source vérifiée le 2026-09-29, explication mise à jour le 2026-09-29.

La définition officielle de UBL-CR-533 (en anglais) contient le texte normatif et le test. Cette page en est notre explication, pas une copie.

Cette aide ne modifie pas le verdict du moteur. Corriger ce constat ne signifie pas que le document passe toutes les étapes de validation, et la validation ne certifie pas la conformité juridique ou fiscale et ne transmet aucun document via Peppol.

Valider votre facture corrigée Automatiser la validation avec l'API Ironfang Finance