Aller au contenu
Ironfang
fr
Ironfang
Français
Créer un compte gratuitSe connecter

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

UBL-CR-002 : Déclarer la version UBL 2.1 ou omettre la version

Avertissement : cbc:UBLVersionID indique une autre version que 2.1. Le document reste valide ; écrivez 2.1 ou omettez l'élément.

EN 16931Avertissement : le document reste valideChamps de base

Sur cette page

La réponse courte

UBL-CR-002 est un avertissement émis lorsque cbc:UBLVersionID est présent avec une autre valeur que 2.1. Le document est en UBL 2.1 : écrivez 2.1, ou omettez l'élément.

L'avertissement seul ne rend pas le document invalide, mais d'autres règles vérifient toujours ce qui est présent.

Ce que la règle vérifie

La règle lit la valeur : cbc:UBLVersionID peut être absent, ou présent avec 2.1 ; toute autre valeur la déclenche. L'exemple enregistré indique 2.0.

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 fois où le document contient l'élément. Ce constat pointe vers la racine du document, et non vers l'élément : cherchez cbc:UBLVersionID dans le XML.

TermeSignificationÉlément UBL
-UBLVersionID avec une autre valeur que 2.1 (UBL uniquement, sans terme métier)cbc:UBLVersionID

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 document vient d'une bibliothèque ou d'un modèle écrit pour une autre version d'UBL, et indique cette version.
  • 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

  1. Écrivez 2.1 dans cbc:UBLVersionID, ou cessez d'écrire l'élément.
  2. La spécification sur laquelle un destinataire valide est nommée dans cbc:CustomizationID (BT-24), et non par la version UBL.
  3. Validez à nouveau : l'avertissement disparaît.

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 : UBLVersionID dans l'en-tête du document

<cbc:UBLVersionID>2.0</cbc:UBLVersionID>
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>EXAMPLE-INV-002</cbc:ID>

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

<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>EXAMPLE-INV-002</cbc:ID>

La facture avec l'avertissement contient <cbc:UBLVersionID>2.0</cbc:UBLVersionID> dans l'en-tête du document, 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é

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 ; 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-002 (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éeAutomatiser la validation avec l'API Ironfang Finance