Slik kobler du deg opp til våre reetablerte tjenester

Her er en overordnet sjekkliste over de nødvendige stegene for oppkobling av sluttbrukersystem til noen av Skatteetatens reetablerte tjenester.

Sjekklisten gjelder disse tjenestene:

  • Aksjonærregisteroppgaven
  • Tredjepartsopplysninger
  • A-ordningen
  • Tjenester på skatteområdet (søknad utsatt frist, skattekort til arbeidsgiver)

Sjekklisten er laget for deg som lager systemer eller tjenester for brukere som skal rapportere til Skatteetaten. Lager du et eget system for å rapportere til Skatteetaten, og ønsker å integrere det mot Skatteetatens tjenester, kan du også følge samme sjekkliste, men se egne merknader som gjelder spesifikt for deg.

Sjekkliste

Vi oppfordrer alle til å begynne oppkobling og testing så tidlig som mulig. Erfaring viser at punkt 5, som krever at brukerne også gjør tilpasninger, tar noe tid. Vi anbefaler å planlegge godt og sette av nok tid.

Maskinporten og Maskinporten-klient er en løsning for tilgangsstyring for virksomheter som utveksler data. Løsningen sørger for sikker autentisering og tilgangskontroll for datautveksling mellom virksomheter (maskin-til-maskin).

Vi krever at maskinporten og maskinporten-klient er i bruk for de nye maskin-til-maskin tjenestene til Skatteetaten.  For å kunne få tilgang til Maskinporten må du ha norsk organisasjonsnummer. For mer informasjon se Maskinporten (digdir.no).

Gjennom signering av bruksvilkår fra Digitaliseringsdirektoratet (Digdir) får man tilgang til både testmiljø og produksjonsmiljø hos Digdir.

Følg fremgangsmåten for å koble opp til Maskinporten (digdir.no).

En maskinporten-klient kan opprettes enten i Samarbeidsportal eller ved bruk av API. Opprettelse av en maskinporten-klient forutsetter oppkobling til Maskinporten. For mer informasjon, se Maskinporten klient (altinn.no).

Skatteetatens tjenester bruker fellesfunksjonalitet fra Altinn for blant annet autentisering og autorisasjon. For å bruke Skatteetatens tjenester trenger du derfor tilgang til disse fellesfunksjonalitene fra Altinn. Les mer i Samarbeidsportalen (digdir.no).

Gjennom signering av bruksvilkår fra Digitaliseringsdirektoratet (Digdir) får man tilgang til både testmiljø og produksjonsmiljø hos Digdir.

Dette er tilganger du må ha fra Digdir for å bruke Skatteetatens tjenester:

  • altinn:authentication/systemuser.request.read
  • altinn:authentication/systemuser.request.write
  • altinn:authentication/systemregister.write
  • digdir:dialogporten (valgfri)

Tilgang får du via registreringsskjema hos Digdir:

Registreringsskjema for sluttbrukersystemleverandør

For mer informasjon om systembruker se punkt 5.1.
For mer informasjon om systemregisteret se punkt 3.
For mer informasjon om dialogporten se punkt 2.2.

Dialogporten gjør det mulig med plattformuavhengig tilgang til dialoger. Gjennom oppkobling til Dialogporten kan systemleverandører hente dialoger og tilgjengeliggjøre disse i sine systemer.

Oppkobling forutsetter tilgang til Dialogporten API-et. For mer informasjon se Dialogporten (digdir.no)

For å ta i bruk Skatteetatens tjenester fra sluttbrukersystemet, må systemet registreres i Altinn sitt systemregister.

Dette kan gjøres via API (altinn.no). Systemet må knyttes til Maskinporten-klienten opprettet i steg 3.

Hvilke systemtilganger, også kjent som tilgangspakker, som systemet må ha for å bruke Skatteetatens tjenester, er beskrevet i API-dokumentasjon hos Skatteetaten.

Dagens roller i Altinn skal erstattes av tilgangspakker. For mer informasjon se tilgangspakker (altinn.no).

For å få tilgang til Skatteetatens reetablerte API-er kan du ta kontakt med oss på e-post: [email protected]

Da må du oppgi hvilke(n) type tjeneste(r) du ønsker å få tilgang til.

For mer informasjon se dokumentasjon i GitHub:

Erfaringsmessig tar dette punktet noe tid, da det krever involvering av brukere. Vi oppfordrer derfor alle til å sette av nok tid til gjennomføringen av dette punktet.

Systembruker er en ny standard for tilgangsstyring ved utveksling av data mellom sluttbruker (for eksempel regnskapsfører), sluttbrukersystem (for eksempel regnskapssystem) og offentlig sektor (for eksempel Skatteetaten) som overtar for dagens virksomhetsbruker.

En systembruker defineres ved at sluttbrukersystemleverandøren angir hvilke tilgangspakker den skal gi tilgang til. Hvilke tilgangspakker som er mulig å velge er angitt av tilgangspakkene som systemet ble konfigurert med i Steg 4. For å vite hvilke tilgangspakker en systembruker skal ha, må du som systemleverandør vite hvilke tjenester dine brukere trenger for utføre ulike arbeidsoppgaver. I Skatteetatens API-dokumentasjon er det angitt hvilke tilgangspakker som gjelder for tjenestene.

Skatteetaten krever systembruker for bruk av følgende reetablerte tjenester: aksjonærregisteroppgaven, tredjepartsopplysninger, a-ordningen og tjenester på skatteområdet (søknad utsatt frist, skattekort til arbeidsgiver).

En oversikt over tjenestene vi reetablere finner du her  på informasjonssiden for leverandører av sluttbrukersystemer.

For å kunne opprette systembrukere for brukerne, forutsettes det at sluttbrukersystemet har opprettet integrasjon mot Altinns API for administrasjon av systembrukere.

Brukerne må godkjenne at sluttbrukersystemet får tilgang til å operere på vegne av dem. Dette gjør de ved å godkjenne forespørsler fra sluttbrukersystemet om at det opprettes systembrukere for dem. De gir da systemet fullmakt til å benytte Skatteetatens tjenester.

Dersom du har et eget system som skal benyttes av din egen virksomhet, må du følge samme prosedyre.

Det er systemleverandørens ansvar – i samarbeid med kunden – å sikre at ansattes tilgang til systemet (tilgangsstyringen til systemet) er tilstrekkelig granulert. Ulike arbeidsoppgaver kan kreve ulike systembrukere. Dette gjelder også for virksomheter som drifter egne systemer og setter opp systembruker selv.

Oppkobling forutsetter tilgang til scope for tjenestene du ønsker oppkobling til (se Steg 5) samt autentisering vha Maskinporten og systembruker.

Det er viktig at systemleverandører tester integrasjoner mot testmiljøet til Skatteetaten og Digdir, og gjør seg kjent med de nye løsningene. 

Både Digdir og Skatteetaten bistår i denne prosessen. Skatteetaten har utviklere og funksjonelle ressurser på vår Slack som kan svare på alle spørsmål og veilede i prosessen. For tilgang til vår Slack, se punkt 2 (GitHub).

Systemleverandører tilpasser integrasjoner mot produksjonsmiljøet til Skatteetaten og Digdir, og ruller ut til sine brukere.