{"openapi":"3.1.0","info":{"description":"Tjenesten leverer opplysninger om fastsatt merverdiavgift.","version":"1.0.0","title":"Mva fastsetting API","termsOfService":"https://www.skatteetaten.no/deling/bruksvilkar-for-delingstjenester","contact":{"name":"Brukerstøtte","url":"https://www.skatteetaten.no/deling/kontakt/"}},"externalDocs":{"description":"Dokumentasjon på Skatteetatens GitHub","url":"https://skatteetaten.github.io/api-dokumentasjon/api/mvafastsetting"},"servers":[{"url":"https://mvafastsetting.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://mvafastsetting.api.skatteetaten.no/v1","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:mvafastsetting"]}],"components":{"securitySchemes":{"maskinporten":{"type":"http","description":"Maskinporten benyttes for autentisering","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"MFA-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstått","example":"Oppgitt rettighetspakke er ugyldig."},"korrelasjonsid":{"type":"string","description":"Korrelasjonsid","example":"123e4567-e89b-12d3-a456-426655440000"}}},"MerverdiavgiftFastsetting":{"type":"object","description":"","properties":{"skattepliktig":{"description":"skattepliktig","$ref":"#/components/schemas/Organisasjonsnummer"},"forespurtSkattleggingsperiode":{"type":"array","description":"forespurt skattleggingsperiode (terrmin)","items":{"$ref":"#/components/schemas/FastsattMerverdiavgiftForSkattleggingsperiode"}}}},"FastsattMerverdiavgift":{"type":"object","description":"","properties":{"mvaMelding":{"description":"skattemelding merverdiavgift","$ref":"#/components/schemas/MvaMelding"},"mvaSpesifikasjonslinje":{"type":"array","description":"merverdiavgift spesifikasjon per mva-kode","items":{"$ref":"#/components/schemas/MvaSpesifikasjonslinje"}}}},"FastsattMerverdiavgiftForSkattleggingsperiode":{"type":"object","description":"","properties":{"egenfastsattMerverdiavgift":{"description":"egenfastsatt (selvdeklarert) merverdiavgift for skattleggingsperiode(termin)","$ref":"#/components/schemas/FastsattMerverdiavgift"},"myndighetsfastsattMerverdiavgift":{"description":"myndighetsfastsatt merverdiavgift for termin","$ref":"#/components/schemas/FastsattMerverdiavgift"},"skattleggingsperiode":{"description":"skattelggingsperiode fastsetting gjelder","$ref":"#/components/schemas/Skattleggingsperiode"},"meldingskategori":{"description":"meldingskategori - alminnelig, primærnæring, kompensasjon osv","$ref":"#/components/schemas/Meldingskategori"},"innleveringsfrist":{"description":"frist for levering av mva melding","$ref":"#/components/schemas/Dato"},"fastsattMerverdiavgift":{"description":"fastsatt merverdiavgift for skattleggingsperiode(termin)","$ref":"#/components/schemas/BetalEllerTilgode"}}},"MvaMelding":{"type":"object","description":"","properties":{"meldingsreferanse":{"description":"unik identifikator for innsendt mva-melding","$ref":"#/components/schemas/Tekst"},"innsendingstidspunkt":{"description":"tidspunkt mva-melding ble levert","$ref":"#/components/schemas/DatoKlokkeslett"}}},"MvaSpesifikasjonslinje":{"type":"object","description":"dokumentasjon av anvendelsen av mva-reglene (<a href='b29bf6f0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","properties":{"mvaKode":{"description":"mva-kode gitt av Skatteetaten som samsvarer med det som er benyttet i regnskapet; forenklet SAF_T kode beskrivet her: https://www.skatteetaten.no/globalassets/bedrift-og-organisasjon/starte-og-drive/rutiner-regnskap-og-kassasystem/saf-t-regnskap/norwegian-saf-t-standard-vat-codes.pdf (<a href='9b38dfa0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/MvaKode"},"spesifikasjon":{"description":"videre spesifikasjon av merverdiavgift (hvis det gjelder justering, tap på krav eller tilbakeføring av merverdiavgift)  (<a href='be53d7b0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/MvaSpesifikasjon"},"grunnlag":{"description":"grunnlag for merverdiavgift tilsvarende valgt mva-kode, typisk omsetning. (<a href='38e2a35a-4758-11e6-b166-8e8050d1fd96'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"sats":{"description":"Prosentsatsen som er benyttet for merverdiavgiftsberegning (<a href='46abe1e1-cf00-11e9-b304-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Sats"},"merverdiavgift":{"description":"Bokført beløp for merverdiavgift (<a href='38e2a356-4758-11e6-b166-8e8050d1fd96'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"erFradrag":{"description":"viser om rapportert mva på mva-kode er fradrag","$ref":"#/components/schemas/Boolsk"}}},"Skattleggingsperiode":{"type":"object","description":"","properties":{"skattleggingsperiodetype":{"description":"skattleggingsperiodetype - årlig, to-månedlig osv","$ref":"#/components/schemas/SkattleggingsperiodeType"},"periode":{"description":"skattleggingsperiode","$ref":"#/components/schemas/SkattleggingsperiodeMerverdiavgift"},"aar":{"description":"år","$ref":"#/components/schemas/Aarstall"},"periodeStart":{"description":"startdato for skattleggingsperiode(termin)","$ref":"#/components/schemas/Dato"},"periodeSlutt":{"description":"sluittdato for skattleggingsperiode(termin)","$ref":"#/components/schemas/Dato"}},"required":["skattleggingsperiodetype","periode","aar","periodeStart","periodeSlutt"]},"SkattleggingsperiodeType":{"type":"string","description":"frekvens for levering av mva-melding; kan være årlig, 2-måned m.m.","enum":["aar","seksMaaned","treMaaned","toMaaned","maaned","halvMaaned","uke"]},"Tekst":{"type":"string","description":"vilkårlig lang sekvens av tegn inkludert aksenter og spesielle tegn fra standardiserte tegnsett (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52af3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","maxLength":4000},"Organisasjonsnummer":{"type":"string","description":"9 sifret nummer gitt de som er registrert i Enhetsregisteret. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":9,"pattern":"[0-9]+","maxLength":9},"Meldingskategori":{"type":"string","description":"(<a href='https://data.skead.no/web/datakatalog/kodeliste/e09eec23-2672-4913-bdef-815623de38e2/1/'>Kodelistereferanse</a>)"},"Dato":{"type":"string","description":"gir verdier for år, måned og dag. Kodes som en tekststreng etter datoformatering spesifisert i  ISO 8601 (ISO 8601:2004 Data elements and interchange formats -- Information interchange -- Representation of dates and times). Eksempel : 1998-12-21 eller 19981221. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aed-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"date"},"BetalEllerTilgode":{"type":"object","description":"","properties":{"tilGode":{"description":"","$ref":"#/components/schemas/BeloepSomHeltall"},"aaBetale":{"description":"","$ref":"#/components/schemas/BeloepSomHeltall"}},"anyOf":[{"oneOf":[{"required":["tilGode"]},{"required":["aaBetale"]}]}]},"DatoKlokkeslett":{"type":"string","description":"en kombinasjon av typene Dato og Klokkeslett. Kodes som en tekststreng etter datoformatering spesifisert i ISO 8601 (ISO 8601:2004 Data elements and interchange formats -- Information interchange -- Representation of dates and times). (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aee-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"date-time"},"MvaKode":{"type":"string","description":"(<a href='https://data.skead.no/web/datakatalog/kodeliste/030c2092-7e8d-4027-a432-e494c0d5557e/1/'>Kodelistereferanse</a>) (<a href='9b38dfa0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)"},"MvaSpesifikasjon":{"type":"string","description":"(<a href='https://data.skead.no/web/datakatalog/kodeliste/66bf846d-94c2-4a96-bee5-79e0924711aa/1/'>Kodelistereferanse</a>)"},"Beloep":{"type":"number","description":"en sum av penger brukt i en kontekst. Dette kan være en transaksjon, saldo o.l. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e146-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"double"},"Sats":{"type":"string","description":"Prosentsatsen som er brukt for merverdiavgiftsberegning (<a href='https://data.skead.no/web/datakatalog/kodeliste/5b342c00-7b73-4bae-8cc2-8be9999ae6af/1/'>Kodelistereferanse</a>) (<a href='46abe1e1-cf00-11e9-b304-005056821322'>Begrepsreferanse</a>)"},"Boolsk":{"type":"boolean","description":"angir verdien sann eller usann (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aec-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)"},"SkattleggingsperiodeMerverdiavgift":{"type":"string","description":"(<a href='https://data.skead.no/web/datakatalog/kodeliste/3291c1bb-8b85-46bc-a553-3ff39fe40143/1/'>Kodelistereferanse</a>)"},"Aarstall":{"type":"string","description":"årstall er et tall som angir årets nummer i tidsregningen i den gregorianske kalender (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e14a-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"year"},"BeloepSomHeltall":{"type":"integer","description":"en sum av penger i hele kroner brukt i en kontekst. Dette kan være en transaksjon, saldo o.l. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e146-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"int64"}}},"paths":{"/{rettighetspakke}/fastsettinger/{organisasjonsnummer}":{"get":{"summary":"Hent opplysninger om fastsatt MVA for et oppgitt organisasjonsnummer.","description":"Hent opplysninger om fastsatt MVA med et gitt organisasjonsnummer for en gitt periode.","operationId":"hentMerverdiavgiftFastsetting","tags":["Mva fastsetting"],"parameters":[{"name":"rettighetspakke","in":"path","description":"Datakonsumenter plasseres i en rettighetspakke (per datasett) basert paa en juridisk vurdering. Rettighetspakken styrer Skjermingsregler, Filtrering og Detaljering som benyttes nÃ¥r det gis innsyn i data i datasett.","required":true,"schema":{"type":"string"}},{"name":"organisasjonsnummer","in":"path","description":"Organisasjonsnummer for virksomhet","required":true,"schema":{"type":"string","example":123456789}},{"name":"fraOgMed","in":"query","description":"Fra og med hvilken periode forepørselen gjelder for.","required":false,"schema":{"type":"string","example":"2025-01-01"}},{"name":"tilOgMed","in":"query","description":"Til og med hvilken periode forepørselen gjelder for. Valgfritt parameter. Dersom tilOgMed ikke er satt brukes dagens dato som parameter.","required":false,"schema":{"type":"string","example":"2025-12-01"}},{"name":"Korrelasjonsid","in":"header","description":"Korrelasjonsid, unik identifikator for den tekniske forespoerselen. Maa vaere paa UUID-format","required":false,"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426655440000"}}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerverdiavgiftFastsetting"}}}},"default":{"description":"Diverse feilmeldinger, se egen dokumentasjon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}