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.
Gjennom signering av bruksvilkår fra Digitaliseringsdirektoratet får du tilgang til både testmiljø og produksjonsmiljø hos Digitaliseringsdirektoratet.
En Maskinporten-klient kan opprettes enten i selvbetjeningsportalen eller ved bruk av API. Se Maskinporten klient (Altinn).
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.
Se Samarbeidsportalen: Ta i bruk - Sluttbrukersystem.
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:
- Dialogporten API (se punkt 4.1)
- Systembruker API (se punkt 5.1)
- Dialogporten API (valgfri - se punkt 2.3)
Tilgang får du via registreringsskjemaet hos Digdir:
Oppkobling forutsetter at du har tilgang til:
- Systembruker API
- Tilgangspakker API
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 å få tilgang til Skatteetatens reetablerte API-er kan du ta kontakt med oss på e-post: [email protected].
Da må du oppgi hvilke typer tjenester du ønsker å få tilgang til.
Les mer om dette i GitHub:
Oppkobling forutsetter tilgang til scope på Skatteetatens tjeneste-API(er) for tjenestene du ønsker oppkobling til.
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). Systembruker overtar for dagens virksomhetsbruker.
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 reetablerer finner du her:
For leverandører av sluttbrukersystemer
For å ta i bruk systembruker, må systemet registreres i Altinn sitt systemregister. Du får tilgang til systemregisteret ved integrasjon mot systembruker og forutsetter bruk av maskinporten-klient.
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.
Dagens roller i Altinn skal erstattes av tilgangspakker.
For å kunne definere og opprette systembrukere for dine brukere, må du som systemleverandør vite hvilke ressurser og tilgangspakker dine brukere trenger.
I testmiljøet vil det for en kort tid være mulig å bruke systembruker som er knyttet direkte til tjenester i testmiljøet før de nye tilgangspakkene er på plass.
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å spørsmål og veilede i prosessen.
Systemleverandører tilpasser integrasjoner mot produksjonsmiljøet til Skatteetaten og Digdir, og ruller ut til sine brukere.
En systemleverandør kan sette opp en systembruker for sine kunders sluttbrukersystemer. Dette innebærer å opprette en systembruker i Altinn, og sende en forespørsel til kunden. Kunden må deretter godkjenne systembrukeren.
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 er riktig satt opp, slik kundene får tilgang tilå utføre arbeidsoppgavene de skal gjøre. Dette gjelder også for virksomheter som drifter egne systemer og setter opp systembruker selv.
Brukerne kan nå sende data til Skatteetaten fra sitt system.
