Zum Inhalt springen

Ironfang Finance - Regelreferenz

PEPPOL-EN16931-R002: Nur eine Bemerkung auf Dokumentenebene verwenden

Peppol erlaubt eine cbc:Note direkt unter der Wurzel, außer wenn Verkäufer und Käufer beide deutsche Postanschriften haben. Fassen Sie die Texte in einer Bemerkung zusammen.

Peppol BIS BillingFehler: Das Dokument ist ungültigKernfelder

Auf dieser Seite

Die kurze Antwort

PEPPOL-EN16931-R002 schlägt fehl, wenn die Wurzel Invoice oder CreditNote zwei oder mehr cbc:Note-Kindelemente hat und Verkäufer und Käufer nicht beide in Deutschland sind. Fassen Sie die Texte in einer einzigen cbc:Note zusammen oder verschieben Sie jede Angabe in das Element, das dafür vorgesehen ist.

EN 16931 selbst erlaubt mehrere Bemerkungen zur Rechnung, deshalb besteht der Prüfschritt EN 16931. Die Grenze ist eine Einschränkung von Peppol.

Was die Regel prüft

Die Regel zählt nur cbc:Note-Elemente, die direkte Kindelemente der Wurzel sind. Bemerkungen an Positionen, in Zahlungsbedingungen oder anderswo werden nicht gezählt: Die korrigierte Rechnung hat neben ihrer einen Dokumentbemerkung eine Positionsbemerkung und eine Bemerkung in den Zahlungsbedingungen und besteht.

Leere Bemerkungen zählen. Eine leere zweite Bemerkung wurde im Versuch von dieser Regel und von PEPPOL-EN16931-R008 gemeldet.

Die Ausnahme setzt voraus, dass der Ländercode der Postanschrift beider Parteien DE ist. War nur der Verkäufer oder nur der Käufer auf DE gesetzt, schlug die Regel im Versuch weiterhin fehl. Das Präfix der Umsatzsteuer-Identifikationsnummer wird nicht herangezogen.

Es gibt einen Befund je Dokument, an der Wurzel, unabhängig von der Zahl der Bemerkungen; drei Bemerkungen ergaben im Versuch einen einzigen Befund.

BegriffBedeutungUBL-Element
BT-22Bemerkung zur Rechnungcbc:Note
BT-40Ländercode des Verkäuferscac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode
BT-55Ländercode des Käuferscac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode

Wie es in einer Integration dazu kommt

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

  • Jedes Bemerkungsfeld im Quellsystem, etwa eine Lieferanweisung, ein rechtlicher Hinweistext oder ein freier Kommentar, wird als eigene cbc:Note geschrieben.
  • Zahlungsanweisungen oder Bankverbindung werden als zusätzliche Bemerkung gesendet statt in cac:PaymentTerms oder cac:PaymentMeans.
  • Eine Zuordnung, die für deutsche Inlandsrechnungen gebaut wurde, bei denen mehrere Bemerkungen erlaubt sind, wird für andere Länder wiederverwendet.
  • Eine Vorlage fügt eine feste Bemerkung hinzu, und der Export hängt den Kommentar des Benutzers als zweite an.

So korrigieren Sie das Dokument

  1. Sammeln Sie alles, was in die Bemerkung auf Dokumentenebene gehört, und schreiben Sie es als eine cbc:Note, die Teile durch einen Zeilenumbruch oder Satzzeichen getrennt.
  2. Verschieben Sie Text, der einen eigenen Platz hat: Zahlungsbedingungen nach cac:PaymentTerms/cbc:Note, eine Bemerkung zu einer Position in die cbc:Note dieser Position und Bank- oder Überweisungsangaben nach cac:PaymentMeans.
  3. Lassen Sie Bemerkungen ohne Inhalt weg, auch leere.
  4. Senden Sie mehrere Bemerkungen nur, wenn die Postanschriften beider Parteien wirklich in Deutschland liegen; ändern Sie nie eine Anschrift, um die Ausnahme zu erreichen.

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: Auf die erste Bemerkung auf Dokumentenebene folgt eine zweite

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<!-- first document-level cbc:Note omitted from this fragment -->
<cbc:Note>Second example note</cbc:Note>
<cbc:TaxPointDate>2026-09-07</cbc:TaxPointDate>

Ausschnitt der korrigierten Rechnung: Nur die erste Bemerkung bleibt

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<!-- the single document-level cbc:Note omitted from this fragment -->
<cbc:TaxPointDate>2026-09-07</cbc:TaxPointDate>

Die fehlerhafte Rechnung hat nach der ersten eine zweite cbc:Note, Second example note; die korrigierte Rechnung behält nur die erste Bemerkung. Das fehlerhafte Dokument meldet nur PEPPOL-EN16931-R002. Beide Parteien im Beispiel haben britische Postanschriften, daher greift die deutsche Ausnahme nicht.

Was der Validator gemeldet hat

Aufgezeichnet mit phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, der Engine hinter dem kostenlosen Validator, mit synthetischen Daten. Ein aufgezeichnetes Ergebnis ist ein Regressionsnachweis für diese Dokumente, keine Zertifizierung.

Wo die Regel gilt

  • Gilt gleichermaßen für UBL Invoice und CreditNote; eine Gutschrift mit zwei Bemerkungen meldete im Versuch diese Regel.
  • Als beide Länder der Postanschriften auf DE gesetzt waren, entfiel diese Regel, und die deutschen nationalen Peppol-Regeln verlangten stattdessen Ort und Postleitzahl der Lieferung. Dokumente zwischen deutschen Parteien haben eigene Anforderungen.
  • Für Positionsbemerkungen gilt eine eigene Grenze: Eine zweite cbc:Note an einer Position wird von UBL-SR-34 gemeldet, nicht von dieser Regel.
  • Dokumentbemerkungen stehen nach dem Typcode und vor cbc:TaxPointDate und cbc:DocumentCurrencyCode. Eine nach cbc:TaxPointDate platzierte Bemerkung scheiterte im Versuch am XSD-Prüfschritt.

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-24.1: Quelle geprüft am 2026-09-24, Erklärung zuletzt aktualisiert am 2026-09-24.

Die offizielle Definition von PEPPOL-EN16931-R002 (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.