PEPPOL-EN16931-R004 je závažná chyba při ověřování v rámci standardu Peppol „ BIS Billing “. Znamená to, že identifikátor specifikace v poli BT-24, který je reprezentován cbc:CustomizationID, neodpovídá formátu identifikátoru požadovanému pro fakturu nebo dobropis ve formátu Peppol BIS Billing 3.0. Dokument není v souladu s požadavky a neměl by být odeslán prostřednictvím sítě Peppol, dokud nebude hodnota opravena.
| Oblast | Hodnota |
| Pravidlo | PEPPOL-EN16931-R004 |
| Závažnost | Smrtelný |
| Validační vrstva | Peppol BIS |
| Ovlivněná oblast | cbc:CustomizationID (BT-24) |
| Platí pro | Faktura a dobropis UBL |
| Release popsáno | Peppol BIS Billing 3.0.21 |
Co tato chyba znamená
CustomizationID uvádí validátoru a přijímajícímu systému, jaké specifikace a obchodní pravidla dokument údajně dodržuje. U standardního dokumentu Peppol „ BIS Billing “ 3.0 tato hodnota označuje jak soulad s normou EN 16931, tak specifikaci použití „Peppol Billing“.
Nejedná se o identifikační číslo účastníka systému Peppol a neslouží k identifikaci odesílatele ani příjemce. Liší se také od ProfileID, který určuje obchodní proces, v rámci něhož dochází k výměně dokumentu.
Co kontroluje norma PEPPOL-EN16931-R004
Současné pravidlo OpenPeppol ověřuje, zda normalizovaný CustomizationID:
- začíná požadovaným identifikátorem Peppol BIS Billing 3.0; a
- neobsahuje příponu verze s dvojitými dvojtečkami, která se zapisuje jako
::.
U standardní faktury nebo dobropisu ve formátu Peppol BIS Billing 3.0 použijte níže uvedenou kanonickou hodnotu přesně tak, jak je zde uvedena:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0Nechte to jako jeden souvislý řetězec. Ačkoli validační test před kontrolou hodnoty normalizuje mezery, použití kanonické hodnoty bez přidaných mezer, konců řádků nebo přípon zabrání nejednoznačnosti a chybám při mapování.
Proč příponám verzí selhávají
OpenPeppol aktualizoval pravidlo R004 s fatální chybou ve verzi Peppol BIS Billing 3.0.21 tak, aby byl tento požadavek jasně formulován: CustomizationID nesmí obsahovat informace o verzi. Dokument „ release “ byl zveřejněn v květnu 2026 a stal se závazným dne 17. srpna 2026. Hodnota zkopírovaná ze starší implementace proto může selhat při aktuální validaci, pokud končí příponou verze, jako je například ::2.1 nebo ::3.0.
Časté příčiny
- Nesprávná specifikace: systém ERP nebo konvertor vkládá identifikátor jiného CIUS, formátu nebo sítě.
- Neúplný identifikátor: hodnota deklaruje normu EN 16931, ale vynechává část týkající se Peppol BIS Billing .
- Byly připojeny informace o verzi: hodnota končí příponou ve formě dvojitého dvojtečky, kterou aktuální pravidlo odmítá.
- Chybějící nebo prázdný prvek:
cbc:CustomizationIDchybí, je prázdný nebo je zapsán v nesprávném jmenném prostoru XML. To může rovněž vyvolat chybu BR-01. - Nesprávné přiřazení zdroje: šablona, přiřazení middlewaru nebo nastavení exportu generuje pro každý dokument nesprávnou hodnotu.
Jak opravit chybu PEPPOL-EN16931-R004
- Otevřete vygenerovaný soubor XML. Najít
cbc:CustomizationIDblízko začátku kořeneInvoiceneboCreditNoteprvek. - Zkontrolujte celkovou hodnotu. Hledejte zkrácený identifikátor, hodnotu v jiném formátu, překlep nebo připojený
::přípona verze. - Nastavte kanonický identifikátor. V případě standardu Peppol „ BIS Billing “ 3.0 nahraďte tuto hodnotu identifikátorem uvedeným výše.
- Opravte konfiguraci zdroje. Aktualizujte export z ERP, šablonu dokumentu nebo transformační mapování, které tuto hodnotu vygenerovalo. Úprava pouze jednoho souboru XML k chybě nevede, protože základní chyba zůstane zachována.
- Vytvořte nový dokument a ověřte jeho správnost. Než se pokusíte o doručení znovu, prověřte celý XML dokument pomocí aktuálních ověřovacích nástrojů Peppol BIS Billing .
Pokud je dokument záměrně založen na jiném CIUS, národní specifikaci nebo profilu PINT, identifikátor nesmějte nahrazovat bez rozmyslu. Ověřte si, zda CustomizationID požadované touto specifikací a ověřit dokument podle příslušného souboru pravidel.
Příklady XML
V souladu se standardem Peppol „ BIS Billing “ verze 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>Nesprávné: neúplný identifikátor
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>Nesprávně: doplněny informace o verzi
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>Pokud se objeví i BR-01
Norma BR-01 vyžaduje, aby každá faktura a dobropis obsahovaly identifikační údaj v poli BT-24. Pokud CustomizationID chybí, je prázdný nebo není rozpoznán v očekávaném jmenném prostoru, může validátor nahlásit chybu BR-01 i R004. Opravte přítomnost, jmenný prostor a hodnotu prvku a poté znovu ověřte platnost vygenerovaného dokumentu. Nepovažujte tyto dvě zprávy za nesouvisející chyby.
CustomizationID a ProfileID nejsou zaměnitelné
| Prvek | Účel |
cbc:CustomizationID | Určuje specifikaci a soubor pravidel, jimiž se dokument řídí. |
cbc:ProfileID | Určuje obchodní proces, v rámci kterého dochází k výměně dokumentu. |
Změna ProfileID nevyřeší chybu PEPPOL-EN16931-R004. Chyba se týká CustomizationID.
Související pokyny
Normativní zdroj
Požadavky na validaci a testovací pravidla zveřejňuje organizace OpenPeppol. Tento článek obsahuje praktické vysvětlení a pokyny k implementaci od společnosti Qvalia. Vždy používejte validační artefakty platné pro daný dokument a aktuální specifikaci Peppol release.