{"openapi":"3.0.3","info":{"description":"Tjenesten leverer fastsatte mva-meldinger. Fastsatt betyr at skattemeldingen er myndighetsfastsatt, manuelt innlevert, eller automatisk innlevert ved utløp av innleveringsfrist.","version":"1.1.0","title":"Mva-melding 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/mvamelding"},"servers":[{"url":"https://mvamelding.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://mvamelding.api.skatteetaten.no/v1","description":"Produksjon"}],"components":{"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell haandtering","example":"MVA-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstaatt","example":"Fant ikke gitt personidentifikator"},"korrelasjonsid":{"type":"string","description":"Korrelasjonsid","example":"123e4567-e89b-12d3-a456-426655440000"}},"xml":{"name":"feil","namespace":"urn:no:skatteetaten:datasamarbeid:feil:v1"}},"MvaMelding":{"type":"object","description":"melding som leveres som ledd i egenfastsetting av merverdiavgift, jf. skatteforvaltningsloven § 8-3 (<a href='http://begrepskatalog/begrep/6b41c6c8-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","properties":{"skattegrunnlagOgBeregnetSkatt":{"description":"Skattegrunnlag: Opplysninger om den skattepliktige, den skattepliktiges økonomi (inntekt/fradrag/formue/gjeld), innførsel, omsetning og uttak og den skattepliktiges produksjon og varehåndtering, klassifisert, verdisatt og korrekt periodisert. Den skattepliktige skal kunne observere skattegrunnlaget i sine omgivelser.Beregnet skatt: det beløpet som fremkommer etter at skattesatser er anvendt på beregningsgrunnlaget (<a href='https://data.skatteetaten.no/begrep/6b41c6c4-50cd-11e7-b7c5-005056821322; https://data.skatteetaten.no/begrep/649cbcd4-ad07-11e8-8ffd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/SkattegrunnlagOgBeregnetSkatt"},"skattepliktig":{"description":"fysisk eller juridisk person som skal svare eller få kompensert skatt (<a href='https://data.skatteetaten.no/begrep/6b41c6ce-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Skattepliktig"},"meldingskategori":{"description":"Inndeling som viser hva skattemeldingen gjelder (<a href='https://data.skatteetaten.no/begrep/90fffdc0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Meldingskategori"},"fastsettingsstatus":{"description":"","$ref":"#/components/schemas/FastsettingsstatusForPeriode"},"referanse":{"description":"unikt identifikator for mva-melding (ekstern deling tjeneste).","$ref":"#/components/schemas/Tekst"}},"xml":{"name":"mvaMelding"},"required":["skattegrunnlagOgBeregnetSkatt","skattepliktig","meldingskategori","referanse"]},"FastsettingsstatusForPeriode":{"type":"object","description":"","properties":{"status":{"description":"","$ref":"#/components/schemas/Fastsettingsstatus"},"aarsakTilMyndighetsfastsetting":{"description":"","$ref":"#/components/schemas/AarsakTilMyndighetsfastsetting"}},"required":["status"]},"MvaSpesifikasjonslinje":{"type":"object","description":"dokumentasjon av anvendelsen av mva-reglene (<a href='https://data.skatteetaten.no/begrep/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='https://data.skatteetaten.no/begrep//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='https://data.skatteetaten.no/begrep/be53d7b0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/MvaSpesifikasjon"},"grunnlag":{"description":"grunnlag for merverdiavgift tilsvarende valgt mva-kode, typisk omsetning. (<a href='https://begrepskatalog/begrep/38e2a35a-4758-11e6-b166-8e8050d1fd96'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"sats":{"description":"Prosentsatsen som er benyttet for merverdiavgiftsberegning (<a href='https://data.skatteetaten.no/begrep/46abe1e1-cf00-11e9-b304-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Sats"},"merverdiavgift":{"description":"Bokført beløp for merverdiavgift (<a href='https://begrepskatalog/begrep/38e2a356-4758-11e6-b166-8e8050d1fd96'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"}},"required":["mvaKode","merverdiavgift"]},"SkattegrunnlagOgBeregnetSkatt":{"type":"object","description":"Skattegrunnlag: Opplysninger om den skattepliktige, den skattepliktiges økonomi (inntekt/fradrag/formue/gjeld), innførsel, omsetning og uttak og den skattepliktiges produksjon og varehåndtering, klassifisert, verdisatt og korrekt periodisert. Den skattepliktige skal kunne observere skattegrunnlaget i sine omgivelser.Beregnet skatt: det beløpet som fremkommer etter at skattesatser er anvendt på beregningsgrunnlaget (<a href='https://data.skatteetaten.no/begrep/6b41c6c4-50cd-11e7-b7c5-005056821322; https://data.skatteetaten.no/begrep/649cbcd4-ad07-11e8-8ffd-005056821322'>Begrepsreferanse</a>)","properties":{"skattleggingsperiode":{"description":"perioden som en gitt skattefastsetting gjelder for;  alternativt begrep: termin. (<a href='https://data.skatteetaten.no/begrep/6b41c6d1-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Skattleggingsperiode"},"fastsattMerverdiavgift":{"description":"sum fastsatt merverdiavgift for perioden (<a href='http://begrepskatalog/begrep/2a88aa6c-d8d6-11e7-ae2b-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"mvaSpesifikasjonslinje":{"type":"array","description":"dokumentasjon av anvendelsen av mva-reglene (<a href='https://data.skatteetaten.no/begrep/b29bf6f0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)","items":{"$ref":"#/components/schemas/MvaSpesifikasjonslinje"}}},"required":["skattleggingsperiode","fastsattMerverdiavgift"]},"Skattepliktig":{"type":"object","description":"fysisk eller juridisk person som skal svare eller få kompensert skatt (<a href='https://data.skatteetaten.no/begrep/6b41c6ce-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","properties":{"organisasjonsnummer":{"description":"(<a href='https://data.skatteetaten.no/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Organisasjonsnummer"}},"required":["organisasjonsnummer"]},"Skattleggingsperiode":{"type":"object","description":"tilpasset datatype for Skattleggingsperiode for deling (erstatter datatype PeriodeBeskrivelse med en aggregert kodeliste for alle skattleggingsperioder)","properties":{"periode":{"description":"","$ref":"#/components/schemas/SkattleggingsperiodeMerverdiavgift"},"aar":{"description":"","$ref":"#/components/schemas/Aarstall"}},"required":["periode","aar"]},"Meldingskategori":{"type":"string","description":"(<a href='http://kodelistekatalog/kodeliste/merverdiavgift/meldingskategori'>Kodelistereferanse</a>)"},"Tekst":{"type":"string","description":"vilkårlig lang sekvens av tegn inkludert aksenter og spesielle tegn fra standardiserte tegnsett (<a href='https://data.skatteetaten.no/begrep/20b52af3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","maxLength":4000},"Fastsettingsstatus":{"type":"string","description":"","enum":["meldingIkkeLevertForTermin","meldingLevert","egenfastsattMerverdiavgift","myndighetsfastsattMerverdiavgift"]},"AarsakTilMyndighetsfastsetting":{"type":"string","description":"","enum":["manglendeMvaMelding","uriktigMvaMelding","annet"]},"MvaKode":{"type":"string","description":"(<a href='http://kodelistekatalog/kodeliste/merverdiavgift/mvaKodeSAFT'>Kodelistereferanse</a>) (<a href='https://data.skatteetaten.no/begrep//9b38dfa0-145a-11eb-8086-0050568351d2'>Begrepsreferanse</a>)"},"MvaSpesifikasjon":{"type":"string","description":"(<a href='http://kodelistekatalog/kodeliste/merverdiavgift/mvaSpesifikasjon'>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/begrep/20b2e146-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"double"},"Sats":{"type":"string","description":"Prosentsatsen som er brukt for merverdiavgiftsberegning (<a href='http://kodelistekatalog/kodeliste/merverdiavgift/sats'>Kodelistereferanse</a>) (<a href='https://data.skatteetaten.no/begrep/46abe1e1-cf00-11e9-b304-005056821322'>Begrepsreferanse</a>)"},"Organisasjonsnummer":{"type":"string","description":"9 sifret nummer gitt de som er registrert i Enhetsregisteret. (<a href='https://data.skatteetaten.no/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":9,"pattern":"[0-9]+","maxLength":9},"SkattleggingsperiodeMerverdiavgift":{"type":"string","description":"(<a href='http://kodelistekatalog/kodeliste/merverdiavgift/skattleggingsperiodeMerverdiavgift'>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/begrep/20b2e14a-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"year"}}},"paths":{"/{rettighetspakke}/meldinger/{referanse}":{"get":{"summary":"Hent MVA-meldingen for en oppgitt referanse.","description":"Hent MVA-melding med en meldingsreferanse fra hendelseslista.","operationId":"hentMvaMeldingMedReferanse","tags":["MVA melding"],"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":"referanse","in":"path","description":"Returnerer mva-melding med gitt meldingsreferanse hentet fra hendelseslisten.","required":true,"schema":{"type":"string"},"example":"281a19cd-273a-4258-8f99-21e3b70e9fdf"},{"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/MvaMelding"}},"application/xml":{"schema":{"$ref":"#/components/schemas/MvaMelding"}}}},"default":{"description":"Diverse feilmeldinger, se egen dokumentasjon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}