Zum Inhalt springen

Ironfang Finance - Regelreferenz

PEPPOL-EN16931-P0101: Einen Gutschrift-Typcode verwenden, den Peppol BIS Billing erlaubt

In einer Peppol-Gutschrift muss cbc:CreditNoteTypeCode 381, 396, 81, 83 oder 532 sein. Ein Rechnungscode wie 380 wird abgelehnt.

Peppol BIS BillingFehler: Das Dokument ist ungültigCodelistenProzess und Referenzen

Auf dieser Seite

Die kurze Antwort

PEPPOL-EN16931-P0101 schlägt fehl, wenn der cbc:CreditNoteTypeCode einer CreditNote keiner der fünf Codes ist, die Peppol BIS Billing für Gutschriften erlaubt. Schreiben Sie für eine gewöhnliche Gutschrift 381.

Ein Rechnungscode in einer Gutschrift, wie das 380 im aufgezeichneten Beispiel, schlägt außerdem bei der Codelisten-Prüfung BR-CL-01 von EN 16931 fehl. Ist das Dokument wirklich eine Rechnung, erzeugen Sie ein Invoice-Dokument, statt den Code zu ändern.

Was die Regel prüft

Die Regel liest cbc:CreditNoteTypeCode, entfernt umgebende Leerzeichen und akzeptiert genau 381 (Gutschrift), 396 (Factoring-Gutschrift), 81 (Gutschrift für Waren oder Dienstleistungen), 83 (Gutschrift aufgrund finanzieller Anpassungen) und 532 (Gutschrift des Spediteurs).

EN 16931 erlaubt mehr Gutschriftcodes als Peppol. 261 bestand im Versuch BR-CL-01 und schlug nur bei dieser Regel fehl.

Ein Code aus dem Rechnungsteil von UNTDID 1001 scheitert an beiden Listen. 380, 383 und 384 in einer Gutschrift meldeten im Versuch jeweils diese Regel zusammen mit BR-CL-01.

Wie ihr Gegenstück für Rechnungen läuft die Regel nur bei einer bekannten Geschäftsprozesskennung. Eine Gutschrift mit 380 unter einer unbekannten cbc:ProfileID meldete BR-CL-01 und PEPPOL-EN16931-R007, aber nicht diese Regel.

BegriffBedeutungUBL-Element
BT-3Code für den Rechnungstypcbc:CreditNoteTypeCode
BT-23Geschäftsprozesstypcbc:ProfileID

Wie es in einer Integration dazu kommt

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

  • Im Quellsystem dient ein Typcode-Feld beiden Dokumenten und enthält für alles 380, während das Wurzelelement anhand des Vorzeichens der Summe gewählt wird.
  • Eine Rechnungskorrektur (384) oder eine Belastungsanzeige (383) wird als CreditNote ausgestellt, weil ihre Beträge negativ sind.
  • Die Codetabelle für Gutschriften wurde aus der Liste von EN 16931 kopiert statt aus der Peppol-Teilmenge.

So korrigieren Sie das Dokument

  1. Bestätigen Sie, dass das Dokument eine Gutschrift ist, also einen zuvor in Rechnung gestellten Betrag mindert oder storniert. Wenn ja, behalten Sie die Wurzel CreditNote und verwenden Sie 381, oder 396, 81, 83 oder 532, wenn einer davon das Dokument besser beschreibt.
  2. Sagt die Quelle, dass das Dokument eine Rechnung ist, erzeugen Sie stattdessen eine Invoice mit cbc:InvoiceTypeCode. Die Positions- und Mengenelemente heißen in den beiden Dokumenten unterschiedlich, es ist also eine andere Ausgabe, keine umbenannte Wurzel.
  3. Leiten Sie Typcode und Wurzelelement aus demselben Quellfeld ab, damit die beiden nicht voneinander abweichen können.

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 Gutschrift: der Handelsrechnungscode 380 in einer Gutschrift

<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>EXAMPLE-CN-001</cbc:ID>
<cbc:IssueDate>2026-09-08</cbc:IssueDate>
<cbc:CreditNoteTypeCode>380</cbc:CreditNoteTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>

Ausschnitt der korrigierten Gutschrift: 381, Gutschrift

<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>EXAMPLE-CN-001</cbc:ID>
<cbc:IssueDate>2026-09-08</cbc:IssueDate>
<cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>

Nur cbc:CreditNoteTypeCode unterscheidet sich: 380 in der fehlerhaften Gutschrift, 381 in der korrigierten. Das fehlerhafte Dokument meldet außerdem BR-CL-01 aus dem Prüfschritt EN 16931, weil 380 auch in EN 16931 kein Gutschriftcode ist. Ein falscher Wert erzeugt in jedem Prüfschritt einen Befund, und 381 behebt beide.

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 nur für UBL CreditNote. Der Rechnungstyp-Code wird von PEPPOL-EN16931-P0100 gegen eine andere Liste geprüft.
  • Die fünf Codes gelten unter jeder bekannten Prozesskennung; 261 schlug im Versuch auch unter urn:peppol:bis:billing_with_response fehl.
  • Ein leerer cbc:CreditNoteTypeCode meldete im Versuch diese Regel zusammen mit BR-04, BR-CL-01 und PEPPOL-EN16931-R008.

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-P0101 (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.