PEPPOL-EN16931-R004 je kritická chyba validácie v rámci Peppol BIS Billing . Znamená to, že identifikátor špecifikácie v poli BT-24, ktorý je reprezentovaný cbc:CustomizationID, nespĺňa formát identifikátora požadovaný pre faktúru alebo dobropis podľa špecifikácie Peppol „ BIS Billing “ verzie 3.0. Dokument nie je v súlade s požiadavkami a nemal by sa odosielať cez sieť Peppol, kým nebude hodnota opravená.
| Pole | Hodnota |
| Pravidlo | PEPPOL-EN16931-R004 |
| Závažnosť | Smrteľný |
| Validačná vrstva | Peppol BIS |
| Ovplyvnené pole | cbc:CustomizationID (BT-24) |
| Platí pre | Faktúra a dobropis UBL |
| Release opísané | Peppol BIS Billing 3.0.21 |
Čo táto chyba znamená
CustomizationID uvádza validátorovi a prijímajúcemu systému, ktorú špecifikáciu a ktoré obchodné pravidlá má dokument podľa vlastného tvrdenia dodržiavať. V prípade štandardného dokumentu Peppol typu „ BIS Billing “ 3.0 táto hodnota identifikuje jednak súlad s normou EN 16931, jednak špecifikáciu použitia Peppol Billing.
Toto nie je identifikačné číslo účastníka systému Peppol a neslúži na identifikáciu odosielateľa ani príjemcu. Liší sa tiež od ProfileID, ktorý identifikuje obchodný proces, v rámci ktorého dochádza k výmene dokumentu.
Čo kontroluje PEPPOL-EN16931-R004
Súčasné pravidlo OpenPeppol overuje, či normalizovaný CustomizationID:
- začína požadovaným identifikátorom Peppol BIS Billing 3.0; a
- neobsahuje príponu verzie s dvojitými dvojbodkami, ktorá sa píše ako
::.
V prípade štandardnej faktúry alebo dobropisu podľa špecifikácie Peppol „ BIS Billing “ verzie 3.0 použite nižšie uvedenú kanonickú hodnotu presne tak, ako je uvedené:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0Nechajte to ako jeden súvislý reťazec. Hoci validačný test pred kontrolou hodnoty normalizuje medzery, použitie kanonickej hodnoty bez pridaných medzier, riadkovacích znakov alebo prípon zabráni nejednoznačnosti a chybám pri mapovaní.
Prečo prípony verzií zlyhávajú
OpenPeppol aktualizoval pravidlo R004 s fatálnou chybou v Peppol BIS Billing 3.0.21, aby túto požiadavku jasne formuloval: CustomizationID nesmie obsahovať informácie o verzii. Špecifikácia „ release “ bola uverejnená v máji 2026 a stala sa záväznou 17. augusta 2026. Hodnota skopírovaná zo staršej implementácie preto môže zlyhať pri súčasnej validácii, ak končí príponou verzie, ako napríklad ::2.1 alebo ::3.0.
Bežné príčiny
- Nesprávna špecifikácia: systém ERP alebo konvertor vloží identifikátor iného CIUS, formátu alebo siete.
- Neúplný identifikátor: hodnota deklaruje normu EN 16931, ale chýba v nej časť „ BIS Billing “ podľa Peppolu.
- Pridané informácie o verzii: hodnota končí príponou v podobe dvoch dvojbodiek, ktorú aktuálne pravidlo odmieta.
- Chýbajúci alebo prázdny prvok:
cbc:CustomizationIDchýba, je prázdny alebo je napísaný v nesprávnom mennom priestore XML. To môže tiež vyvolať chybu BR-01. - Nesprávne priradenie zdrojov: šablóna, priradenie prostredníctvom middleware alebo nastavenie exportu generuje nesprávnu hodnotu pre každý dokument.
Ako opraviť chybu PEPPOL-EN16931-R004
- Otvorte vygenerovaný súbor XML. Nájsť
cbc:CustomizationIDv blízkosti začiatku koreňaInvoicealeboCreditNoteprvok. - Skontrolujte celkovú hodnotu. Hľadajte skrátený identifikátor, hodnotu z iného formátu, preklep alebo pridaný
::prípona verzie. - Nastavte kanonický identifikátor. V prípade štandardu Peppol „ BIS Billing “ 3.0 nahraďte túto hodnotu identifikátorom uvedeným vyššie.
- Opravte konfiguráciu zdroja. Aktualizujte export z ERP, šablónu dokumentu alebo transformačné mapovanie, ktoré túto hodnotu vygenerovalo. Úprava iba jedného súboru XML nezruší základnú chybu.
- Vytvorte a overte nový dokument. Pred ďalším pokusom o odoslanie spustite kompletný XML súbor cez aktuálne validačné nástroje Peppol BIS Billing .
Ak je dokument zámerne založený na inom CIUS, národnej špecifikácii alebo profile PINT, identifikátor nenahrádzajte bez rozmyslu. Overte si, či CustomizationID požadované v tejto špecifikácii a overiť súlad dokumentu s príslušným súborom pravidiel.
Príklady XML
V súlade so štandardom Peppol „ BIS Billing “ verzie 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>Nesprávne: neúplný identifikátor
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>Nesprávne: pridané informácie o verzii
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>Ak sa objaví aj BR-01
BR-01 vyžaduje, aby každá faktúra a dobropis obsahovali identifikačný kód špecifikácie v poli BT-24. Ak CustomizationID chýba, je prázdny alebo nie je rozpoznaný v očakávanom mennom priestore, validátor môže nahlásiť chybu BR-01 aj R004. Opravte prítomnosť, menný priestor a hodnotu prvku a následne overte platnosť znovu vygenerovaného dokumentu. Tieto dve hlásenia nepovažujte za nesúvisiace chyby.
CustomizationID a ProfileID nie sú navzájom zameniteľné
| Prvok | Účel |
cbc:CustomizationID | Určuje špecifikáciu a súbor pravidiel, ktorými sa dokument riadi. |
cbc:ProfileID | Určuje obchodný proces, v rámci ktorého dochádza k výmene dokumentu. |
Zmena ProfileID nevyrieši chybu PEPPOL-EN16931-R004. Chyba sa týka CustomizationID.
Súvisiace usmernenia
Normatívny zdroj
Požiadavky na validáciu a testy pravidiel zverejňuje organizácia OpenPeppol. Tento článok obsahuje praktické vysvetlenie a pokyny k implementácii od spoločnosti Qvalia. Vždy používajte validačné artefakty, ktoré sa vzťahujú na daný dokument, a aktuálnu verziu Peppol release.