BR-CL-08: Einen Betreffcode aus UNTDID 4451 in Großbuchstaben zwischen die Rauten einer Bemerkung zur Rechnung setzen

Die kurze Antwort

BR-CL-08 schlägt fehl, wenn eine cbc:Note auf Rechnungsebene zwischen ihrem ersten und zweiten # genau drei Zeichen enthält und diese drei nicht in der Liste UNTDID 4451 zu finden sind. Die aufgezeichnete Bemerkung begann mit #aai#; die Codes stehen in Großbuchstaben, daher beginnt die korrigierte Bemerkung mit #AAI#, General information.

In UBL wird der Betreffcode der Bemerkung (BT-21) in dieser Form #CODE# im Text der Bemerkung übertragen. Eine Bemerkung, die keinen Betreffcode tragen soll, darf auch nicht zufällig drei Zeichen zwischen zwei Rauten enthalten.

Was die Regel prüft

Die Regel liest jede cbc:Note direkt unter dem Wurzelelement und nimmt den Text zwischen ihren ersten beiden #-Zeichen. Nur wenn dieser Text genau drei Zeichen lang ist, wird er nachgeschlagen; sonst besteht die Bemerkung. Im Versuch bestanden #INFO# mit vier Buchstaben und eine Bemerkung mit einem einzigen # beide.

Der Code muss die Bemerkung nicht eröffnen. Im Versuch schlug Please quote #XYZ# when you pay fehl, ebenso Order #123# delivered in full, weil 123 zwischen zwei Rauten steht.

Nichts wird bereinigt oder in Großbuchstaben umgewandelt. Im Versuch schlug #aai# fehl, ebenso das erfundene #INF#. Die Suche durchsucht die Liste als eine Zeichenkette aus Codes, die durch Leerzeichen getrennt sind, daher können drei Zeichen mit einem Leerzeichen darin bestehen: #A A# bestand im Versuch.

Bemerkungen zu Positionen liegen außerhalb der Regel. Im Versuch bestand #aai# am Anfang einer cbc:Note einer Position.

Wie es in einer Integration dazu kommt

Mögliche Ursachen, abgeleitet aus der Form der Regel und nicht aus gemessener Nutzung:

• Eine Vorlage schreibt den Betreffcode in Kleinbuchstaben, wie im aufgezeichneten Beispiel.
• Die Integration bildet einen Code aus einem Wort, etwa #INF# für Information oder #VAT# für einen Steuerhinweis, statt ihn der Liste zu entnehmen.
• Vom Verkäufer eingegebener Freitext enthält eine Referenz zwischen Rauten, etwa eine Bestellnummer, mit genau drei Zeichen im ersten Paar.

So korrigieren Sie das Dokument

1. Entscheiden Sie, ob die Bemerkung überhaupt einen Betreffcode braucht; eine Bemerkung ohne ihn ist gültig.
2. Wenn ja, nehmen Sie den Code aus UNTDID 4451 und schreiben Sie ihn in Großbuchstaben zwischen zwei Rauten ganz an den Anfang der Bemerkung, dann den Text: #AAI# für General information.
3. Kann Freitext # enthalten, ersetzen Sie das Zeichen vor dem Schreiben der Bemerkung, oder setzen Sie einen echten Betreffcode an den Anfang, damit das erste Rautenpaar immer ihn enthält.
4. Bieten Sie die Betreffcodes, die Ihr System verwendet, als feste, gegen die Liste geprüfte Auswahl an, statt Benutzer sie eintippen zu lassen.

Korrigierte Rechnung prüfen

Vorher und nachher

Dies sind Ausschnitte, keine vollständigen Dokumente. Die vollständigen synthetischen Dokumente, aus denen sie stammen, sind unten verlinkt.

Ausschnitt der fehlerhaften Rechnung: der Betreffcode der Bemerkung ist kleingeschrieben

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:Note>#aai#Please quote the invoice number when you pay</cbc:Note>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>

Ausschnitt der korrigierten Rechnung: der Betreffcode ist AAI, General information

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:Note>#AAI#Please quote the invoice number when you pay</cbc:Note>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>

Nur die Schreibweise des Betreffcodes unterscheidet sich: #aai# in der fehlerhaften Rechnung, #AAI# in der korrigierten, mit demselben Text danach. Das fehlerhafte Dokument meldet nur BR-CL-08, und der Peppol-Prüfschritt bestand.

Wo die Regel gilt

• Gilt für Invoice und CreditNote; #aai# am Anfang der cbc:Note einer Gutschrift meldete im Versuch nur diese Regel.
• Der Peppol-Prüfschritt betrachtet keine Betreffcodes, begrenzt aber die Zahl der Bemerkungen: Sofern nicht Verkäufer und Käufer beide deutsch sind, wird eine zweite cbc:Note von PEPPOL-EN16931-R002 gemeldet. Im Versuch meldeten zwei Bemerkungen, deren zweite mit #aai# begann, beide Regeln.
• Die festgelegte Liste umfasst 383 Codes. Prüfen Sie einen Code gegen die Liste dieses Release und nicht gegen eine ältere Fassung von UNTDID 4451.

Verwandte Regeln

• PEPPOL-EN16931-R002 erlaubt außerhalb des innerdeutschen Handels nur eine Bemerkung zur Rechnung
• PEPPOL-EN16931-CL003 lehnt einen Betreffcode wie DEL ab, wenn er als Code für den Grund eines Zuschlags wiederverwendet wird
• Alle Regeln der Referenz ansehen
• Hintergrund (auf Englisch): Understanding EN 16931 validation errors

Umfang und Quelle

Geschrieben für Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, angewendet auf Invoice- und CreditNote-Dokumente in UBL 2.1. Andere Profile, Syntaxen und Releases können diese Kennung anders definieren. Version des Hinweiskatalogs 2026-09-28.1: Quelle geprüft am 2026-09-28, Erklärung zuletzt aktualisiert am 2026-09-28.

Die offizielle Definition von BR-CL-08 (auf Englisch) enthält den normativen Wortlaut und den Test. Diese Seite ist unsere Erklärung dazu, keine Kopie.

Die Erklärung ändert das Urteil der Engine nicht. Dass Sie diesen Befund beheben, heißt nicht, dass das Dokument jeden Prüfschritt besteht. Die Validierung bescheinigt keine rechtliche oder steuerliche Konformität und überträgt kein Dokument über Peppol.