BR-21 beheben: Positionskennung (BT-126) fehlt

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

Rechnung prüfen API-Key holen

Was bedeutet BR-21?

Jede Position braucht eine eindeutige Kennung, meist eine laufende Nummer. So laesst sich jede Position ansprechen.

Häufige Ursachen für BR-21

Das Element 'ram:LineID' in 'ram:AssociatedDocumentLineDocument' fehlt bei einer Position.
Die Positionsnummerierung wird vom erzeugenden System nicht gesetzt.
Mehrere Positionen teilen sich keine eindeutige Kennung oder es fehlt der ganze 'AssociatedDocumentLineDocument'-Block.

So behebst du BR-21

Fehlerhafte Stelle im XML finden. Öffne die XML der E-Rechnung und navigiere zum Feld BT-126 über den folgenden XPath://ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:LineID
Korrektur einsetzen. Vergib für jede Rechnungsposition (BG-25) eine eindeutige Positionskennung (BT-126) im Element 'ram:AssociatedDocumentLineDocument/ram:LineID'. Nummeriere die Positionen fortlaufend, z. B. '1', '2', '3'.
Erneut validieren. Speichere die Datei und validiere sie erneut, um zu prüfen, dass BR-21 nicht mehr gemeldet wird.

Konkreter Korrekturvorschlag

Vergib für jede Rechnungsposition (BG-25) eine eindeutige Positionskennung (BT-126) im Element 'ram:AssociatedDocumentLineDocument/ram:LineID'. Nummeriere die Positionen fortlaufend, z. B. '1', '2', '3'.

XPath//ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:LineID

Vorher / Nachher: das XML-Beispiel

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

Fehlerhaft

<ram:IncludedSupplyChainTradeLineItem>
  <ram:SpecifiedTradeProduct>
    <ram:Name>Beratung</ram:Name>
  </ram:SpecifiedTradeProduct>
</ram:IncludedSupplyChainTradeLineItem>

Korrekt

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>1</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  <ram:SpecifiedTradeProduct>
    <ram:Name>Beratung</ram:Name>
  </ram:SpecifiedTradeProduct>
</ram:IncludedSupplyChainTradeLineItem>

Häufige Fragen zu BR-21

Muss die Positionskennung eine Zahl sein?

Nein, es ist eine Zeichenkette. Übliche Praxis ist eine fortlaufende Nummer wie '1', '2', '3', sie muss aber nur innerhalb der Rechnung eindeutig sein.

Dürfen sich Positionsnummern wiederholen?

Nein. Jede Positionskennung muss innerhalb der Rechnung eindeutig sein, damit die Position klar referenzierbar bleibt.

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