1. Startseite
  2. Wissensdatenbank
  3. Peppol
  4. So beheben Sie den Fehler PEPPOL-EN16931-R004

So beheben Sie den Fehler PEPPOL-EN16931-R004

So beheben Sie den Fehler PEPPOL-EN16931-R004

PEPPOL-EN16931-R004 ist ein schwerwiegender Validierungsfehler gemäß der Peppol- BIS Billing . Dies bedeutet, dass die Spezifikationskennung in BT-24, dargestellt durch cbc:CustomizationID, entspricht nicht dem für eine Peppol-Rechnung oder -Gutschrift gemäß „ BIS Billing “ 3.0 vorgeschriebenen Identifikationsformat. Das Dokument ist nicht konform und sollte erst dann über das Peppol-Netzwerk versendet werden, wenn der Wert korrigiert wurde.

FeldWert
RegelPEPPOL-EN16931-R004
SchweregradTödlich
ValidierungsschichtPeppol BIS
Betroffenes Feldcbc:CustomizationID (BT-24)
Gilt fürUBL-Rechnung und Gutschrift
Release beschriebenPeppol- BIS Billing , Version 3.0.21

Was bedeutet dieser Fehler?

CustomizationID Teilt einem Validator und einem empfangenden System mit, welcher Spezifikation und welchen Geschäftsregeln das Dokument angeblich entspricht. Bei einem Standarddokument gemäß Peppol „ BIS Billing “ 3.0 gibt der Wert sowohl die Konformität mit EN 16931 als auch die Anwendungsspezifikation „Peppol Billing“ an.

Dies ist keine Peppol-Teilnehmer-ID und dient nicht zur Identifizierung des Absenders oder Empfängers. Sie unterscheidet sich zudem von ProfileID, das den Geschäftsprozess angibt, in dessen Rahmen das Dokument ausgetauscht wird.

Was PEPPOL-EN16931-R004 überprüft

Die aktuelle OpenPeppol-Regel prüft, ob die normalisierte CustomizationID:

  • beginnt mit der erforderlichen Peppol-Kennung „ BIS Billing “ 3.0; und
  • enthält kein Versionssuffix mit doppeltem Doppelpunkt, geschrieben als ::.

Verwenden Sie für eine Standardrechnung oder Gutschrift gemäß Peppol „ BIS Billing “ 3.0 den unten aufgeführten kanonischen Wert genau wie angegeben:

urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0

Behalten Sie die Zeichenfolge als eine zusammenhängende Zeichenfolge bei. Auch wenn der Validierungstest Leerzeichen vor der Überprüfung des Werts normalisiert, lassen sich durch die Verwendung des kanonischen Werts ohne zusätzliche Leerzeichen, Zeilenumbrüche oder Suffixe Mehrdeutigkeiten und Zuordnungsfehler vermeiden.

Warum Versions-Suffixe versagen

OpenPeppol hat die kritische R004-Regel im Peppol- BIS Billing , Version 3.0.21, aktualisiert, um die Anforderung ausdrücklich zu formulieren: CustomizationID dürfen keine Versionsangaben enthalten. Die „ release “ wurde im Mai 2026 veröffentlicht und trat am 17. August 2026 in Kraft. Ein Wert, der aus einer älteren Implementierung kopiert wurde, kann daher bei der aktuellen Validierung fehlschlagen, wenn er mit einem Versionssuffix wie beispielsweise ::2.1 oder ::3.0.

Häufige Ursachen

  • Falsche Spezifikation: Das ERP-System oder der Konverter fügt eine Kennung für ein anderes CIUS, ein anderes Format oder ein anderes Netzwerk ein.
  • Unvollständiger Bezeichner: Der Wert deklariert EN 16931, lässt jedoch den Peppol-Teil „ BIS Billing “ weg.
  • Angefügte Versionsinformationen: Der Wert endet mit einem Doppelkolon als Suffix, das von der aktuellen Regel abgelehnt wird.
  • Fehlendes oder leeres Element: cbc:CustomizationID fehlt, ist leer oder wurde im falschen XML-Namespace geschrieben. Dies kann ebenfalls den Fehler BR-01 auslösen.
  • Falsche Quellzuordnung: Eine Vorlage, eine Middleware-Zuordnung oder eine Exporteinstellung erzeugt für jedes Dokument den falschen Wert.

So beheben Sie den Fehler PEPPOL-EN16931-R004

  1. Öffnen Sie die generierte XML-Datei. Suchen cbc:CustomizationID nahe dem Anfang der Wurzel Invoice oder CreditNote Element.
  2. Überprüfen Sie den vollständigen Wert. Achten Sie auf eine verkürzte Kennung, einen Wert aus einem anderen Format, einen Tippfehler oder einen angehängten :: Versions-Suffix.
  3. Legen Sie die kanonische Kennung fest. Bei der Standard-Peppol- BIS Billing on 3.0 ersetzen Sie den Wert durch die oben angegebene Kennung.
  4. Korrigieren Sie die Quellkonfiguration. Aktualisieren Sie den ERP-Export, die Dokumentvorlage oder das Transformations-Mapping, durch das der Wert generiert wurde. Wenn Sie nur eine XML-Datei bearbeiten, bleibt der zugrunde liegende Fehler bestehen.
  5. Erstellen und validieren Sie ein neues Dokument. Führen Sie das vollständige XML durch die aktuellen Peppol-Validierungswerkzeuge unter BIS Billing , bevor Sie einen erneuten Versandversuch unternehmen.

Falls das Dokument bewusst auf einem anderen CIUS, einer nationalen Spezifikation oder einem PINT-Profil basiert, ersetzen Sie die Kennung nicht einfach blindlings. Vergewissern Sie sich, dass die CustomizationID die in dieser Spezifikation gefordert sind, und das Dokument anhand des entsprechenden Regelsatzes überprüfen.

XML-Beispiele

Entspricht dem Peppol-Standard „ BIS Billing “ 3.0

<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>

Falsch: unvollständiger Bezeichner

<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>

Falsch: Versionsangaben angehängt

<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>

Falls auch BR-01 auftaucht

Gemäß BR-01 muss jede Rechnung und jede Gutschrift eine Spezifikationskennung in BT-24 enthalten. Wenn CustomizationID fehlt, ist leer oder wird im erwarteten Namensraum nicht erkannt; in diesem Fall kann ein Validator sowohl BR-01 als auch R004 melden. Korrigieren Sie das Vorhandensein, den Namensraum und den Wert des Elements und validieren Sie anschließend das neu generierte Dokument. Behandeln Sie die beiden Meldungen nicht als voneinander unabhängige Fehler.

CustomizationID und ProfileID sind nicht austauschbar

ElementZweck
cbc:CustomizationIDGibt die Spezifikation und den Regelsatz an, denen das Dokument entspricht.
cbc:ProfileIDGibt den Geschäftsprozess an, in dessen Rahmen das Dokument ausgetauscht wird.

Ändern ProfileID wird den Fehler PEPPOL-EN16931-R004 nicht beheben. Der Fehler betrifft CustomizationID.

Normative Quelle

Die Validierungsanforderungen und Regeltests werden von OpenPeppol veröffentlicht. Dieser Artikel enthält eine praxisnahe Erläuterung sowie Implementierungshinweise von Qvalia. Verwenden Sie stets die für das Dokument geltenden Validierungsartefakte sowie die aktuelle Peppol- release.

War dieser Artikel hilfreich?

Verwandte Artikel