Corriger BR-54 : Caractéristique d'article sans nom ou sans valeur

BR-54 dans votre propre facture ? Déposez le fichier et trouvez toutes les erreurs en quelques secondes.

Que signifie BR-54 ?

La règle contrôle chaque caractéristique d'article (BG-32) d'une ligne de facture. En CII, une caractéristique figure dans l'élément ram:ApplicableProductCharacteristic. Chaque caractéristique doit porter un nom (BT-160, ram:Description) et une valeur (BT-161, ram:Value). Une caractéristique comme "Couleur : Noir" n'est complète que si les deux parties sont là. S'il en manque une, le destinataire ne peut pas exploiter la caractéristique.

Causes fréquentes de BR-54

ram:Value manque, seul le nom de la caractéristique (ram:Description) est renseigné.
ram:Description manque, il n'y a qu'une valeur sans désignation.
L'élément ram:ApplicableProductCharacteristic a été créé vide.
Le nom et la valeur ont été écrits par erreur dans un seul champ.

Comment corriger BR-54

Repérer l'endroit fautif dans le XML. Ouvrez le XML de la facture et allez au champ BT-160 par le XPath suivant ://rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:ApplicableProductCharacteristic
Appliquer la correction. Ajoutez dans l'élément ram:ApplicableProductCharacteristic les deux enfants : ram:Description avec le nom de la caractéristique (p. ex. "Couleur") et ram:Value avec la valeur (p. ex. "Noir"). Les deux sont en texte libre.
Valider à nouveau. Enregistrez le fichier et validez-le à nouveau pour vérifier que BR-54 n'est plus signalé.

Proposition de correction

Ajoutez dans l'élément ram:ApplicableProductCharacteristic les deux enfants : ram:Description avec le nom de la caractéristique (p. ex. "Couleur") et ram:Value avec la valeur (p. ex. "Noir"). Les deux sont en texte libre.

XPath

//rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:ApplicableProductCharacteristic

Avant / après : l'exemple XML

Voici l'endroit concerné avant et après la correction (Cross Industry Invoice, Factur-X/ZUGFeRD).

Incorrect

<ram:SpecifiedTradeProduct>
  <ram:Name>Bürostuhl Modell B1</ram:Name>
  <ram:ApplicableProductCharacteristic>
    <ram:Description>Farbe</ram:Description>
  </ram:ApplicableProductCharacteristic>
</ram:SpecifiedTradeProduct>

Correct

<ram:SpecifiedTradeProduct>
  <ram:Name>Bürostuhl Modell B1</ram:Name>
  <ram:ApplicableProductCharacteristic>
    <ram:Description>Farbe</ram:Description>
    <ram:Value>Schwarz</ram:Value>
  </ram:ApplicableProductCharacteristic>
</ram:SpecifiedTradeProduct>

Questions fréquentes sur BR-54

Quelle différence entre BT-160 et BT-161 ?

BT-160 est le nom de la caractéristique (ram:Description), par exemple "Couleur". BT-161 est la valeur associée (ram:Value), par exemple "Noir". Les deux vont ensemble.

Puis-je indiquer plusieurs caractéristiques par ligne ?

Oui. Répétez ram:ApplicableProductCharacteristic pour chaque caractéristique. Chaque répétition exige de nouveau ram:Description et ram:Value.

Les caractéristiques d'article sont-elles obligatoires ?

Non. Si vous n'en indiquez aucune, la règle ne s'applique pas. Mais dès que vous en créez une, le nom et la valeur doivent être présents.

Codes d'erreur voisins

Vérifier BR-54 automatiquement

Plutôt que de fouiller le XML à la main, vous pouvez valider votre fichier Factur-X ou XRechnung en ligne – déposez le PDF ou le XML et vous recevez chaque erreur avec l'identifiant de la règle, le champ concerné, la proposition de correction et le XPath, sous forme de rapport lisible ou de JSON par l'API.

Valider en ligne maintenant Retour au lexique