Innsynstjenester

English

Innsynstjenester tilgjengelig som API

Endringslogg

DatoHva ble endret?
2022.10.04Side for innsynstjenester opprettet
2022.12.02La til beskrivelse av tjeneste innsendte meldinger

Maskinporten og autentisering

Introduksjon

For å autentisere med Maskinporten må det gjøres noen forberedelser av virksomheten som skal gjøre spørringer mot Skatteetatens tjenester.

Fremgangsmåte forå ta i bruk maskinporten

1. Ta kontakt med Digitaliseringsdirektoratet for å få tilgang til Maskinporten. Dette kan gjøres via Digdirs samarbeidsportal (https://samarbeid.digdir.no/maskinporten/konsument/119).

2. Opprette bruker i Samarbeidsportalen Når avtale med Digdir er opprettet og tilgang er på plass i Altinn, kan du logge på Samarbeidsportalen. Hvis det er første gang du som konsument logger inn på Samarbeidsportalen, må du opprette en bruker i Samarbeidsportalen.

  • Gå til samarbeid.digdir.no
  • Trykk på “Min profil” oppe i høyre hjørne.
  • Trykk på “Registrer deg” i påloggingsvinduet
  • Registrer bruker med din jobbadresse
  • Bekreft brukeren ved å trykke på lenken som kommer på epost. (NB! Sjekk søppelpost om ikke eposten kommer frem).

NB! Digdir har egne sider som kan benyttes ved feilsøking der man ikke får generert token, feks feilsøking. Hvis man fortsatt har problemer skal Digdirs Servicedesk servicedesk@digdir.no kontaktes.

3. Få tilgang til rettighetspakke (scope) Tilgang til rettighetspakke (scope på Maskinporten) opprettes av Skatteetaten, og må søkes av konsument ved å sende en e-post til mva-modernisering@skatteetaten.no og oppgi organisasjonsnummer. Følgende scope er opprettet for innsynstjenstene:

  • skatteetaten:mvameldinginnsendingsstatus

Når Skatteetaten godkjenner søknaden om tilgang til tjenestene gis virksomheten tilgang til å opprette tokens fra maskinporten for de angitte scopene

4. Bruke Skatteetatens api med token fra Maskinporten. For å gjøre kall til api med gyldig token gjøres følgende:

  1. Gjøre et kall til Maskinporten for å få et token som kan brukes mot Skatteetatens tjeneste. Fremgangsmåten er beskrevet på Digdir sine sider for hvordan bruke maskinporten som konsument:
  2. Tokenet legges i Authorization-header på alle kall til Skatteetatens tjeneste på formatet: ‘Authorization: Bearer
  3. Skatteetaten verifiserer tokenet mot Maskinporten som garanterer at tilbyder har tilgang til å opptre på vegne av angitt konsument på det angitte scopet.
  4. Data returneres for angitt konsument

MVA Innsyn API

Introduksjon

API-ene for innsyn kan brukes av sluttbrukersystemer (SBS) for å innhente tilsvarende informasjon som tilbys via «Min Merverdiavgift».

Forespørsel om innsyn

Bruk av innsyn API-ene forutsetter at SBS-en er autentisert via Maskinporten og at delegering mellom skatteyter og SBS er konfigurert i Altinn.

Forespørsler om innsyn gjøres som HTTP GET kall til Skatteetatens API-er og svar returneres på XML eller JSON format. Hvilket format som er ønsket angis i «Accept» header i HTTP forespørselen. Sekvens for forespørsler om innsyn:

  1. Autentisering mot maskinporten.
  2. Kall mot Skatteetaten

Tjenester

Status for innsending av mva-melding

Tjenesten gir status for inneværende termin(er) og terminer med manglende innsendt mva-melding.

URL : GET https://<env>/api/mva/grensesnittstoette/innsyn/melding/innsending/status/v1/{organisasjonsnummer}

Hvor <env> er miljøspesifikk adresse f.eks. api-sbstest.sits.no

Eksempel : Forespørsel om status for innsending for organisasjonsnummer 123456789

GET https://mp-test.sits.no/api/mva/grensesnittstoette/innsyn/melding/innsending/status/v1/123456789

Headers:
Accept: application/xml
Authorization: Bearer <maskinportentoken>

Response
status: 200 Innhold (body)

Feilmeldinger
Respons 401 - Unauthorized:
Hvis token fra Maskinporten ikke stemmer overens med forespurt organisasjon.

Informasjonsmodell

Grafisk fremstilling av xsd for innsynstjenesten:

Versjon 1.0 av XSD for responsen ligger her: no.skatteetaten.fastsetting.avgift.mva.skattemeldingformerverdiavgift.v1.0.xsd

Innsendte meldinger

Tjenesten gir liste over innsendte meldinger med eventuelt fastsatt avgift. Kall uten referanse gir første side på 10 siste terminer, mens tidligere terminer kan hentes ut med referanse fra siste melding i resultat fra mottatt side.

URL : GET https://<env>/api/mva/grensesnittstoette/innsyn/melding/innsending/melding/v1/{organisasjonsnummer} GET https://<env>/api/mva/grensesnittstoette/innsyn/melding/innsending/melding/v1/{organisasjonsnummer} ?sekvensnummer=<sekvensnummer>

Hvor <env> er miljøspesifikk adresse f.eks. api-sbstest.sits.no

Eksempel : Forespørsel om status for innsending for organisasjonsnummer 123456789 første side GET https://mp-test.sits.no/api/mva/grensesnittstoette/innsyn/melding/innsending/melding/v1/123456789

Eksempel : Forespørsel om status for innsending for organisasjonsnummer 123456789 side fra sekvensnummer 1699575 GET https://mp-test.sits.no/api/mva/grensesnittstoette/innsyn/melding/innsending/melding/v1/123456789?sekvensnummer=1699575

Headers: Accept: application/xml Authorization: Bearer <maskinportentoken>

Response status: 200 Innhold (body)

Feilmeldinger Respons 401 - Unauthorized: Hvis token fra Maskinporten ikke stemmer overens med forespurt organisasjon.

Informasjonsmodell

Grafisk fremstilling av xsd for innsynstjenesten:

Versjon 1.0 av XSD for responsen ligger her: https://git.aurora.skead.no/projects/INMO/repos/xsd_for_merverdiavgift/browse/deling/Innsyn/no.skatteetaten.fastsetting.avgift.mva.innsendtemeldinger.v1.xsd