BR-54 beheben: Artikelmerkmal ohne Name oder Wert

BR-54 in deiner eigenen Rechnung? Lade die Datei hoch und finde alle Fehler in Sekunden.

Was bedeutet BR-54?

Die Regel prueft jedes Artikelmerkmal (BG-32) einer Rechnungsposition. In CII steht ein Merkmal im Element ram:ApplicableProductCharacteristic. Jedes Merkmal muss einen Namen (BT-160, ram:Description) und einen Wert (BT-161, ram:Value) tragen. Ein Merkmal wie "Farbe: Schwarz" ist nur vollstaendig, wenn beide Teile da sind. Fehlt einer, kann der Empfaenger das Merkmal nicht auswerten.

Häufige Ursachen für BR-54

ram:Value fehlt, nur der Merkmalsname (ram:Description) ist gesetzt.
ram:Description fehlt, es steht nur ein Wert ohne Bezeichnung.
Das Element ram:ApplicableProductCharacteristic wurde leer angelegt.
Name und Wert wurden versehentlich in ein einziges Feld geschrieben.

So behebst du BR-54

Fehlerhafte Stelle im XML finden. Öffne die XML der E-Rechnung und navigiere zum Feld BT-160 über den folgenden XPath://rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:ApplicableProductCharacteristic
Korrektur einsetzen. Ergaenze im Element ram:ApplicableProductCharacteristic beide Kinder: ram:Description mit dem Merkmalsnamen (z.B. "Farbe") und ram:Value mit dem Wert (z.B. "Schwarz"). Beide sind Freitext.
Erneut validieren. Speichere die Datei und validiere sie erneut, um zu prüfen, dass BR-54 nicht mehr gemeldet wird.

Konkreter Korrekturvorschlag

Ergaenze im Element ram:ApplicableProductCharacteristic beide Kinder: ram:Description mit dem Merkmalsnamen (z.B. "Farbe") und ram:Value mit dem Wert (z.B. "Schwarz"). Beide sind Freitext.

XPath

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

Vorher / Nachher: das XML-Beispiel

So sieht die betroffene Stelle vor und nach der Korrektur aus (Cross-Industry-Invoice, ZUGFeRD/Factur-X).

Fehlerhaft

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

Korrekt

<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>

Häufige Fragen zu BR-54

Was ist der Unterschied zwischen BT-160 und BT-161?

BT-160 ist der Name des Merkmals (ram:Description), zum Beispiel "Farbe". BT-161 ist der zugehoerige Wert (ram:Value), zum Beispiel "Schwarz". Beide gehoeren zusammen.

Kann ich mehrere Merkmale je Position angeben?

Ja. Wiederhole ram:ApplicableProductCharacteristic je Merkmal. Jede Wiederholung braucht wieder ram:Description und ram:Value.

Sind Artikelmerkmale Pflicht?

Nein. Wenn du kein Merkmal angibst, greift die Regel nicht. Sobald du aber eines anlegst, muessen Name und Wert vorhanden sein.

BR-54 automatisch prüfen

Statt das XML manuell zu durchsuchen, kannst du deine ZUGFeRD- oder XRechnung-Datei online validieren – lade die PDF oder XML hoch und du bekommst jeden Fehler mit Regel-ID, betroffenem Feld, Korrekturvorschlag und XPath, als lesbaren Report oder strukturiertes JSON über die API.

Jetzt online validieren Zurück zum Lexikon