Før ERP-en eller plattformen din sender en faktura, ordre eller annet Peppol-dokument, kan den spørre Qvalia om mottakerens Peppol ID er registrert og hvilke dokumenttyper mottakeren kan motta. Et dokument som sendes til en deltaker som ikke er registrert for det, avvises av nettverket, så sjekken lar systemet ditt oppdage manglende eller feil dokument. Peppol ID før noe sendes.
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}
# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}| Konto-API | Partner-API | |
| Brukt av | Bedrifter som sender fra sin egen Qvalia-konto | Plattformer og tjenesteleverandører som sender på vegne av kundene sine |
| Valgfritt filter | docTypeRoot, for eksempel Invoice eller CreditNote | docTypeRoot, for eksempel Invoice, OrderResponse eller MLR |
| Basis-URL-er | Sandbox api-test.qvalia.com, produksjon api.qvalia.com | Sandbox api-test.qvalia.com, produksjon api.qvalia.com |
Når du skal sjekke en mottaker
- Når en kunde opprettes i systemet ditt, eller dens Peppol ID endringer
- Når en bruker skriver inn en Peppol ID for hånd
- Før du sender en dokumenttype som mottakeren ikke har mottatt fra deg tidligere, for eksempel en ordrebekreftelse eller en kreditnota
Send forespørselen
- Skriv Peppol ID som skjema og identifikator atskilt med kolon, for eksempel
0007:1234567890for et svensk organisasjonsnummer. - Send en GET-forespørsel til oppslagsendepunktet, med API-nøkkelen din eller en JWT i
Authorizationoverskrift. - Legge til
docTypeRoothvis du vil ha svaret for én dokumenttype, navngitt etter dens UBL-rotelement.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>Les svaret
| Status | Betydning | Hva du skal gjøre |
| 200 | Deltakeren som registrert på Peppol, med dokumenttypene den kan motta | Send hvis dokumenttypen du trenger er oppført |
| 422 | De Peppol ID er ikke i formen scheme:identifier | Rett formatet, for eksempel 0007:1234567890 |
| 429 | For mange forespørsler for kontoen din | Vent så lenge som Retry-After overskriften sier, prøv deretter på nytt |
Partner API-svaret inneholder også exists, som forteller om hvorvidt Peppol ID er registrert i det hele tatt, rootDocTypeExists, som forteller om den kan motta dokumenttypen i docTypeRoot, og listen over docTypes.
Hvis mottakeren ikke er registrert for dokumenttypen, spør den om den riktige Peppol ID , eller bli enige om en annen måte å levere dokumentet på.
Sjekk én enkelt mottaker manuelt
For å sjekke ett selskap uten en integrasjon, bruk Peppol ID søk .
Relatert: Peppol SMP og SML · Hva en Peppol ID er · Fakturerings-API · API-referanse