Oppsett av bruker i Altinn – en enkeltpersons tilgang til å representere et foretak/organisasjon/offentlig myndighet
Hvilke skjemaer du har tilgang til i Altinn bestemmes av hvilke roller og rettigheter du har. Les mer om roller og rettigheter i Altinn her: https://www.altinn.no/hjelp/profil/roller-og-rettigheter/.
...
Det gjøres oppmerksom på at det kan komme endringer i Altinn fortløpende.
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".
Utvikler informasjon tilgjengelig her: https://www.altinn.no/api/help, og mer spesifikt her: https://www.altinn.no/api/Help/Api/GET-reportees_showConsentReportees_includeInactiveReportees
Kall:
| Paste code macro |
|---|
GET
https://tt02.altinn.no/api/reportees?showConsentReportees=false&includeInactiveReportees=false |
Eksempel respons:
| Paste code macro | ||
|---|---|---|
| ||
{ "_links": { "find": { "href": "https://tt02.altinn.no/api/reportees/{reporteeId}", "isTemplated": true }, "self": { "href": "https://tt02.altinn.no/api/reportees" } }, "_embedded": { "reportees": [ { "ReporteeId": "r50337925", "Name": "ANDERSEN SNEKKER", "Type": "Person", "SocialSecurityNumber": "10035400066", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50337925" }, "messages": { "href": "https://tt02.altinn.no/api/r50337925/messages" } } }, { "ReporteeId": "r50171180", "Name": "DREVSJØ OG STAVANGER LUFTHAVN REVISJ", "Type": "Bedrift", "OrganizationNumber": "910304704", "ParentOrganizationNumber": "810318562", "OrganizationForm": "BEDR", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50171180" }, "messages": { "href": "https://tt02.altinn.no/api/r50171180/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/910304704" } } }, { "ReporteeId": "r50188272", "Name": "FANA OG HAFSLO REVISJON", "Type": "Foretak", "OrganizationNumber": "910297937", "OrganizationForm": "AS", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50188272" }, "messages": { "href": "https://tt02.altinn.no/api/r50188272/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/910297937" } } }, { "ReporteeId": "r50096175", "Name": "FILIP MOHAMED", "Type": "Person", "SocialSecurityNumber": "25125401530", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50096175" }, "messages": { "href": "https://tt02.altinn.no/api/r50096175/messages" } } }, { "ReporteeId": "r50313101", "Name": "SUNNDALSØRA OG DALSGRENDA", "Type": "Bedrift", "OrganizationNumber": "911379163", "OrganizationForm": "BEDR", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50313101" }, "messages": { "href": "https://tt02.altinn.no/api/r50313101/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/911379163" } } }, { "ReporteeId": "r50293842", "Name": "SUNNDALSØRA OG FOLLEBU", "Type": "Bedrift", "OrganizationNumber": "911379139", "OrganizationForm": "BEDR", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50293842" }, "messages": { "href": "https://tt02.altinn.no/api/r50293842/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/911379139" } } }, { "ReporteeId": "r50299296", "Name": "SUNNDALSØRA OG YTRE ENEBAKK", "Type": "Bedrift", "OrganizationNumber": "911379198", "OrganizationForm": "BEDR", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50299296" }, "messages": { "href": "https://tt02.altinn.no/api/r50299296/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/911379198" } } }, { "ReporteeId": "r50293843", "Name": "SÆBØVÅGEN OG LONGYEARBYEN", "Type": "Foretak", "OrganizationNumber": "911455307", "OrganizationForm": "AS", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50293843" }, "messages": { "href": "https://tt02.altinn.no/api/r50293843/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/911455307" } } }, { "ReporteeId": "r50293840", "Name": "SÆBØVÅGEN OG NES PÅ HEDMARK", "Type": "Foretak", "OrganizationNumber": "911455315", "OrganizationForm": "AS", "Status": "Active", "_links": { "self": { "href": "https://tt02.altinn.no/api/reportees/r50293840" }, "messages": { "href": "https://tt02.altinn.no/api/r50293840/messages" }, "authoritativesource": { "href": "https://data.brreg.no/enhetsregisteret/api/enheter/911455315" } } } ] } } |
| Info |
|---|
Legg merke til at API responsen for "Type" følger det prefererte språket til brukeren, så søknadssystemer må kunne motta disse: English: Enterprise | Business | Person 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 å representerer en organisation på et overordnet nivå, betyr ikke nødvendigvis at denne brukeren ar tilgang til å sende inn byggesøknader.
Det finnes en variasjon av reportee kallet som sjekker om man kan representerer en organisasjon for en bestemt innsendingstjeneste:
https://www.altinn.no/api/Help/Api/GET-reportees_serviceCode_serviceEdition_showConsentReportees
| Paste code macro |
|---|
GET
https://tt02.altinn.no/api/reportees?serviceCode={serviceCode}&serviceEdition={serviceEdition}showConsentReportees=false&includeInactiveReportees=false |
Oversikt over {serviceCode} og {serviceEdition} finnes her: Tjenesteoppsett PROD og Tjenesteoppsett TT02
Nevner også at det finnes en Foretak/Bedrift (Enterprise/Business) struktur i Altinn for hoved-organisation og under-enheter. Feltet "ParentOrganizationNumber" knytter disse sammen via org nummer til hovedenhet. De forskjellige enhetene har ikke nødvendigvis samme rettigheter for samme bruker og kan ha samme navn som vist her.
