Innrapportering drosjetjenester API
For generell informasjon om tjenestene se egne sider om:
- Bruk av tjenestene
- Sikkerhetsmekansimer
- Systemtilgang
- Feilhåndtering
- Versjonering
- Teknisk spesifikasjon
Scope
Følgende scope skal benyttes ved autentisering i Maskinporten: skatteetaten:innrapporteringdrosjetjenester
Delegering
Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen.
Systemtilgang
Bruk av API-et krever systemtilgang, som er ny funksjonalitet i Maskinporten levert av Digdir. Informasjon vedr. dette finnes her.
Dette API-et krever at systemet og dets systembrukere har tilgang til én eller flere av følgende tilgangspakker:
"accessPackages": [
{
"urn": "urn:altinn:accesspackage:regnskapsforer-med-signeringsrettighet"
},
{
"urn": "urn:altinn:accesspackage:ansvarlig-revisor"
},
{
"urn": "urn:altinn:accesspackage:skattegrunnlag"
}
]
Teknisk spesifikasjon
URL-er til API-et, beskrivelse av parametre, endepunkter og respons ligger i Open API-spesifikasjonen på SwaggerHub
Nødvendige åpninger i en evt. brannmur er beskrevet her
API-et for innrapportering av tredjepartsopplysninger om drosjetjenester til offentlige myndigheter har to endepunkter:
- POST innsending: Innsending av tredjepartsopplysninger om drosjesentraler til offentlige myndigheter. Et kall mot API-et er en rapportering for en organisasjon gitt av en oppgavegiver og som gjelder et inntektsår.
- GET uthenting_dokument: Henter ut et spesifikt dokument knyttet til en transmission (forsendelse) i Dialogporten
API-et validerer mottatte data mot JSON-schema beskrevet på SwaggerHub. Se feilkoder for relaterte feilmeldinger.
Se også eksempler for de ulike endepunktene.
Parameter: idempotencyKey
idempotencyKey
-parameteren er påkrevet. Innholdet skal være en unik UUID
. Hvert nye kall til API-et skal ha en
tilsvarende ny idempotencyKey. Flere etterfølgende POST
kall med samme request-body og samme idempotencyKey
vil gi den
samme responsen. Kun det første av denne rekken med like API kall vil behandles. idempotencyKey
muliggjør at man trygt
kan prøve innsendinger på nytt der man av ulike årsaker ikke har fått en tilbakemelding fra API-et.
Datakatalog
Dette API-et er pt. ikke dokumentert i Felles datakatalog.