Innsynstjenester
Innsynstjenester tilgjengelig som API
Endringslogg
| Dato | Hva ble endret? |
|---|---|
| 2022.10.04 | Side for innsynstjenester opprettet |
| 2022.12.02 | La 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:
- 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:
- Tokenet legges i Authorization-header på alle kall til Skatteetatens tjeneste på formatet:
‘Authorization: Bearer
’ - Skatteetaten verifiserer tokenet mot Maskinporten som garanterer at tilbyder har tilgang til å opptre på vegne av angitt konsument på det angitte scopet.
- 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:
- Autentisering mot maskinporten.
- 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