Ennen kuin ERP-järjestelmäsi tai alustasi lähettää laskun, tilauksen tai muun Peppol-asiakirjan, se voi kysyä Qvalialta, onko vastaanottajan Peppol ID rekisteröity ja minkä tyyppisiä asiakirjoja vastaanottaja voi vastaanottaa. Verkosto hylkää asiakirjan, joka lähetetään osallistujalle, joka ei ole rekisteröitynyt kyseisen asiakirjatyypin vastaanottamiseen, joten tämän tarkistuksen avulla järjestelmäsi voi havaita puuttuvan tai väärän Peppol ID ennen kuin mitään lähetetään.
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}
# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}| Tili-API | Kumppanin API | |
| Käyttäjät: | Yritykset, jotka lähettävät viestejä omalta Qvalia-tililtään | Alustat ja palveluntarjoajat, jotka lähettävät asiakkaidensa puolesta |
| Valinnainen suodatin | docTypeRoot, esimerkiksi Invoice tai CreditNote | docTypeRoot, esimerkiksi Invoice, OrderResponse tai MLR |
| Perus-URL-osoitteet | Hiekkalaatikko api-test.qvalia.com, tuotanto api.qvalia.com | Hiekkalaatikko api-test.qvalia.com, tuotanto api.qvalia.com |
Milloin vastaanottaja on tarkistettava
- Kun asiakas luodaan järjestelmään tai hänen Peppol ID -tietonsa muuttuvat
- Kun käyttäjä kirjoittaa osoitteen Peppol ID käsin
- Ennen kuin lähetät asiakirjatyypin, jota vastaanottaja ei ole aiemmin saanut sinulta, esimerkiksi vastauksen ensimmäiseen tilaukseen tai hyvityslaskun
Tee pyyntö
- Kirjoita ” Peppol ID ” siten, että järjestelmä ja tunniste erotetaan toisistaan kaksoispisteellä, esimerkiksi
0007:1234567890ruotsalaisen organisaationumeron saamiseksi. - Lähetä GET-pyyntö hakupäätepisteeseen käyttämällä API-avainta tai JWT:tä
Authorizationotsikko. - Lisää
docTypeRootjos haluat vastauksen tietyn asiakirjatyypin osalta, joka on nimetty sen UBL-juurielementin mukaan.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>Lue vastaus
| Tila | Merkitys | Mitä tehdä |
| 200 | Peppol-järjestelmään rekisteröity osallistuja ja sen vastaanottamat asiakirjatyypit | Lähetä, jos tarvitsemasi asiakirjatyyppi on luettelossa |
| 422 | Peppol ID -tiedosto ei ole oikeassa muodossa scheme:identifier | Korjaa muoto, esimerkiksi 0007:1234567890 |
| 429 | Tilillesi on tullut liian monta pyyntöä | Odota niin kauan kuin Retry-After jos otsikossa lukee niin, yritä uudelleen |
Partner API:n vastaus sisältää myös exists, joka kertoo, onko Peppol ID rekisteröity lainkaan, rootDocTypeExists, joka kertoo, voiko se vastaanottaa kyseisen asiakirjatyypin docTypeRoot, sekä luettelo docTypes.
Jos vastaanottaja ei ole rekisteröitynyt kyseisen asiakirjatyypin vastaanottajaksi, pyydä häntä ilmoittamaan oikea Peppol ID tai sovi toisesta tavasta toimittaa asiakirja.
Tarkista yksi vastaanottaja manuaalisesti
Jos haluat tarkistaa yhden yrityksen ilman integraatiota, käytä hakua osoitteessaPeppol ID .
Aiheeseen liittyvät: Peppol SMP ja SML · Mikä on ” Peppol ID ” · Laskutus-API · API-viiteopas