{"openapi":"3.0.3","info":{"description":"Tjenesten leverer informasjon om forskuddstrekk og restskatt eller beløp til gode i skatteoppgjøret.","version":"2.3.2","title":"Avregning 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/avregning"},"servers":[{"url":"https://avregning.api.skatteetaten-test.no/v2","description":"Ekstern test"},{"url":"https://avregning.api.skatteetaten.no/v2","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:avregning"]}],"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 haandtering","example":"AR-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"}},"Avregning":{"type":"object","description":"","properties":{"personidentifikator":{"description":"Gjeldene personidentifikator for personen det ble søkt på.","$ref":"#/components/schemas/Foedselsnummer"},"inntektsaar":{"description":"Inntektsåret det ble søkt på.","$ref":"#/components/schemas/Aarstall"},"skjermet":{"description":"Returnerer true dersom informasjon er fjernet","$ref":"#/components/schemas/Boolsk"},"skatteoppgjoersdato":{"description":"Dato da skatteoppgjør ble gjort gjeldene","$ref":"#/components/schemas/Dato"},"fastland":{"description":"Verdier for fastland","$ref":"#/components/schemas/Avregningsresultat"},"svalbard":{"description":"Verdier for Svalbard","$ref":"#/components/schemas/Avregningsresultat"},"kildeskattPaaLoenn":{"description":"Verdier for kildeskatt på lønn","$ref":"#/components/schemas/Avregningsresultat"},"ajourholdstidspunkt":{"description":"Tidspunkt for når et sett av informasjon ble registrert hos kilden","$ref":"#/components/schemas/DatoKlokkeslett"}},"xml":{"name":"avregning","namespace":"urn:no:skatteetaten:datasamarbeid:avregning:v2"},"required":["personidentifikator","inntektsaar"]},"Avregningsresultat":{"type":"object","description":"","properties":{"restskatt":{"description":"beløp som viser at innbetalt forskudd ikke dekker bergegnet skatt.  Beløpet er uten rentetillegg.","$ref":"#/components/schemas/BeloepSomHeltall"},"avregnetForskuddstrekk":{"description":"sum forskuddstrekk fra a-meldinger, trekkontroll og manuelt registrerte forskuddstrekk hos skatteoppkrever (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/60a34eb0-e979-11e8-9ab2-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/BeloepSomHeltall"},"beloepTilgode":{"description":"beløp som skal utbetales skattepliktige, eventuelt motregnes mot skyldige offentlige beløp","$ref":"#/components/schemas/BeloepSomHeltall"},"forhaandsfastsatt":{"description":"skatteoppgjør er laget før man starter opp med produksjon av skatteoppgjør for inntektsåret. Forhåndsfastsetting gjelder døde og personer som flytter ut fra Norge i skattleggingsperioden","$ref":"#/components/schemas/Boolsk"},"skatteregnskapskommune":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/649cbcf1-ad07-11e8-8ffd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Kommunenummer"},"beregnetSkatt":{"description":"fastsatt skatt for inntektsåret (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/649cbcd4-ad07-11e8-8ffd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/BeloepSomHeltall"},"nektetGodskrevet":{"description":"forskuddstrekk som ikke er innbetalt og som gjelder daglig leder/styreleder i firmaet (opplysningspliktige) som har sendt inn a-meldingen. Beløpet reduserer forskuddstrekket i skatteoppgjøret","$ref":"#/components/schemas/BeloepSomHeltall"},"tilbakebetaltFoerAvregning":{"description":"forskuddstrekk som er utbetalt skattyter før skatteoppgjøret er produsert. Forskuddsutbetalt beløp reduserer forskuddstrekket i skatteoppgjøret","$ref":"#/components/schemas/BeloepSomHeltall"},"avregnetForskuddsskatt":{"description":"forskuddsskatt som er tatt med i skatteoppgjøret (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e1f9-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/BeloepSomHeltall"},"betaltTilleggsforskudd":{"description":"innbetaling av forventet skyldig skatt. Frist for innbetaling av tilleggsforskudd er 31. mai i skattefastsettingsåret (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/27c11490-571e-11e7-a43d-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/BeloepSomHeltall"},"forskudd":{"description":"","$ref":"#/components/schemas/BeloepSomHeltall"},"overskytende":{"description":"beløp som viser at innbetalt forskudd er høyere enn beregnet skatt. Beløpet er uten rentegodtgjørelse","$ref":"#/components/schemas/BeloepSomHeltall"},"rentetillegg":{"description":"rentetillegg etter sktbl § 11-5. Renten beregnes av restskatt","$ref":"#/components/schemas/BeloepSomHeltall"},"rentegodtgjoerelse":{"description":"rentegodtgjørelse etter sktbl § 11-5. Renten beregnes av overskytende","$ref":"#/components/schemas/BeloepSomHeltall"},"beregnedeDebetAvsavnsrenter":{"description":"rentetillegg etter sktbl § 11-2. Renten beregnes av økt skatt ved endring av skatteoppgjør","$ref":"#/components/schemas/BeloepSomHeltall"},"beregnedeKreditAvsavnsrenter":{"description":"rentegodtgjørelse etter sktbl § 11-4. Renten beregnes av økt overskytende/tilbakebetaling av tidligere innbetalt restskatt ved endring av skatteoppgjør","$ref":"#/components/schemas/BeloepSomHeltall"},"forskuddPaaRestskatt":{"description":"innbetaling av tilleggsforskudd etter frist 31.05 i skattefastsettingsåret blir benyttet til å dekke restskatt i skatteoppgjøret","$ref":"#/components/schemas/BeloepSomHeltall"},"ubetaltForskuddsskatt":{"description":"andel av forskuddsskatt som ikke er betalt","$ref":"#/components/schemas/BeloepSomHeltall"},"utbetaltTidligere":{"description":"beløp som er utbetalt/motregnet etter tidligere skatteoppgjør","$ref":"#/components/schemas/BeloepSomHeltall"},"innbetaltTidligere":{"description":"beløp som er innbetalt etter tidligere skatteoppgjør","$ref":"#/components/schemas/BeloepSomHeltall"},"aaBetale":{"description":"beløp skattepliktig skal betale","$ref":"#/components/schemas/BeloepSomHeltall"},"aaBetaleFrafaltUnderOrdinaerBeloepsgrense":{"description":"beløp <kr 100 som skattepliktig ikke skal betale","$ref":"#/components/schemas/BeloepSomHeltall"},"aaBetaleFrafaltUnderBeloepsgrenseForSjoemenn":{"description":"beløp <kr 2000 som skattepliktig ikke skal betale. Gjelder sjøfolk (særskilt skatteplikt)","$ref":"#/components/schemas/BeloepSomHeltall"},"tilgodeBlirIkkeUtbetaltUnderOrdinaerBeloepsgrense":{"description":"beløp <kr 100 som skattepliktig ikke får utbetalt","$ref":"#/components/schemas/BeloepSomHeltall"},"tilgodeBlirIkkeUtbetaltUnderBeloepsgrenseForSjoemenn":{"description":"beløp <kr 2000 som skattepliktig ikke får utbetalt. Gjelder sjøfolk (særskilt skatteplikt)","$ref":"#/components/schemas/BeloepSomHeltall"},"enoekFradrag":{"description":"ikke i bruk fra og med inntektsåret 2022","$ref":"#/components/schemas/BeloepSomHeltall"},"restskattFrafaltUnderOrdinaerBeloepsgrense":{"description":"beløp <kr 100 som skattepliktig ikke skal betale. Feltet brukes når skattepliktig også har ubetalt forskuddsskatt","$ref":"#/components/schemas/BeloepSomHeltall"},"refusjonAvKildeskattPaaLoenn":{"description":"gjelder skattepliktig med skatteplikt kildeskatt på lønn. Arbeidsgiver har trukket mer skatt enn skattyter skal betale. Skattepliktig kan søke om å få beløpet tilbakebetalt","$ref":"#/components/schemas/BeloepSomHeltall"},"fastsattKildeskattPaaLoenn":{"description":"gjelder skattepliktig med skatteplikt kildeskatt på lønn. Arbeidsgiver har ikke trukket skatt av utbetalt lønn. Skattepliktig skal selv betale inn fastsatt kildeskatt","$ref":"#/components/schemas/BeloepSomHeltall"}}},"Foedselsnummer":{"type":"string","description":"ellevesifret identifikasjonsnummer for personer bosatt i Norge, der de seks første sifrene angir fødselsdato og de fem siste personnummer. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/5138da10-be20-11e6-8004-005056825ca0'>Begrepsreferanse</a>)","minLength":11,"pattern":"[0-9]+","maxLength":11},"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"},"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>)"},"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"},"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"},"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"},"Kommunenummer":{"type":"string","description":"nummer for kommune (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e0f3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":4,"pattern":"([0-9]){4}","maxLength":4}}},"paths":{"/{rettighetspakke}/{inntektsaar}/{personidentifikator}":{"get":{"summary":"Hent avregning for person","description":"Hent avregning for person for et angitt inntektsår. Forespørselen må inneholde tildelt rettighetspakke.","operationId":"hentAvregningForPerson","tags":["Avregning"],"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":"inntektsaar","in":"path","description":"Inntektsåret det skal hentes opplysninger fra.","required":true,"schema":{"type":"string"},"example":2020},{"name":"personidentifikator","in":"path","description":"Fødsels- eller Dnummer","required":true,"schema":{"type":"string"},"example":12345678901},{"name":"gjelderPaaTidspunkt","in":"query","description":"Tidspunkt for hvilken gjeldende avregning som skal returneres.","required":false,"schema":{"type":"string"},"example":"2020-10-21T11:11:11"},{"name":"ajourholdtDato","in":"query","description":"Valgfri parameter på format YYYY-MM-DD. Dersom denne benyttes returneres siste ajourholdte opplysninger for gitt dato.","required":false,"schema":{"type":"string"},"example":"2023-03-21"},{"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/Avregning"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Avregning"}}}},"default":{"description":"Diverse feilmeldinger, se dokumentasjon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}