Service Metadata Locator (SML) ja Service Metadata Publisher (SMP) antavat lähettävälle Peppol-liityntäpisteelle mahdollisuuden selvittää, miten vastaanottaja voi vastaanottaa tietyn liiketoimintadokumentin. SML tunnistaa, missä SMP:ssä vastaanottajan metatiedot sijaitsevat. SMP palauttaa tämän jälkeen tiedot vastaanottajan tukemista dokumenttityypeistä, prosesseista ja teknisistä päätepisteistä. Tämän dynaamisen haun ansiosta lähettäjän ja vastaanottajan ei tarvitse määrittää suoraa yhteyttä etukäteen.
| Komponentti | Nykyiset tekniset tiedot | Toiminto |
| SML | Peppol SML 1.3.0, voimassa 1. marraskuuta 2025 alkaen | Etsii osallistujan tunnisteeseen liittyvän SMP:n DNS:n avulla |
| SMP | Peppol SMP 1.4.0, voimassa 1. marraskuuta 2025 alkaen | Julkaisee osallistujien ominaisuudet ja jakelupisteen metatiedot |
| Tunnisteiden käytäntö | Peppolin tunnisteiden käyttöä koskevat ohjeet 4.4.0 | Määrittelee, miten osallistujien tunnisteet esitetään ja tunnistetaan |
SMP:n ja SML:n välinen ero
| SML | SMP | |
| Koko nimi | Palvelun metatietojen hakutoiminto | Palvelun metatietojen julkaisija |
| Pääkysymys | Missä SMP:ssä tämän osallistujan metatiedot sijaitsevat? | Voiko tämä osallistuja vastaanottaa tämän asiakirjan ja käsitellä sen, ja minne se tulisi lähettää? |
| Hakumenetelmä | DNS U-NAPTR | HTTPS-REST-pyyntö |
| Tallentaa asiakirjojen ominaisuudet | Ei | Kyllä |
| Tallentaa toimituspäätelaitteen ja varmenteen | Ei | Kyllä |
SML on paikannuspalvelu. Se ei sisällä vastaanottajan täydellistä palvelukonfiguraatiota. Jokainen osallistujan tunniste on rekisteröity yhteen SMP:hen, ja kyseinen SMP julkaisee toimituksessa käytettävät yksityiskohtaiset metatiedot.
Miten todisteiden esittämisprosessi etenee
- Lähettävä tukiasema vastaanottaa vastaanottajan Peppol-osallistujan tunnisteen, esimerkiksi
0088:7300010000001. - Se muuntaa osallistujan tunnisteen Peppolin tunnistekäytännössä määritellyksi DNS-nimeksi.
- DNS-U-NAPTR-haku palauttaa kyseiseen osallistujaan liittyvän SMP:n perus-URL-osoitteen.
- Lähettävä tukiasema kysyy SMP:ltä vastaanottajan tiedot sekä sen asiakirjatyypin, jonka se aikoo lähettää.
- SMP-vastauksessa ilmoitetaan tuettu prosessi, siirtoprofiili, toimituskohde ja varmenne.
- Lähettävä tukiasema käyttää näitä metatietoja AS4-yhteyden muodostamiseen ja viestin lähettämiseen.
Yrityskäyttäjät eivät yleensä tee näitä kyselyjä itse. Lähettävä Peppol-palveluntarjoaja suorittaa haun ennen tiedonsiirtoa.
Miten osallistujan tunniste muuttuu DNS-hakuksi
DNS-nimi johdetaan osallistujan tunnisteesta sen sijaan, että tunniste paljastettaisiin suoraan. Tunniste muunnetaan pieniksi kirjaimiksi, siitä lasketaan SHA-256-tiiviste ja se koodataan Base32-muotoon ilman täytettä. Tämän jälkeen liitetään mukaan osallistujan metakaavio ja SML-vyöhyke.
Käsitteellinen muoto:
BASE32(SHA-256(lowercase("0088:7300010000001")))
.iso6523-actorid-upis
.<SML-zone>Kirjainkokojen normalisointi tapahtuu ennen hajautusta, koska Peppol-osallistujan tunnistearvoja käsitellään kirjainkokoa huomioimatta. Lähettäjä, joka hajauttaa eri tavalla normalisoidun arvon, hakee väärän DNS-nimen.
Mitä SMP julkaisee
SMP järjestää metatiedot osallistujan, asiakirjatyypin ja prosessin mukaan. Palvelutietue voi sisältää seuraavia tietoja:
- osallistujan tunniste;
- asiakirjatyypin tunniste;
- yksi tai useampi tuettu prosessitunniste;
- kuljetusprofiili;
- vastaanottavan tukiaseman päätepisteen osoite;
- turvalliseen tiedonsiirtoon käytetty varmenne;
- palvelun aktivointi- ja voimassaolon päättymispäivät; ja
- tekniset yhteystiedot tai huoltotiedot, mikäli niitä on annettu.
Lähettävä tukiasema pyytää tietyn asiakirjatyypin metatietoja. Osallistuja voi siten olla rekisteröity Peppol-järjestelmään ja vastaanottaa laskuja, vaikka hänellä ei olisi julkaistua toimintakykyä tilausten tai muun laskuprofiilin osalta.
SMP-resurssipolun käsitteellinen rakenne on seuraava:
{smp-base-url}/{participant-identifier}/services/{document-type-identifier}Osallistujan ja asiakirjan tunnisteet on esitettävä ja prosenttikoodattava SMP REST -määrityksen vaatimusten mukaisesti. Koodaamatonta esimerkkiä ei tule kopioida suoraan toteutukseen.
Rekisteröinti ja toimintakyky tarkistetaan erikseen
SML-tietue vahvistaa, että osallistujan tunniste on liitetty SMP:hen. Se ei kuitenkaan tarkoita, että osallistuja hyväksyisi kaikki Peppol-asiakirjat. SMP-kykytietue määrittää, tuetaanko pyydettyä asiakirjatyypin ja prosessin yhdistelmää.
Tämä ero selittää, miksi vastaanottaja saattaa löytyä osoitteesta Peppol ID , mutta silti hylätä tietyn viestin. Osallistuja saattaa tukea BIS Billing -laskuja, mutta ei hyvityslaskuja, tilauksia tai lähettäjän käyttämää prosessitunnistetta. Lähettävän yhteyspisteen on tarkistettava tarkka yhdistelmä ennen lähetystä.
SMP ja SML eivät ole Peppol-hakemisto
Peppol-hakemisto on vapaaehtoinen, manuaalisesti haettavissa oleva palvelu, joka perustuu osallistuvien SMP-toimijoiden julkaisemiin käyntikorttitietoihin. Sen avulla käyttäjät voivat etsiä organisaatioita, Peppol-tunnisteita ja julkaistuja asiakirjojen käsittelyominaisuuksia. Se ei ole sama reititysrekisteri, jota yhteyspisteet käyttävät.
Käytä Qvalian ” Peppol ID ” -hakutoimintoa tarkistaaksesi hakemistosta saatavilla olevat tiedot. Access Point käyttää edelleen SML- ja SMP-löytöprosessia määrittääkseen varsinaisen viestin teknisen reitin.
Yleisiä vikoja tiedonhaun ja reitityksen yhteydessä
| Oire | Todennäköinen syy |
| Osallistujalle ei löytynyt DNS-tulosta | Osallistujan tunniste on virheellinen, siinä käytetään väärää tunnistusjärjestelmää tai sitä ei ole rekisteröity SML:ään |
| SMP löytyy, mutta palvelutiedoista ei löydy vastaavuutta | Vastaanottaja ei ole julkaissut tukea kyseiselle asiakirjatyypille |
| Asiakirjatyyppi löytyy, mutta prosessi puuttuu | Pyydettyä prosessitunnistetta ei ole rekisteröity kyseiselle asiakirjalle |
| Päätepiste löytyi, mutta AS4-toimitus epäonnistui | Loppupiste, varmenne, siirtoprofiili tai vastaanottava palvelu vaatii selvittämistä |
| Äskettäinen palveluntarjoajan vaihto ei näy välittömästi | Välimuistissa olevat DNS- tai palvelun metatiedot saattavat edelleen sisältää edellisen reitin |
Tarkista ensin osallistujajärjestelmä ja arvo, minkä jälkeen asiakirjatyyppi ja prosessitunnisteet. Käytä Peppol-hakemistohakua hyödyllisenä käyttäjälle suunnattuna tarkistuksena ja pidä nykyisiä SMP-metatietoja toimituksen teknisenä lähteenä.
Kuka ylläpitää metatietoja?
Vastaanottajan Peppol-palveluntarjoaja rekisteröi osallistujan tunnisteen, ylläpitää SML-yhteyttä ja julkaisee osallistujan ominaisuudet omassa SMP:ssään. Kun osallistuja vaihtaa palveluntarjoajaa, SML-yhteyden on osoitettava uuteen SMP:hen, ja vaaditut ominaisuudet on julkaistava siellä.
Lähettävä yhteyspiste suorittaa tunnistuksen ja käyttää palautettuja päätepistetietoja tiedonsiirrossa. Peppolia käyttävät yritykset hallinnoivat tunnisteitaan ja vastaanottokapasiteettiaan yleensä palveluntarjoajansa kautta sen sijaan, että ne ylläpitäisivät SML:ää tai hakisivat SMP-tietueita manuaalisesti. Lue lisää siitä, miten Peppol-yhteyspiste hoitaa tunnistuksen, validoinnin ja tiedonsiirron.
Aiheeseen liittyvät ohjeet
Normatiiviset lähteet
Peppol SML 1.3.0, Peppol SMP 1.4.0 ja tunnisteiden käyttöohjeet 4.4.0, OpenPeppol.