For leverandører av sluttbrukersystemer

Her finner du informasjon om endringene for deg som lager tjenester og systemer med integrasjon mot Skatteetatens tjenester og API. Skatteetaten vil benytte fellesfunksjonalitet i Altinn, og krever blant annet systembruker for maskinell innsending på flere at Skatteetatens innsendingstjenester. Dette betyr at det er behov for utvikling hos sluttbrukersystemleverandører som kan ta noe tid.

Viktig informasjon
Innhold på denne siden:

Dette må du gjøre for å ta i bruk nye APIer

Reetableringen medfører større endringer for leverandører av sluttbrukersystemer. Dere må legge til rette for nye tekniske integrasjoner og sette opp riktige tilgangspakker for kundene deres.

Her finner dere:

Når du ber om tilgang til API, må du samtidig bekrefte at du godtar bruksvilkårene for Skatteetatens tjenester.

For utviklere:
Vi har en kanal på Slack hvor utviklere hos systemleverandører og virksomheter kan stille spørsmål og ha dialog med tekniske ressurser hos oss.

Hva blir nytt?

Teknisk informasjon for hver enkelt tjeneste finner du på Github. Informasjon oppdateres fortløpende etter hvert som tjenester blir lagt ut i testmiljøet.

  • Flere tjenester får nye maskin-til-maskin-grensesnitt og innsending bytter i all hovedsak til JSON-format og OpenAPI.
  • For innrapportering av tredjepartsopplysninger vil én innsending kun være for en oppgavegiver/opplysningspliktig om gangen.
  • For innsending via system må leverandører ta i bruk tilgangspakker og systembruker:
    • Tilgangspakker erstatter dagens Altinn-roller. Se oversikt over tilgangspakkene på Altinn docs. Systemleverandører må registrere sine systemer i Altinn og angi hvilke tilgangspakker som er nødvendige for å bruke systemene. På GitHub finner du hvilke tilgangspakker som er satt opp på de ulike reetablerte tjenestene. Gå inn på den enkelte tjeneste i venstremenyen under API-er for innrapportering Kom i gang | API-dokumentasjon.
    • Systembruker er en av Altinns fellesløsninger som Digitaliseringsdirektoratet innfører. Systembruker bygger på Maskinporten og fungerer som en upersonlig bruker med fullmakt til å utføre definerte oppgaver på vegne av en virksomhet. Dagens løsning med virksomhetsbruker og pålogging via ID-porten blir fjernet. Les mer om systembruker på Digitaliseringsdirektoratet sine nettsider.
  • For alle som bruker filopplastingstjenesten til rapportering av tredjepartsopplysninger (RF-1301), blir det endringer: Testinnsending av tredjepartsopplysninger som skal rapporteres som filvedlegg

Skatteetaten har laget nye API-er som systemleverandører må bygge inn i løsningene sine. Dette gjør vi for å:

  • Effektivisere og automatisere
    Innsending kan skje direkte fra systemet, uten manuell opplasting. Dette sparer tid både for brukerne og Skatteetaten.
  • Forbedre datakvaliteten
    Maskinell innsending reduserer feil som ofte kan oppstå ved manuell behandling.
  • Gi bedre sikkerhet og tilgangsstyring
    API‑ene bruker Maskinporten, systembruker og tilgangspakker for autentisering. Dette gir tryggere løsninger og bedre kontroll over hvem som har tilgang.
    Nye API‑er for innsending og dialog (dialogporten), og ny funksjonalitet for autentisering, gjør det enklere å rapportere og lar brukeren være innlogget over tid.
  • Legge til rette for fremtidens innsendingsløsning
    Skatteetaten planlegger en gradvis overgang til maskinell innsending som hovedløsning på Altinn 3.

Nyttige lenker

Teknisk dokumentasjon for testing:

Forberede produksjon:

Teknisk dokumentasjon ligger på våre GitHub-sider. Vi har en kanal på Slack for dialog mellom utviklere i prosjektet og utviklere hos systemleverandører og virksomheter.

Kort om Altinn og nye begreper

Digitaliseringsdirektoratet fornyer Altinn fordi dagens teknologi er utdatert. Siste frist for rapportering på Altinn II er 31. mai 2026. Skatteetaten har nå reetablert de fleste av våre tjenester, og resten blir tilgjengelig fortløpende våren 2026. Alle som benytter Skatteetatens tjenester, bør sette seg inn i endringene og gjøre nødvendige tilpasninger.

Ny teknologi vil blant annet gi mer brukervennlige løsninger og økt sikkerhet. Videre vil nye Altinn bedre kunne oppfylle dagens krav til universell utforming og ulike skjermstørrelser oggi muligheter for modernisering på sikt. 

Digitaliseringsdirektoratet har etablert programmet Nye Altinn, der Skatteetaten, Brønnøysundregistrene, Statistisk sentralbyrå og Digdir har hvert sitt prosjekt som koordineres via programmet.

Skatteetaten har valgt å flytte våre tjenester til skatteetaten.no og samtidig benytte fellesfunksjonalitet i nye Altinn (autentisering via Maskinporten, autorisasjon og tilgangspakker, og felles arbeidsflate via Dialogporten).

Alle som bruker Skatteetatens tjenester, vil bli påvirket av reetableringen.

Selv om Altinn II stenger 19. juni 2026, er siste mulighet for innsending via Altinn II 31. mai 2026.

Skatteetaten har reetablert og tilgjengeliggjort de fleste av våre skjema og tjenester på skatteetaten.no. Resten vil bli fortløpende publisert og gjort tilgjengelig gjennom våren 2026. Målet er at rapportering for inntektsåret 2025 kan skje i nye tjenester i 2026, innen gjeldende frister.

Viktige datoer:

  • 4. mars – Klientdelegering og tilgangsstyring for privatpersoner mulig i Altinn 3.
  • 31. mai - innsending via Altinn II stenger.
  • 19. juni – Altinn II stenger.
  • 19. juni – Altinn II roller kan ikke lenger delegeres til nye personer/ for nye tjenester. Kun delegering med tilgangspakker.
  • 31. desember – Altinn II roller fjernes, og all delegering må være utført (tilgangspakker).

Endringene omfatter disse tjenestene fra Skatteetaten:

  • Tredjepartsopplysninger (alle ordninger for grunnlagsdata)
  • Aksjonærregisteroppgaven
  • A-ordningen
  • Diverse skattetjenester
  • Særavgifter
  • Motorvogn
  • Innkreving
  • Toll
  • Vedlegg (RF-1301)

Listen er ikke uttømmende.

Tjenester som allerede er modernisert, som skattemeldingen og mva-meldingen, får etter planen ingen tekniske endringer, men blir berørt av overgangen fra Altinn-roller til tilgangspakker.

Tilgangspakker vil erstatte dagens Altinn-roller. Tilgangspakkene knyttes til en ressurs (tjeneste, skjema) for å styre hvem som skal kunne bruke tjenesten.​
Delegeringer gjort i dagens Altinn må gjøres på nytt. Unntaket er roller man har fått via Enhetsregisteret og spesialroller for regnskapsførere og revisorer som er planlagt automatisk overført (For deg som er regnskapsfører, revisor eller rådgiver – hva blir nytt).

Mer informasjon om de forskjellige tilgangspakkene

Systembruker vil erstatte dagens virksomhetsbruker. En systembruker er en upersonlig bruker som lar virksomheter gi fullmakter til f.eks en systemleverandør, slik at denne kan løse oppgaver på vegne av virksomheten. Det er leverandørens ansvar (i samarbeid med sin kunde) å tilse at kun de som skal ha tilgang, faktisk har det.

Samarbeidsportalen: Systembruker

Arbeidsflate erstatter dagens Altinn innboks og arkiv. På arbeidsflaten vil du ha tilgang til den samme dialogen fra Skatteetaten, enten du logger på Altinn eller på skatteetaten.no.

Samarbeidsportalen: Arbeidsflate

Dialogporten er et nytt API som gir offentlig sektor mulighet til å tilgjengeliggjøre og sammenstille digitale dialoger, tjenester, data og post på tvers av virksomheter og tekniske plattformer. Dialogporten gjør det for eksempel mulig for systemleverandører å presentere dialoger direkte i sine systemer.

Samarbeidsportalen: Dialogporten

Maskinporten er en løsning for tilgangsstyring for virksomheter som utveksler data maskin-til-maskin – og sørger for sikker autentisering og tilgangskontroll. Den er en sikkerhetsmekanisme for trygg deling.

Samarbeidsportalen: Maskinporten

For mer informasjon om produktene i nye Altinn, se modernisering av Altinn (Samarbeidsportalen).

Vi tilbyr en kanal på Slack for dialog mellom utviklere i prosjektet og utviklere hos systemleverandører og virksomheter.

For dokumentasjon og test, se våre GitHub-sider.

Har du spørsmål til Skatteetaten om reetablering av våre tjenester, kan du sende e-post til [email protected]. Denne e-postadressen er midlertidig og vil bli avsluttet i 2026, når prosjektet avvikles.

Se også

Du kan også lese hva du må gjøre hvis du har andre roller: