BR-54 beheben: Artikelmerkmal ohne Name oder Wert

BR-54 in Ihrer eigenen Rechnung? Laden Sie die Datei hoch und finden Sie 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 beheben Sie BR-54

Fehlerhafte Stelle im XML finden. Öffnen Sie die XML der E-Rechnung und navigieren Sie zum Feld BT-160 über den folgenden XPath://rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:ApplicableProductCharacteristic
Korrektur einsetzen. Ergaenzen Sie 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. Speichern Sie die Datei und validieren Sie sie erneut, um zu prüfen, dass BR-54 nicht mehr gemeldet wird.

Konkreter Korrekturvorschlag

Ergaenzen Sie 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. Wiederholen Sie ram:ApplicableProductCharacteristic je Merkmal. Jede Wiederholung braucht wieder ram:Description und ram:Value.

Sind Artikelmerkmale Pflicht?

Nein. Wenn Sie kein Merkmal angeben, greift die Regel nicht. Sobald Sie aber eines anlegen, muessen Name und Wert vorhanden sein.

BR-54 automatisch prüfen

Statt das XML manuell zu durchsuchen, können Sie Ihre ZUGFeRD- oder XRechnung-Datei online validieren: Laden Sie die PDF oder XML hoch, und Sie bekommen 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 Sie bleibt der Preis gleich. Fünf Programme im Vergleich