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

Software-Tipp

Rechnung selbst gebaut?

Wer das XML aus dem eigenen System oder von Hand zusammensetzt, muss Regeln wie diese kennen. Diese Programme erzeugen ZUGFeRD und XRechnung und füllen die Pflichtfelder von sich aus.

Lexware Office Weit verbreiteter Allrounder (früher lexoffice) für Einsteiger und kleine Unternehmen. Ansehen *

sevDesk Rechnung und Buchhaltung in einem, beliebt bei Selbstständigen und kleinen Firmen. Ansehen *

BuchhaltungsButler Starke Beleg-Automatik, wenn viel hereinkommt. Wir nutzen es selbst. Ansehen *

* Werbelinks. Wir bekommen eine Provision, für dich bleibt der Preis gleich. Fünf Programme im Vergleich