PEPPOL-EN16931-R004 är ett fatalt valideringsfel i Peppol BIS Billing. Det betyder att specifikationsidentifieraren i BT-24, som representeras av cbc:CustomizationID, inte följer det identifierarformat som krävs för en faktura eller kreditnota enligt Peppol BIS Billing 3.0. Dokumentet uppfyller inte kraven och bör inte skickas genom Peppol-nätverket förrän värdet har rättats.
| Fält | Värde |
| Regel | PEPPOL-EN16931-R004 |
| Allvarlighetsgrad | Fatal |
| Valideringslager | Peppol BIS |
| Berört fält | cbc:CustomizationID (BT-24) |
| Gäller för | UBL Invoice och CreditNote |
| Beskriven version | Peppol BIS Billing 3.0.21 |
Vad felet betyder
CustomizationID anger för valideraren och det mottagande systemet vilken specifikation och vilka affärsregler dokumentet uppger sig följa. För ett standarddokument enligt Peppol BIS Billing 3.0 identifierar värdet både överensstämmelse med EN 16931 och Peppols användningsspecifikation för fakturering.
Detta är inte ett Peppol-ID för en deltagare och identifierar varken avsändaren eller mottagaren. Det skiljer sig också från ProfileID, som identifierar den affärsprocess där dokumentet utbyts.
Vad PEPPOL-EN16931-R004 kontrollerar
Den aktuella OpenPeppol-regeln kontrollerar att det normaliserade värdet i CustomizationID:
- börjar med den identifierare som krävs för Peppol BIS Billing 3.0, och
- inte innehåller ett versionssuffix med dubbla kolon, skrivet som
::.
För en standardfaktura eller kreditnota enligt Peppol BIS Billing 3.0 ska ni använda det kanoniska värdet nedan exakt som det visas:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0Behåll värdet som en sammanhängande teckensträng. Valideringstestet normaliserar visserligen blanktecken före kontrollen, men det kanoniska värdet utan tillagda blanksteg, radbrytningar eller suffix minskar risken för tvetydighet och mappningsfel.
Varför versionssuffix underkänns
OpenPeppol uppdaterade den fatala regeln R004 i Peppol BIS Billing 3.0.21 för att förtydliga kravet: CustomizationID får inte innehålla versionsinformation. Versionen publicerades i maj 2026 och blev obligatorisk den 17 augusti 2026. Ett värde som har kopierats från en äldre implementation kan därför underkännas av aktuell validering om det slutar med ett versionssuffix som ::2.1 eller ::3.0.
Vanliga orsaker
- Fel specifikation: affärssystemet eller konverteraren infogar en identifierare för en annan CIUS, ett annat format eller ett annat nätverk.
- Ofullständig identifierare: värdet anger EN 16931 men saknar delen för Peppol BIS Billing.
- Versionsinformation har lagts till: värdet slutar med ett suffix med dubbla kolon som den aktuella regeln avvisar.
- Elementet saknas eller är tomt:
cbc:CustomizationIDsaknas, är tomt eller ligger i fel XML-namnområde. Detta kan även utlösa BR-01. - Felaktig mappning i källsystemet: en mall, en mappning i mellanprogramvara eller en exportinställning skapar fel värde i varje dokument.
Så åtgärdar ni PEPPOL-EN16931-R004
- Öppna den genererade XML-filen. Leta upp
cbc:CustomizationIDnära början av rotelementetInvoiceellerCreditNoteelementet. - Kontrollera hela värdet. Leta efter en förkortad identifierare, ett värde från ett annat format, ett skrivfel eller ett tillagt
::versionssuffix. - Ange den kanoniska identifieraren. För standardformatet Peppol BIS Billing 3.0 ersätter ni värdet med identifieraren ovan.
- Rätta konfigurationen i källsystemet. Uppdatera den export, dokumentmall eller transformationsmappning som genererade värdet. Om ni endast redigerar en enskild XML-fil finns det underliggande felet kvar.
- Generera och validera ett nytt dokument. Kör hela XML-dokumentet genom aktuella valideringsartefakter för Peppol BIS Billing innan ni försöker leverera det på nytt.
Om dokumentet avsiktligt bygger på en annan CIUS, nationell specifikation eller PINT-profil ska ni inte ersätta identifieraren utan kontroll. Bekräfta vilket CustomizationID som specifikationen kräver och validera dokumentet mot motsvarande regeluppsättning.
XML-exempel
Korrekt för standardformatet Peppol BIS Billing 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>Fel: ofullständig identifierare
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>Fel: versionsinformation har lagts till
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>Om BR-01 också visas
BR-01 kräver att varje faktura och kreditnota innehåller en specifikationsidentifierare i BT-24. Om CustomizationID saknas, är tomt eller inte känns igen i det förväntade namnområdet kan valideraren rapportera både BR-01 och R004. Korrigera elementets förekomst, namnområde och värde och validera därefter det nygenererade dokumentet. Behandla inte de två meddelandena som orelaterade fel.
CustomizationID och ProfileID kan inte ersätta varandra
| Element | Syfte |
cbc:CustomizationID | Identifierar den specifikation och regeluppsättning som dokumentet följer. |
cbc:ProfileID | Identifierar den affärsprocess där dokumentet utbyts. |
Att ändra ProfileID löser inte PEPPOL-EN16931-R004. Felet gäller CustomizationID.
Relaterad vägledning
Normativ källa
Valideringskravet och regeltestet publiceras av OpenPeppol. Den här artikeln ger Qvalias praktiska förklaring och implementeringsvägledning. Använd alltid de valideringsartefakter som gäller för dokumentet och den aktuella Peppol-versionen.