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

UBL-CR-618 : Retirer ItemPropertyRange d'un attribut d'article

Avertissement : EN 16931 ne prévoit pas cac:ItemPropertyRange dans un attribut d'article. 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-618 est un avertissement émis lorsque cac:ItemPropertyRange apparaît dans un attribut d'article (cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty). EN 16931 n'a pas de terme métier pour cet élément : retirez-le avec tout son contenu. Un attribut d'article n'a qu'un nom et une valeur, cbc:Name et cbc:Value (BT-160, BT-161) ; écrivez une quantité ou une unité dans la valeur.

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:Item/cac:AdditionalItemProperty/cac:ItemPropertyRange. Son contenu n'est pas lu.

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:Item/cac:AdditionalItemProperty/cac:ItemPropertyRange dans le XML.

Tout ce que contient cac:ItemPropertyRange disparaît avec lui ; aucune autre règle UBL-CR ne désigne un emplacement à l'intérieur.

Terme	Signification	Élément UBL
-	ItemPropertyRange (UBL uniquement, sans terme métier)	`cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty/cac:ItemPropertyRange`
BG-32	Attribut d'article	`cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty`

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 :

Une structure cac:ItemPropertyRange entière est reprise d'une fiche de référence ou d'un autre type de document, y compris des parties qu'EN 16931 n'utilise pas.
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:Item/cac:AdditionalItemProperty/cac:ItemPropertyRange, avec tout son contenu.
Un attribut d'article n'a qu'un nom et une valeur, cbc:Name et cbc:Value (BT-160, BT-161) ; écrivez une quantité ou une unité dans la valeur.
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 : ItemPropertyRange dans un attribut d'article

<cac:AdditionalItemProperty>
  <cbc:Name>Colour</cbc:Name>
  <cbc:Value>Black</cbc:Value>
  <cac:ItemPropertyRange>
    <cbc:MinimumValue>Example</cbc:MinimumValue>
  </cac:ItemPropertyRange>
</cac:AdditionalItemProperty>

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

<cac:AdditionalItemProperty>
  <cbc:Name>Colour</cbc:Name>
  <cbc:Value>Black</cbc:Value>
</cac:AdditionalItemProperty>

La facture avec l'avertissement contient <cac:ItemPropertyRange> dans un attribut d'article, 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-618. 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-618 (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