Brukerroller i Altinn

Oppsett av bruker i Altinn

Roller og rettigheter i Altinn angir en enkeltpersons tilgang til å representere et foretak, en organisasjon eller en offentlig myndighet.

Alle tjenester i Fellestjenester BYGG finnes i en Altinn-rolle kalt "Plan- og byggesak". DiBK har laget en veiledning om delegering av roller og rettigheter knyttet til byggesak som konsesjonærene kan bruke fritt.

Tilgang til rolleinformasjon gjennom Altinn REST API

Etter at en bruker er innlogget i Altinn, kan man få en oversikt over hvilke delegerte rettigheter brukeren har til å representere andre brukere og organisation i Altinn.

APIet heter "reportee".

Utviklerinformasjon er tilgjengelig her: https://www.altinn.no/api/help, og mer spesifikt her: https://www.altinn.no/api/Help/Api/GET-reportees_showConsentReportees_includeInactiveReportees

Kall:

Eksempel respons:

Legg merke til at API responsen for "Type" følger det prefererte språket til brukeren, så søknadssystemer må kunne motta disse:

Vi anbefaler å sette showConsentReportees=false&includeInactiveReportees=false i kallet for ikke å få med organisasjoner som man trolig ikke kan sende inn skjema på vegne av

Rettigheter per innsendingstjeneste

Det at en person har tilgang til å representere en organisation på et overordnet nivå, betyr ikke nødvendigvis at denne brukeren har tilgang til å sende inn byggesøknader.

Det finnes en variant av reportee-kallet som sjekker om man kan representere en organisasjon for en bestemt innsendingstjeneste:

https://www.altinn.no/api/Help/Api/GET-reportees_serviceCode_serviceEdition_showConsentReportees

Oversikt over {serviceCode} og {serviceEdition} finnes her: Tjenesteoppsett PROD og Tjenesteoppsett TT02

Nevner også at det finnes en Foretak/Bedrifts (Enterprise/Business) struktur i Altinn for hovedenhet og underenheter. Feltet "ParentOrganizationNumber" knytter disse sammen via organisasjonsnummer til hovedenhet. De forskjellige enhetene har ikke nødvendigvis samme rettigheter for samme bruker. Hoved- og unnderenhet kan ha samme navn slik det er vist her.