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

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

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

Konkreter Korrekturvorschlag

Vergeben Sie für jede Rechnungsposition (BG-25) eine eindeutige Positionskennung (BT-126) im Element 'ram:AssociatedDocumentLineDocument/ram:LineID'. Nummerieren Sie 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, 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