Inden dit ERP-system eller din platform sender en faktura, en ordre eller et andet Peppol-dokument, kan det forhøre sig hos Qvalia, om modtagerens Peppol ID er registreret, og hvilke dokumenttyper modtageren kan modtage. Et dokument, der sendes til en deltager, der ikke er registreret til at modtage det, afvises af netværket, så denne kontrol giver dit system mulighed for at opdage en manglende eller forkert Peppol ID , inden noget sendes.
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}
# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}| Konto-API | Partner-API | |
| Anvendes af | Virksomheder, der sender fra deres egen Qvalia-konto | Platforme og tjenesteudbydere, der sender på vegne af deres kunder |
| Valgfrit filter | docTypeRoot, for eksempel Invoice eller CreditNote | docTypeRoot, for eksempel Invoice, OrderResponse eller MLR |
| Basis-URL’er | Sandkasse api-test.qvalia.com, produktion api.qvalia.com | Sandkasse api-test.qvalia.com, produktion api.qvalia.com |
Hvornår skal man kontrollere en modtager?
- Når der oprettes en kunde i dit system, eller når kundens Peppol ID ændres
- Når en bruger selv indtaster en Peppol ID
- Inden du sender en dokumenttype, som modtageren ikke har modtaget fra dig før, f.eks. et svar på en første ordre eller en kreditnota
Indsend anmodningen
- Skriv » Peppol ID « som en kombination af skema og identifikator adskilt af et kolon, for eksempel
0007:1234567890for et svensk organisationsnummer. - Send en GET-anmodning til lookup-endpointet med din API-nøgle eller et JWT i
Authorizationoverskrift. - Tilføj
docTypeRoothvis du ønsker svaret for en bestemt dokumenttype, angivet ved dens UBL-rodelement.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>Læs svaret
| Status | Betydning | Hvad skal man gøre? |
| 200 | Den deltager, der er registreret på Peppol, med de dokumenttyper, vedkommende kan modtage | Send, hvis den dokumenttype, du har brug for, er angivet |
| 422 | Peppol ID en er ikke i den rette form scheme:identifier | Ret formatet, for eksempel 0007:1234567890 |
| 429 | Der er for mange anmodninger til din konto | Vent lige så længe som Retry-After hvis overskriften siger det, så prøv igen |
Partner-API-svaret indeholder desuden exists, som angiver, om Peppol ID overhovedet er registreret, rootDocTypeExists, som angiver, om den kan modtage dokumenttypen i docTypeRoot, og listen over docTypes.
Hvis modtageren ikke er registreret for denne dokumenttype, skal du bede vedkommende om den korrekte Peppol ID eller aftale en anden måde at levere dokumentet på.
Markér en enkelt modtager manuelt
Hvis du vil tjekke en virksomhed uden integration, kan du bruge søgefunktionen påPeppol ID .
Relateret: Peppol SMP og SML · Hvad er en » Peppol ID «? · Fakturerings-API · API-reference