{"openapi":"3.0.3","info":{"description":"Tjenesten leverer status på mva-melding og informasjon fra reskontro for en virksomhet for de siste tre terminene.","version":"1.1.0","title":"Mva meldingsopplysning 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/mva_meldingsopplysning"},"servers":[{"url":"https://mvameldingsopplysning.api.skatteetaten-test.no/v1","description":"Ekstern testmiljø (Test)"},{"url":"https://mvameldingsopplysning.api.skatteetaten.no/v1","description":"Produksjon (Prod)"}],"paths":{"/{rettighetspakke}/{organisasjonsnummer}":{"get":{"summary":"Hent mva meldingsopplysninger for enhet","description":"Hent mva meldingsopplysninger for enhet. Resultatsettet vil inneholde informasjon fra de siste 3 terminene.","operationId":"HentMvaMeldingsopplysningerForEnhet","tags":["Mva meldingsopplysninger"],"parameters":[{"name":"rettighetspakke","in":"path","description":"Datakonsumenter plasseres i en rettighetspakke (per datasett) basert på 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","required":true,"schema":{"$ref":"#/components/schemas/Organisasjonsnummer"}},{"name":"Korrelasjonsid","in":"header","description":"Korrelasjonsid, unik identifikator for den tekniske forespørselen. Må være på UUID-format","required":false,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426655440000"},{"name":"AltinnSamtykke","in":"header","description":"","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MvaAlminneligNaeringDto"}},"application/xml":{"schema":{"$ref":"#/components/schemas/MvaAlminneligNaeringDto"}}}},"400":{"description":"Valideringsfeil","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}},"403":{"description":"Bruker har ikke tilgang","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}},"500":{"description":"Tekniske feil","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}},"default":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}},"components":{"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"MVAINN-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstått","example":"Fant ikke gitt personidentifikator"},"korrelasjonsid":{"type":"string","description":"Korrelasjonsid","example":"123e4567-e89b-12d3-a456-426655440000"}},"xml":{"name":"feil"}},"MvaAlminneligNaeringDto":{"type":"object","properties":{"levert":{"$ref":"#/components/schemas/DatoKlokkeslett"},"forespurteOrganisasjon":{"$ref":"#/components/schemas/Organisasjonsnummer"},"mvaAlminneligNaering":{"$ref":"#/components/schemas/MvaAlminneligNaering"}}},"Organisasjonsnummer":{"description":"Organisasjonsnummeret","type":"string","pattern":"[0-9]*","example":987654231},"Organisasjonsnavn":{"description":"Organisasjonens navn","type":"string","example":"Freidige Forretninger AS"},"DatoKlokkeslett":{"description":"","type":"string","format":"datetime","example":"2020-01-02T12:43:23"},"Boolsk":{"description":"","type":"boolean"},"Heltall":{"description":"","type":"number"},"Aarstall":{"description":"","type":"string"},"AnsvarligForMvaMelding":{"type":"object","properties":{"organisasjonsnummer":{"$ref":"#/components/schemas/Organisasjonsnummer"},"organisasjonsnavn":{"$ref":"#/components/schemas/Organisasjonsnavn"}}},"MvaAlminneligNaering":{"type":"object","properties":{"skattemeldingsplikt":{"$ref":"#/components/schemas/Skattemeldingsplikt"},"ansvarligForMvaMelding":{"$ref":"#/components/schemas/AnsvarligForMvaMelding"},"samletFastsattOgReskontrofoertForTermin":{"$ref":"#/components/schemas/SamletFastsattOgReskontrofoertForTerminListe"}}},"SamletFastsattOgReskontrofoertForTerminListe":{"description":"","type":"array","items":{"$ref":"#/components/schemas/SamletFastsattOgReskontrofoertForTermin"}},"SamletFastsattOgReskontrofoertForTermin":{"description":"reskontroført mva opplysninger for en bestemt termin</xsd:documentation. https://begrepskatalog/begrep/6b41c699-50cd-11e7-b7c5-005056821322","type":"object","properties":{"gjelderTermin":{"$ref":"#/components/schemas/TerminMedAar"},"fastsettingsperiodeStatus":{"$ref":"#/components/schemas/FastsettingsperiodeStatus"},"erMyndighetsfastsatt":{"$ref":"#/components/schemas/Boolsk"},"grunnMyndighetsfastsatt":{"$ref":"#/components/schemas/GrunnMyndighetsfastsatt"},"mvaAvgift":{"$ref":"#/components/schemas/MvaAvgift"},"mvaGrunnlag":{"$ref":"#/components/schemas/MvaGrunnlag"}}},"MvaGrunnlag":{"description":"Omsetning med høy sats","type":"object","properties":{"innlandOmsetningUttakHoeySats":{"$ref":"#/components/schemas/Heltall"},"innlandOmsetningUttakMiddelsSats":{"$ref":"#/components/schemas/Heltall"},"innlandOmsetningUttakLavSats":{"$ref":"#/components/schemas/Heltall"}}},"MvaAvgift":{"description":"","properties":{"innlandOmsetningUttakHoeySats":{"$ref":"#/components/schemas/Heltall"},"innlandOmsetningUttakMiddelsSats":{"$ref":"#/components/schemas/Heltall"},"innlandOmsetningUttakLavSats":{"$ref":"#/components/schemas/Heltall"},"fradragInnlandInngaaendeHoeySats":{"$ref":"#/components/schemas/Heltall"},"fradragInnlandInngaaendeMiddelsSats":{"$ref":"#/components/schemas/Heltall"},"fradragInnlandInngaaendeLavSats":{"$ref":"#/components/schemas/Heltall"}}},"Skattemeldingsplikt":{"description":"","type":"object","properties":{"termintype":{"$ref":"#/components/schemas/MvaTermintypeForAlminneligOgPrimaerNaering"},"foersteTermin":{"$ref":"#/components/schemas/TerminMedAar"},"sisteTermin":{"$ref":"#/components/schemas/TerminMedAar"}}},"TerminMedAar":{"description":"","type":"object","properties":{"termin":{"type":"string"},"aar":{"$ref":"#/components/schemas/Aarstall"}}},"FastsettingsperiodeStatus":{"description":"","type":"string","enum":["meldingIkkeLevert","meldingLevertUnderBehandling","fastsatt","utenMeldingsplikt"]},"MvaTermintypeForAlminneligOgPrimaerNaering":{"type":"string","enum":["ikkeValgt","ukentlig","aarlig","toMaanedlig","treMaanedlig","seksMaanedlig","halvMaanedlig","maanedlig"]},"GrunnMyndighetsfastsatt":{"description":"grunnen til at skattegrunnlag og beregnet skatt er myndighetsfastsatt - enten manglende eller uriktig mva-melding","type":"string","enum":["manglendeMvaMelding","uriktigMvaMelding","annet"]}}}}