BR-25: Artikelname in der Rechnungsposition fehlt

BR-25 klingt banal, jede Position braucht einen Namen, scheitert aber regelmäßig an der Frage, in welchem Feld der Name eigentlich steht.

Was die Regel prüft

Jede Rechnungszeile (BG-25, BG = Business Group der Norm) muss den Namen der abgerechneten Ware oder Leistung enthalten, BT-153 (BT = Business Term). In der CII-Syntax ist das ram:Name innerhalb von ram:SpecifiedTradeProduct. Die Norm kennt daneben ein optionales Beschreibungsfeld (BT-154, ram:Description) für längere Erläuterungen; das ersetzt den Namen nicht.

Warum sie in der Praxis fehlschlägt

Häufigster Fall: Die Software mappt den Positionstext ins Beschreibungsfeld statt in den Namen. Gerade bei Handwerksrechnungen mit langen Leistungstexten („Demontage der Altanlage, Montage und Inbetriebnahme …") landet der komplette Text in ram:Description, und ram:Name bleibt leer. Für den Validator hat die Position dann keinen Namen.

Zweiter Fall: Positionen, die aus Aufmaß- oder GAEB-Daten importiert werden und nur eine Ordnungszahl tragen, während der Text in einer vorangestellten Hierarchie- oder Textzeile steht. Beim Export in die E-Rechnung geht der Bezug verloren.

So behebst du den Fehler

Gib jeder Position eine kurze, eigenständige Bezeichnung: „Wartung Gastherme", „Kabelkanal 40x60 mm", „Gesellenstunde". Details wie Typenbezeichnungen, Einbauort oder Arbeitsschritte gehören in die Beschreibung (BT-154), die zusätzlich stehen darf. In Belegschmied ist die Positionsbezeichnung ein Pflichtfeld, ohne sie lässt sich die Rechnung nicht erzeugen.

Wenn du eine fremde XML reparierst: Kopiere notfalls den ersten Satz oder die ersten Worte der Beschreibung nach ram:Name, das erfüllt die Regel und bleibt inhaltlich korrekt.

XML-Beispiel: vorher und nachher

Der Leistungstext steht nur in der Beschreibung:

<!-- verletzt BR-25: SpecifiedTradeProduct ohne Name -->
<ram:SpecifiedTradeProduct>
  <ram:Description>Austausch Heizungspumpe inkl. Entlüftung
  und Funktionsprüfung der Anlage</ram:Description>
</ram:SpecifiedTradeProduct>

Korrigiert: kurzer Name (BT-153), Details bleiben in der Beschreibung:

<ram:SpecifiedTradeProduct>
  <ram:Name>Austausch Heizungspumpe</ram:Name>
  <ram:Description>Austausch Heizungspumpe inkl. Entlüftung
  und Funktionsprüfung der Anlage</ram:Description>
</ram:SpecifiedTradeProduct>