{"openapi":"3.0.3","info":{"description":"Tjenesten leverer informasjon om forfalte og ubetalte skatter og avgifter for en virksomhet","version":"2.3.0","title":"Restanser 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/restanser"},"servers":[{"url":"https://restanser.api.skatteetaten-test.no/v2","description":"Ekstern test"},{"url":"https://restanser.api.skatteetaten.no/v2","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:restanser"]}],"paths":{"/{rettighetspakke}/{organisasjonsnummer}":{"get":{"summary":"Hent restansene for enhet","description":"Hent restansene for enhet","operationId":"hentRestanseneForEnhet","tags":["Restanser"],"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"}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestanserDto"}},"application/xml":{"schema":{"$ref":"#/components/schemas/RestanserDto"}}}},"default":{"description":"Alle feil gis på dette formatet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}},"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":"RESTA-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","namespace":"urn:no:skatteetaten:datasamarbeid:feil:v1"}},"RestanserDto":{"type":"object","description":"","properties":{"restanser":{"description":"forfalte og ubetalte skatter og avgifter","$ref":"#/components/schemas/Restanser"},"levert":{"description":"Tidspunktet tjenesten leverer svar til konsumenten.","$ref":"#/components/schemas/DatoKlokkeslett"},"forespurteOrganisasjon":{"description":"Organisasjonsnummer tilhørende virksomheten det etterspørres opplysninger om.","$ref":"#/components/schemas/Organisasjonsnummer"}},"xml":{"namespace":"urn:no:skatteetaten:datasamarbeid:restanser:v2"}},"Restanser":{"type":"object","description":"","properties":{"arbeidsgiveravgift":{"description":"Angir virksomhetens forfalte og ubetalte arbeidsgiveravgift. (Begrepsreferanse)","$ref":"#/components/schemas/Restansebeloep"},"forskuddstrekk":{"description":"Angir virksomhetens forfalte og ubetalte forskuddstrekk. I Norge plikter alle arbeidsgivere å trekke skatt av lønn og ytelser ved utbetaling til ansatte. (Begrepsreferanse)","$ref":"#/components/schemas/Restansebeloep"},"forskuddsskatt":{"description":"Angir virksomhetens forfalte og ubetalte forskuddskatt. Skatten skal betales i løpet av det året virksomheten tjener pengene. Forskuddsskatten fastsettes på bakgrunn av forventet overskudd, samt annen lønns- eller pensjonsinntekt, i tillegg til næringsinntekten, kapitalinntekter, fradrag og formue. (Gjelder hovedsakelig for Enkeltpersonforetak). (Begrepsreferanse)","$ref":"#/components/schemas/Restansebeloep"},"restskatt":{"description":"Angir virksomhetens forfalte og ubetalte skatt.","$ref":"#/components/schemas/Restansebeloep"},"gebyr":{"description":"Angir virksomhetens ubetalte og forfalte Gebyr. Her inngår flere typer restanser: gebyr, tvangsmulkt, ansvarskravMva, sumForfaltRenterGebyrMVA, ansvarskravSkatt, finnansskattLønn og artistskatt. (Begrepsreferanse)","$ref":"#/components/schemas/Restansebeloep"},"merverdiavgift":{"description":"Angir virksomhetens forfalte og ubetalte merverdiavgift. (Begrepsreferanse)","$ref":"#/components/schemas/Restansebeloep"}}},"Restansebeloep":{"type":"object","description":"Summering av forfalt og ubetalt beløp, samt eventuelle renter.","properties":{"forfaltOgUbetalt":{"description":"Summering av forfalt og ubetalt beløp, samt eventuelle renter.","$ref":"#/components/schemas/BeloepSomHeltall"},"forfaltOgUbetaltRenter":{"description":"Renter tilhørende summering av forfalt og ubetalt beløp","$ref":"#/components/schemas/BeloepSomHeltall"},"forfaltOgUbetaltKrav":{"description":"Summering av forfalt og ubetalt beløp, uten eventuelle renter.","$ref":"#/components/schemas/BeloepSomHeltall"}}},"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). (Begrepsreferanse)","format":"date-time"},"Organisasjonsnummer":{"type":"string","description":"9 sifret nummer gitt de som er registrert i Enhetsregisteret. (Begrepsreferanse)","minLength":9,"pattern":"[0-9]+","maxLength":9},"BeloepSomHeltall":{"type":"integer","description":"en sum av penger i hele kroner brukt i en kontekst. Dette kan være en transaksjon, saldo o.l. (Begrepsreferanse)","format":"int64"}}}}