{"openapi":"3.1.0","info":{"description":"Tjeneste som gir næringsdrivende oversikt over sine fremtidige forpliktelser overfor Skatteetaten. Inneholder frist for mva-melding og for skattemelding næring.","version":"1.0.0","title":"Frister 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/frister"},"servers":[{"url":"https://frister.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://frister.api.skatteetaten.no/v1","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:frister"]}],"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":"FRI-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"}}},"Frister":{"type":"object","description":"alle aktiviteter med tidsfrister relevant for en gitt virksomhet, begrenset enten til frister som faller innenfor et gitt tidsrom eller forfalte frister","properties":{"kilder":{"type":"array","description":"Angir hvilken kilde det er hentet fra (skatt | merverdiavgift)","items":{"$ref":"#/components/schemas/Kilde"}},"virksomhet":{"description":"Tilsvarer orgnr ved oppslag","$ref":"#/components/schemas/Organisasjonsnummer"}},"required":["kilder"]},"Frist":{"type":"object","description":"En oppgave som virksomheten må gjøre slik at kan svare plikt på registering, rapportering, dokumentasjon eller betaling","properties":{"tittel":{"description":"Språk og tekstlig tittel for aktiviteten","$ref":"#/components/schemas/Tekst"},"aktivitetsbeskrivelse":{"description":"Språk og tekstlig beskrivelse for aktiviteten","$ref":"#/components/schemas/Tekst"},"aktivitetstype":{"description":"En av de forskjellige oppgavetypene: betalingskrav, rapporteringskrav, dokumentasjonskrav, registreringskrav, ukjent","$ref":"#/components/schemas/aktivitetstype"},"frist":{"description":"Frist for utførelse av aktiviteten","$ref":"#/components/schemas/Dato"}}},"Kilde":{"type":"object","description":"Angir hvilken kilde det er hentet fra (skatt eller merverdiavgift)","properties":{"kilde":{"description":"Angir hvilken kilde det er hentet fra (skatt | merverdiavgift)","$ref":"#/components/schemas/Forretningsomraade"},"frister":{"type":"array","description":"Alle aktiviteter fra en kilde","items":{"$ref":"#/components/schemas/Frist"}},"status":{"description":"en status kan være OK eller Feilet","$ref":"#/components/schemas/Tekst"}},"required":["frister"]},"aktivitetstype":{"type":"string","description":"Dette er en liste som grovindeler de forskjellige oppgavetypene, kan påvirke rekkefølge ved listevisninger og hvordan den grafiske utformingen gjøres ved presentasjon.","enum":["betalingskrav","rapporteringskrav","dokumentasjonskrav","registreringskrav","ukjent"]},"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},"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"},"Forretningsomraade":{"type":"string","description":"(<a href='https://data.skead.no/web/datakatalog/kodeliste/d544701f-1b2f-4ba4-9857-1544aa4d875f/0.5/'>Kodelistereferanse</a>)"}}},"paths":{"/{rettighetspakke}/{virksomhet}/kommende":{"get":{"summary":"Hent kommende frister for en virksomhet.","description":"Henter alle aktiviteter med tidsfrister relevant for en gitt virksomhet, begrenset til frister som faller innenfor et gitt tidsrom.","operationId":"hentKommendeFrister","tags":["Frister"],"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":"virksomhet","in":"path","description":"Organisasjonsnummer (ni siffer) som identifiserer virksomheten","required":true,"schema":{"type":"string","example":123456789}},{"name":"fraOgMed","in":"query","description":"Fra og med hvilken dato (ISO 8601) forepørselen gjelder for","required":true,"schema":{"type":"string","example":"2024-01-01"}},{"name":"tilOgMed","in":"query","description":"Til og med hvilken dato (ISO 8601) forepørselen gjelder for. Valgfritt parameter. Dersom ikke oppgitt settes denne 11 måneder frem i tid.","required":false,"schema":{"type":"string","example":"2024-12-31"}},{"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"}}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Frister"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}},"/{rettighetspakke}/{virksomhet}/forfalte":{"get":{"summary":"Hent forfalte frister for en virksomhet.","description":"Henter alle forfalte aktiviteter for en gitt virksomhet.","operationId":"hentForfalteFrister","tags":["Frister"],"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":"virksomhet","in":"path","description":"Organisasjonsnummer (ni siffer) som identifiserer virksomheten.","required":true,"schema":{"type":"string","example":123456789}},{"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"}}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Frister"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}