Zum Inhalt springen

Ironfang Finance - Regelreferenz

PEPPOL-EN16931-R003: Eine Käuferreferenz oder eine Bestellreferenz hinzufügen

Das Dokument hat weder cbc:BuyerReference noch cac:OrderReference/cbc:ID. Peppol verlangt mindestens eine davon, damit der Käufer die Rechnung weiterleiten kann.

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

Auf dieser Seite

Die kurze Antwort

PEPPOL-EN16931-R003 schlägt fehl, wenn das Dokument weder eine Käuferreferenz noch eine Bestellreferenz trägt. Fügen Sie cbc:BuyerReference oder cac:OrderReference mit einer cbc:ID hinzu und verwenden Sie die Referenz, die Ihnen der Käufer tatsächlich gegeben hat. Jede der beiden erfüllt die Regel; beide dürfen gesendet werden.

Der Wert muss vom Käufer stammen. Sein System leitet das Dokument damit an die richtige Person weiter oder ordnet es einer Bestellung zu; ein erfundener Platzhalter besteht daher die Prüfung und bleibt dann auf seiner Seite hängen.

Was die Regel prüft

Die Regel sucht an der Dokumentwurzel nach zwei Dingen: einem Element cbc:BuyerReference und einer cbc:ID innerhalb von cac:OrderReference. Sie besteht, wenn mindestens eines vorhanden ist. Eine Rechnung nur mit Bestellreferenz besteht, ebenso eine nur mit Käuferreferenz.

Nur Referenzen auf Dokumentenebene zählen. Ein Bezug auf eine Bestellposition an einer Rechnungsposition (cac:OrderLineReference) erfüllt die Regel nicht.

Geprüft wird die Anwesenheit, nicht der Inhalt. Eine leere cbc:BuyerReference meldet diese Regel nicht, aber sie meldet PEPPOL-EN16931-R008 für das leere Element und ist daher kein Weg um die Anforderung herum.

BegriffBedeutungUBL-Element
BT-10Käuferreferenzcbc:BuyerReference
BT-13Bestellreferenzcac:OrderReference/cbc:ID

Wie es in einer Integration dazu kommt

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

  • Die Käuferreferenz ist ein optionales Feld im Kunden- oder Auftragsdatensatz und wurde für diesen Kunden leer gelassen.
  • Die Quellrechnung hat eine Bestellnummer, die aber auf eine Bemerkung oder ein Feld auf Positionsebene abgebildet wird und nicht auf cac:OrderReference/cbc:ID.
  • Der Serialisierer lässt Elemente weg, deren Quellwert null ist, sodass eine fehlende Referenz stillschweigend verschwindet und nichts im Vorfeld die Rechnung aufhält.
  • Eine Auftragsnummer des Verkäufers ist vorhanden, aber keine Bestellnummer, und cac:OrderReference wurde weggelassen, weil seine cbc:ID nicht gefüllt werden konnte.

So korrigieren Sie das Dokument

  1. Klären Sie, welche Referenz der Käufer erwartet: eine Leitreferenz, die er an Lieferanten ausgibt, oder die Nummer der Bestellung, die in Rechnung gestellt wird.
  2. Ist es eine Käuferreferenz, schreiben Sie sie in cbc:BuyerReference. In der UBL-Reihenfolge folgt sie auf cbc:DocumentCurrencyCode und cbc:AccountingCost und steht vor cac:OrderReference.
  3. Ist es eine Bestellnummer, schreiben Sie sie in cac:OrderReference/cbc:ID. Das UBL-Schema verlangt cbc:ID, sobald cac:OrderReference vorhanden ist; eine cac:OrderReference, die nur cbc:SalesOrderID enthält, scheitert daher am XSD-Prüfschritt, bevor diese Regel läuft.
  4. Machen Sie die Referenz bei der Auftragserfassung oder Rechnungsfreigabe für Kunden, die über Peppol Rechnungen erhalten, zur Pflicht, damit die Lücke auffällt, bevor das XML erzeugt wird.

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: keine Käuferreferenz, und das Dokument hat auch keine Bestellreferenz

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cac:AccountingSupplierParty>
  <!-- seller party omitted from this fragment -->
</cac:AccountingSupplierParty>

Ausschnitt der korrigierten Rechnung: Die Käuferreferenz ist vorhanden

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>
<cac:AccountingSupplierParty>
  <!-- seller party omitted from this fragment -->
</cac:AccountingSupplierParty>

Der einzige Unterschied ist die Zeile cbc:BuyerReference. Das fehlerhafte Dokument meldet nur PEPPOL-EN16931-R003; der Prüfschritt EN 16931 besteht, weil der Kernstandard beide Referenzen als optional behandelt.

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 ohne beide Referenzen meldet dieselbe Regel, und eine Gutschrift nur mit cac:OrderReference/cbc:ID besteht.
  • Dies ist eine Peppol-Anforderung zusätzlich zu EN 16931 und erscheint daher nur im Peppol-Prüfschritt.
  • Die Regel prüft nicht, ob der Käufer die Referenz kennt. Das lässt sich nur mit dem Käufer klären.

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-20.

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