1. Etusivu
  2. Tietopankki
  3. Peppol
  4. Peppol-osallistujien tunnistejärjestelmät

Peppol-osallistujien tunnistejärjestelmät

Peppol-osallistujien tunnistejärjestelmät

Peppol-osallistujan tunniste viittaa verkossa olevaan organisaatioon. Se koostuu kahdesta osasta: järjestelmästä, joka määrittää rekisterin, josta arvo on peräisin, sekä itse arvosta. Järjestelmäkoodit ovat peräisin OpenPeppol Participant Identifier Schemes -koodiluettelosta, joka perustuu standardin ISO 6523 kansainvälisiin kooditunnisteisiin ja jota on laajennettu Peppol-spesifisillä arvoilla. Kyseessä on verkkotason tunniste, jota hallinnoidaan erillään laskuun merkitystä sähköisestä osoitteesta.

KenttäArvo
Metajärjestelmäiso6523-actorid-upis
Rakenne<scheme>:<value>
Esimerkki0088:7300010000001
KoodiluetteloOsallistujatunnistejärjestelmät v9.7, 2. heinäkuuta 2026, 105 merkintää
Tekniset tiedotTunnisteiden käyttöohjeet 4.4.0, 6. helmikuuta 2025

Miten tunniste muodostetaan

Peppol-verkostossa käytetty osallistujatunnistejärjestelmä on iso6523-actorid-upis. Siinä tunniste on numeerinen järjestelmäkoodi, jota seuraa kyseisen rekisterin myöntämä arvo.

Järjestelmäkoodi yksilöi rekisterin. 0088 on maailmanlaajuinen sijaintinumero, 0007 ruotsalainen organisaationumero, 0192 norjalainen organisaationumero. Arvo on rekisterin myöntämä tunniste. Yhdessä ne muodostavat verkossa ainutlaatuisen yhdistelmän, minkä ansiosta asiakirja voidaan välittää ilman, että lähettäjän ja vastaanottajan välillä on aiempaa yhteyttä.

Kun samaa järjestelmää ja arvoa käytetään sekä verkon reitityksessä että asiakirjojen osoitteistuksessa, ne esitetään eri muodoissa.

Osallistujan tunniste SMP:n REST-resurssin URL-osoitteessa tai teknisessä lokissa: iso6523-actorid-upis::0088:7300010000001
Participant identifier in an SMP REST resource URL or technical log:
iso6523-actorid-upis::0088:7300010000001
Pelkästään järjestelmä ja arvo, kuten ohjeessa määritellään: 0088:7300010000001
Scheme and value alone, as the policy states the structure:
0088:7300010000001

Dokumentoi EndpointID, jossa malli muuttuu attribuuttiksi:

<cbc:EndpointID schemeID=”0088″>7300010000001</cbc:EndpointID>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>

Meta-scheme-etuliitettä ja kaksoiskaksoispistettä käytetään SMP REST -resurssien URL-osoitteissa, ja ne voivat esiintyä teknisissä lokitiedoissa. SML-hakutoiminto perustuu DNS:ään, ja sen hakunimi johdetaan osallistujan tunnisteesta. Varmista, millaista tarkkaa esitystapaa työkalusi edellyttää, ennen kuin koodaat sen kiinteästi.

Kirjainkoko- ja merkkisäännöt

Metajärjestelmä iso6523-actorid-upis on kirjainkokoherkkä, ja se on kirjoitettava täsmälleen näytetyn mukaisesti.

Osallistujan tunnisteiden arvoissa ei oteta huomioon kirjainkokoa, ja käytäntö määrittelee nimenomaisesti, että tämä pätee myös silloin, kun taustalla oleva rekisteri käyttää kirjainkokoa erottavia arvoja. Älä luota kirjainkokoon kahden tunnisteen erottamisessa toisistaan.

Osallistujan tunnisteen pituus on 1–130 merkkiä, järjestelmäosaa lukuun ottamatta. Se saa sisältää vain ISO-8859-1-standardin mukaisia kirjaimia, numeroita, väliviivaa, pistettä, alaviivaa ja tilde-merkkiä. Arvot, jotka sisältävät välilyöntejä, kauttaviivoja tai muita tämän merkkijoukon ulkopuolisia merkkejä, eivät ole käytäntöjen mukaisia, ja niiden tunnistaminen saattaa epäonnistua.

ISO 6523 ja Peppol-laajennukset

Numerojärjestelmän koodit perustuvat standardin ISO 6523 ICD-arvoihin, mutta Peppolin luettelo ei ole täysin sama kuin ISO 6523. Peppol ylläpitää omaa luetteloaan, koska se sisältää lisäarvoja, joille on varattu 99:llä alkava numeroalue.

Käytännössä tämä tarkoittaa, että Peppol-skeemakoodia ei voi tarkistaa pelkästään ISO 6523 -luettelon perusteella. Koodi voi olla oikea Peppol-järjestelmässä, mutta puuttua ISO 6523 -luettelosta, ja toisaalta koodi voi esiintyä ISO 6523 -luettelossa ilman, että se olisi sallittu Peppol-järjestelmässä.

Vanhentuneet järjestelmät ja poistamispäivät

Osallistujatunnistejärjestelmien luettelon merkinnöillä on tila. Versiossa 9.7 olevista 105 merkinnästä 5 on vanhentuneita ja 16 poistettuja. Vanhentuneita merkintöjä ei saa käyttää uusissa vaihdettavissa liiketoimintadokumenteissa tai uusissa SMP-rekisteröinneissä. Poistettuja merkintöjä ei saa käyttää lainkaan.

Scheme-tunnisteita ei koskaan käytetä uudelleen. Käytöstä poistettua koodia ei myöhemmin osoiteta uudelleen eri rekisterille, joten vanhaa tunnistetta voidaan tulkita turvallisesti myös sen jälkeen, kun scheme on poistettu käytöstä.

Miten tämä eroaa laskun sähköisestä osoitteesta

Laskussa on myyjän ja ostajan sähköpostiosoitteet kentissä BT-34 ja BT-49, ja niissä käytetään EAS-koodiluetteloa. Osallistujan tunniste osoittaa vastaanottajan verkkotasolla. Samat koodit ja arvot voidaan käyttää molemmissa kentissä, mutta niihin sovelletaan erilaisia eritelmiä ja koodiluetteloita, joiden versionumerot ovat erilaiset.

Käsittele niitä kahdeksi erilliseksi tarkistettavaksi seikaksi. Asiakirjassa voi olla oikea EAS-arvo, mutta reititys voi silti epäonnistua, jos vastaanottajaa ei ole rekisteröity vastaavan osallistujan tunnisteen alle.

Yleisiä syitä, miksi osoitetta ei voida selvittää

Ohjelma on kirjoitettu väärällä kirjaimistolla. iso6523-actorid-upis erottaa isoja ja pieniä kirjaimia. ISO6523-ActorID-upis on eri merkkijono, eikä se vastaa toisiaan.

Arvoon siirtyy lähdejärjestelmän muotoilu. Ruotsalaiset organisaationumerot tallennetaan usein muodossa 556123-4567. Yhdysmerkki on sallittu merkki, mutta rekisterin arvo on 5561234567, ja vastaanottaja on rekisteröity kyseisen tunnisteen alle. Välilyönnit, kauttaviivat ja sallitun merkkijoukon ulkopuolella olevat merkit eivät ole osallistujatunnisteita koskevien sääntöjen mukaisia.

Arvo on oikea, mutta laskentatapa on väärä. 0007:5561234567 ja 0088:5561234567 ovat kaksi eri osallistujaa. GLN-numeroa ja organisaationumeroa ei voi koskaan käyttää keskenään, vaikka numerot näyttäisivätkin uskottavilta.

Järjestelmä on merkitty vanhentuneeksi tai poistettu osallistujatunnistejärjestelmien luettelosta. Jokaisella merkinnällä on tila ja tarvittaessa poistopäivä. Versiossa 9.7 on 105 merkintää, joista 5 on merkitty vanhentuneiksi ja 16 on poistettu. Poistetun järjestelmän osallistujatunnistetta ei saa käyttää, vaikka vanhentuneita rekisteröintitietoja olisi vielä olemassa.

Suomalainen järjestelmä 0037 (LY-tunnus) on merkitty vanhentuneeksi koodiluettelossa release 8.9, ja sen poistopäivämääräksi on määritetty 31. joulukuuta 2024. Koodi 0216 (OVTcode) on käytössä oleva suomalainen osallistujatunnistejärjestelmä. Myös muita kelvollisia järjestelmiä voidaan käyttää. Koodi 0037 poistettiin erikseen EAS-koodiluettelosta versiossa BIS Billing 3.0.21. Näitä kahta luetteloa ylläpidetään erikseen, joten tarkista se luettelo, joka koskee tarkasteltavaa kenttää.

Vastaanottaja on rekisteröity, mutta ei tälle asiakirjatyypille. Rekisteröinti tapahtuu asiakirjatyyppikohtaisesti ja prosessikohtaisesti. Laskuja vastaanottava osapuoli ei saa automaattisesti hyvityslaskuja, tilauksia tai lähetysilmoituksia.

Oliko tästä artikkelista apua?

Aiheeseen liittyvät artikkelit