Samtykke
Få tilgang
Før du som konsument kan benytte Skatteetaten API-er som krever samtykke eller fullmakt må du få tilgang til Altinn's samtykkeløsning. Altinn har beskrevet det som skal til for å . Skatteetaten er her datakilden og har på forhånd opprettet tjenestekoder og tjenesteutgavekoder for API-ene. Nærmere informasjon om dette finner du i API-dokumentasjonen. Merk at Skatteetaten ikke benytter tjenesteeierstyrt rettighetsregister.
Be om samtykke
Når du har fått tilgang til Altinn's samtykkeløsning og API-et til Skatteetaten kan det . Skatteetaten støtter kun Forhåndsregistrerte samtykkeforespørsler og det er heller ikke mulig å overstyre de forhåndsdefinerte tekstene. Request Message skal derfor ikke benyttes i forespørselen.
Den overordnetete flyten for samtykkedialogen blir da som følger:
Bruker logger seg på nettløsningen for å f.eks. søke om lån eller se sine Krav og betalinger. Konsumenter må dermed ha et samtykke eller fullmakt for å innhente opplysninger på vegne av brukeren.
Konsument innhenter samtykket ved å sende en samtykkeforespørsel for bruker til Altinn med ServiceCode og ServiceCodeEdition for de aktuelle tjenestene og mottar en AuthorizationCode. Dersom det allerede foreligger et gyldig samtykke som er innenfor utløpstiden (f.eks. 90 dager for Krav og betalinger), fortsetter flyten i steg 6.
Konsument sender deretter brukeren til samtykkesiden hos Altinn med Authorization Code fra samtykkeforespørselen og en RedirectURL, som er en lenke til siden brukeren skal sendes tilbake til etter at samtykket er gitt.
Brukeren blir presentert for samtykkesiden som inneholder en beskrivelse av hva det skal gis samtykke til. Det er Skatteetaten som har definert dette innholdet.
Brukeren gir samtykke og sendes tilbake til konsumentens nettsider på Redirect URL-en som ble oppgitt.
Konsument fra Altinn ved bruk av Authorization Code. Samtykketokenet har vanligvis utløpstid på 30 sekunder, men kan innhentes på nytt med samme AuthorizationCode så lenge samtykket fortsatt er gyldig.
Konsument sender med samtykketokenet i forespørslene til API-et gjennom å sette en HTTP-headerverdi:
AltinnSamtykke: <samtykketoken>. Forespørselen må også inneholde et .Skatteetaten sjekker Maskinporten- og Samtykketoken og utleverer dataene.
Fjerne samtykke
En bruker kan også , og dette gjøres på brukerens profil i Altinn.
Tjenester med støtte for samtykke
Følgende API-er hos Skatteetaten støtter utlevering gjennom samtykke eller fullmakt for enkelte rettighetspakker. Detaljer om parameterne som er nødvendig for å få utstedt samtykker eller fullmakt er beskrevet i dokumentasjonen for hvert enkelt api.
Samtykke fra skatteyter:
Samtykke fra virksomhet:
Se egen dokumentasjon for .