PEPPOL-EN16931-R004 on vakava Peppol- BIS Billing -validointivirhe. Se tarkoittaa, että kentässä BT-24 oleva spesifikaation tunniste, jota edustaa cbc:CustomizationID, ei noudata Peppol- BIS Billing 3.0 -laskun tai hyvityslaskun edellyttämää tunnisteen muotoa. Asiakirja ei ole vaatimusten mukainen, eikä sitä tule lähettää Peppol-verkon kautta, ennen kuin arvo on korjattu.
| Kenttä | Arvo |
| Sääntö | PEPPOL-EN16931-R004 |
| Vakavuus | Kuolemaan johtava |
| Vahvistuskerros | Peppol BIS |
| Vaikuttava kenttä | cbc:CustomizationID (BT-24) |
| Koskee | UBL-lasku ja hyvityslasku |
| Release kuvattu | Peppol BIS Billing 3.0.21 |
Mitä virhe tarkoittaa
CustomizationID ilmoittaa validoijalle ja vastaanottavalle järjestelmälle, mitä erittelyä ja liiketoimintasääntöjä asiakirjan väitetään noudattavan. Standardin mukaisessa Peppol-asiakirjassa ( BIS Billing , versio 3.0) tämä arvo osoittaa sekä EN 16931 -standardin mukaisuuden että Peppol Billing -käyttöerittelyn.
Tämä ei ole Peppol-osallistujan tunniste, eikä se tunnista lähettäjää tai vastaanottajaa. Se eroaa myös ProfileID, joka määrittää sen liiketoimintaprosessin, jossa asiakirjaa vaihdetaan.
Mitä PEPPOL-EN16931-R004 tarkistaa
Nykyinen OpenPeppol-sääntö tarkistaa, että normalisoitu CustomizationID:
- alkaa vaaditulla Peppol-tunnisteella BIS Billing 3.0; ja
- ei sisällä kaksoiskaksoispisteellä merkittyä versiotunnistetta, joka kirjoitetaan muodossa
::.
Kun kyseessä on tavanomainen Peppol- BIS Billing -versio 3.0 -lasku tai hyvityslasku, käytä alla olevaa kanonista arvoa täsmälleen esitetyn mukaisesti:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0Säilytä se yhtenä yhtenäisenä merkkijonona. Vaikka validointitesti normalisoi välilyönnit ennen arvon tarkistamista, kanonisen arvon käyttäminen ilman lisättyjä välilyöntejä, rivinvaihtoja tai loppuliitteitä estää epäselvyyksiä ja kartoitusvirheitä.
Miksi versiotunnisteet eivät toimi
OpenPeppol on päivittänyt Peppol- BIS Billing in 3.0.21:n R004-säännön, joka aiheuttaa järjestelmän kaatumisen, jotta vaatimus tulisi selkeästi esiin: CustomizationID ei saa sisältää versiotietoja. ” release ” -standardi julkaistiin toukokuussa 2026, ja se tuli pakolliseksi 17. elokuuta 2026. Vanhemmasta toteutuksesta kopioitu arvo voi siis epäonnistua nykyisessä validoinnissa, jos se päättyy versiotunnisteeseen, kuten ::2.1 tai ::3.0.
Yleisiä syitä
- Virheellinen määrittely: ERP-järjestelmä tai muunnin lisää tunnuksen, joka kuuluu toiseen CIUS-järjestelmään, muotoon tai verkkoon.
- Puutteellinen tunniste: arvossa mainitaan standardi EN 16931, mutta Peppol-tunnisteen osa BIS Billing puuttuu.
- Lisätty versiotieto: arvon lopussa on kaksoiskaksoispiste, jota nykyinen sääntö hylkää.
- Puuttuva tai tyhjä elementti:
cbc:CustomizationIDpuuttuu, on tyhjä tai on kirjoitettu väärään XML-nimitilaan. Tämä voi myös aiheuttaa virheen BR-01. - Virheellinen lähdekartoitus: malli, väliohjelmiston kartoitus tai vientiasetus tuottaa jokaiselle asiakirjalle väärän arvon.
Kuinka korjata PEPPOL-EN16931-R004
- Avaa luotu XML-tiedosto. Etsi
cbc:CustomizationIDjuuren alkupäässäInvoicetaiCreditNoteelementti. - Tarkista koko arvo. Etsi lyhennettyä tunnistetta, toisesta muodosta peräisin olevaa arvoa, kirjoitusvirhettä tai liitettä
::versiotunniste. - Määritä kanoninen tunniste. Standardin Peppol BIS Billing 3.0 mukaisesti korvaa arvo yllä esitetyllä tunnisteella.
- Korjaa lähdekonfiguraatio. Päivitä se ERP-vienti, asiakirjamalli tai muunnoksen kartoitus, joka tuotti kyseisen arvon. Pelkästään yhden XML-tiedoston muokkaaminen ei poista taustalla olevaa virhettä.
- Luo uusi asiakirja ja tarkista sen oikeellisuus. Suorita koko XML-tiedosto nykyisten Peppol- BIS Billing -validointityökalujen kautta ennen kuin yrität lähettää sen uudelleen.
Jos asiakirja perustuu tarkoituksellisesti johonkin toiseen CIUS-standardiin, kansalliseen eritelmään tai PINT-profiiliin, älä vaihda tunnistetta sokeasti. Varmista, että CustomizationID kyseisen erittelyn mukaiset vaatimukset ja tarkistaa asiakirjan vastaavan sääntökokonaisuuden perusteella.
XML-esimerkkejä
Vastaa Peppol-standardia BIS Billing 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>Virheellinen: puutteellinen tunniste
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>Virheellinen: versiotiedot lisätty
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>Jos myös BR-01 esiintyy
BR-01-säännön mukaan jokaisessa laskussa ja hyvityslaskussa on oltava BT-24-kentässä erittelytunniste. Jos CustomizationID jos elementti puuttuu, on tyhjä tai sitä ei tunnisteta odotetussa nimitilassa, validointiohjelma voi ilmoittaa sekä virheen BR-01 että R004. Korjaa elementin läsnäolo, nimitila ja arvo ja validoi sitten uudelleen luotu asiakirja. Älä pidä näitä kahta virheilmoitusta toisistaan riippumattomina virheinä.
CustomizationID ja ProfileID eivät ole keskenään vaihdettavissa
| Elementti | Tarkoitus |
cbc:CustomizationID | Ilmaisee, mitä vaatimuksia ja sääntöjä asiakirja noudattaa. |
cbc:ProfileID | Määrittää liiketoimintaprosessin, jonka puitteissa asiakirja vaihdetaan. |
Muuttuminen ProfileID ei korjaa virhettä PEPPOL-EN16931-R004. Virhe koskee CustomizationID.
Aiheeseen liittyvät ohjeet
Normatiivinen lähde
OpenPeppol julkaisee validointivaatimukset ja sääntötestit. Tässä artikkelissa esitetään Qvalian käytännönläheinen selitys ja toteutusohjeet. Käytä aina asiakirjaan sovellettavia validointimateriaaleja sekä voimassa olevaa Peppol-standardia release.