{"openapi":"3.0.3","info":{"description":"Tjenesten leverer informasjon om arbeidsgivers (opplysningspliktiges) innrapporterte opplysninger for en underenhet for en gitt periode.","version":"1.1.1","title":"Underenhet fra a-ordningen 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/underenhetaordningen"},"servers":[{"url":"https://underenhetaordningen.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://underenhetaordningen.api.skatteetaten.no/v1","description":"Produksjon"}],"components":{"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"UFA-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"}}},"Underenhet":{"type":"object","description":"Tjenesten leverer informasjon om arbeidsgivers (opplysningspliktiges) innrapporterte opplysninger for en underenhet for en gitt periode (<a href='https://data.skatteetaten.no/begrep/c72a9c60-82ed-11ea-a7e9-0050568351d2'>Begrepsreferanse</a>)","properties":{"norskIdentifikator":{"description":"","$ref":"#/components/schemas/NorskIdentifikator"},"periodeOgOpplysningspliktig":{"type":"array","description":"","items":{"$ref":"#/components/schemas/PeriodeOgOpplysningspliktigInformasjon"}}},"required":["norskIdentifikator","periodeOgOpplysningspliktig"]},"Arbeidsgiveravgift":{"type":"object","description":"(<a href='http://begrepskatalog/begrep/6b41c685-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","properties":{"loennOgGodtgjoerelse":{"type":"array","description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/","items":{"$ref":"#/components/schemas/Arbeidsgiveravgiftsgrunnlag"}},"tilskuddOgPremieTilPensjon":{"type":"array","description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/ (<a href='http://www.skatteetaten.no/EDAG/begrep/133'>Begrepsreferanse</a>)","items":{"$ref":"#/components/schemas/Arbeidsgiveravgiftsgrunnlag"}},"utenlandskeMedSaerskiltProsentsats":{"description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/ (<a href='https://data.skatteetaten.no/begrep/20b0ced0-2419-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/UtenlandskeMedSaerskiltProsentsats"},"utenlandskeMedFastAvgiftsbeloep":{"description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/","$ref":"#/components/schemas/UtenlandskeMedFastAvgiftsbeloep"},"fradragIGrunnlagetForSone":{"type":"array","description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/","items":{"$ref":"#/components/schemas/FradragIGrunnlaget"}},"fradragIGrunnlagetForUtenlandsk":{"description":"Rettledning om arbeidsgiveravgift i a-meldingen: https://www.skatteetaten.no/bedrift-og-organisasjon/arbeidsgiver/a-meldingen/veiledning/arbeidsgiveravgift-og-finansskatt/arbeidsgiveravgift-i-a-meldingen/ (<a href='https://data.skatteetaten.no/begrep/db7517d0-2405-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","$ref":"#/components/schemas/FradragIGrunnlagetForUtenlandsk"},"samletGrunnlagUnderOpplysningsplikt":{"description":"","$ref":"#/components/schemas/BeloepSomHeltall"}}},"Inntektsmottaker":{"type":"object","description":"(<a href='http://begrepskatalog/begrep/dcfb474b-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)","properties":{"norskIdentifikator":{"description":"","$ref":"#/components/schemas/NorskIdentifikator"}}},"PeriodeOgOpplysningspliktigInformasjon":{"type":"object","description":"","properties":{"kalendermaaned":{"description":"","$ref":"#/components/schemas/AarOgMaaned"},"opplysningspliktig":{"description":"","$ref":"#/components/schemas/NorskIdentifikator"},"arbeidsgiveravgift":{"description":"","$ref":"#/components/schemas/Arbeidsgiveravgift"},"inntektsmottaker":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Inntektsmottaker"}},"ajourholdstidspunkt":{"description":"","$ref":"#/components/schemas/DatoKlokkeslett"},"avvik":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Avvik"}}}},"Arbeidsgiveravgiftsgrunnlag":{"type":"object","description":"Skatteetaten.no om arbeidsgiveravgift: Lønn og annen godtgjørelseI tillegg til ordinær lønn, herunder feriepenger, omfatter avgiftsplikten blant annet:HonorarerTantieme (godtgjørelse/bonus)ProvisjonVentelønn som utbetales i forbindelse med nedbemanning mv.Dagpenger under arbeidsledighet som forskutteres av arbeidsgiverSykepengerForeldrepengerI tillegg omfattes følgende ytelser hvor avgiftsplikten ikke er knyttet til innberetningsplikten: Se ytelser hvor avgiftsplikten ikke er knyttet til innberetningsplikten:Tilskudd til tjenestepensjonsordningerPensjon fra tidligere arbeidsgiverTrekkpliktige utgiftsgodtgjørelserTrekkpliktige utgiftsrefusjonerTrekkpliktige naturalytelserTrekkpliktige drikkepenger (<a href='http://begrepskatalog/begrep/dcfb46f8-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)","properties":{"beregningskodeForArbeidsgiveravgift":{"description":"","$ref":"#/components/schemas/BeregningskodeForArbeidsgiveravgift"},"sone":{"description":"","$ref":"#/components/schemas/Arbeidsgiveravgiftsone"},"avgiftsgrunnlagBeloep":{"description":"","$ref":"#/components/schemas/Beloep"},"prosentsatsForAvgiftsberegning":{"description":"","$ref":"#/components/schemas/Grunnlagsprosent"}}},"Avvik":{"type":"object","description":"(<a href='http://begrepskatalog/begrep/dcfb4706-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)","properties":{"id":{"description":"","$ref":"#/components/schemas/Tekst"},"navn":{"description":"","$ref":"#/components/schemas/Tekst"},"alvorlighetsgrad":{"description":"","$ref":"#/components/schemas/Alvorlighetsgrad"}}},"FradragIGrunnlaget":{"type":"object","description":"(<a href='http://begrepskatalog/begrep/d3711750-2405-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","properties":{"beregningskodeForArbeidsgiveravgift":{"description":"","$ref":"#/components/schemas/BeregningskodeForArbeidsgiveravgift"},"sone":{"description":"","$ref":"#/components/schemas/Arbeidsgiveravgiftsone"},"avgiftsfradragBeloep":{"description":"","$ref":"#/components/schemas/Beloep"},"prosentsatsForAvgiftsberegning":{"description":"","$ref":"#/components/schemas/Grunnlagsprosent"}}},"FradragIGrunnlagetForUtenlandsk":{"type":"object","description":"(<a href='https://data.skatteetaten.no/begrep/db7517d0-2405-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","properties":{"avgiftsfradragBeloep":{"description":"","$ref":"#/components/schemas/Beloep"},"prosentsatsForAvgiftsberegning":{"description":"","$ref":"#/components/schemas/GrunnlagsprosentForUtenlandske"}}},"Grunnlagsprosent":{"type":"number","description":"","format":"double"},"GrunnlagsprosentForUtenlandske":{"type":"number","description":"","format":"double"},"UtenlandskeMedFastAvgiftsbeloep":{"type":"object","description":"(<a href='http://begrepskatalog/begrep/1985a220-2419-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","properties":{"antallAvgiftsgrunnlagPersoner":{"description":"","$ref":"#/components/schemas/Heltall"},"beloepssatsForAvgiftsberegning":{"description":"(<a href='http://www.skatteetaten.no/EDAG/begrep/30'>Begrepsreferanse</a>)","$ref":"#/components/schemas/GrunnlagsprosentForUtenlandske"}}},"UtenlandskeMedSaerskiltProsentsats":{"type":"object","description":"(<a href='https://data.skatteetaten.no/begrep/20b0ced0-2419-11e7-8e60-0050568351d2'>Begrepsreferanse</a>)","properties":{"avgiftsgrunnlagBeloep":{"description":"","$ref":"#/components/schemas/Beloep"},"prosentsatsForAvgiftsberegning":{"description":"","$ref":"#/components/schemas/GrunnlagsprosentForUtenlandske"}}},"Alvorlighetsgrad":{"type":"string","description":"(<a href='http://begrepskatalog/begrep/dcfb46e2-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)"},"Arbeidsgiveravgiftsone":{"type":"string","description":"(<a href='http://begrepskatalog/begrep/dcfb46f9-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)"},"BeregningskodeForArbeidsgiveravgift":{"type":"string","description":"(<a href='http://begrepskatalog/begrep/dcfb470d-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)"},"NorskIdentifikator":{"type":"string","description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/dcfb4778-e484-11e6-9cb3-005056821322'>Begrepsreferanse</a>)"},"Heltall":{"type":"integer","description":"hele tall, dvs. hele tall i mengden {..., -2, -1, 0, 1, 2, ...} (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52af0-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"int64"},"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"},"AarOgMaaned":{"type":"string","description":"årstall og måned angitt i nummer (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e149-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","pattern":"^(19|20)\\d\\d-(0[1-9]|1[012])$"},"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"},"Beloep":{"type":"number","description":"","format":"double"},"Tekst":{"type":"string","description":""}}},"paths":{"/{rettighetspakke}/{norskidentifikator}/underenhet":{"get":{"summary":"Hent underenhet fra a-ordningen for en virksomhet","description":"Hent underenhet fra a-ordningen for en virksomhet.","operationId":"hentUnderenhetAordningen","tags":["UnderenhetAordningen"],"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":"norskidentifikator","in":"path","description":"norskidentifikator","required":true,"schema":{"type":"string"},"example":"123456789"},{"name":"fraOgMed","in":"query","description":"Fra og med periode på format YYYY-MM.","required":true,"schema":{"type":"string"},"example":"2022-01"},{"name":"tilOgMed","in":"query","description":"Til og med periode på format YYYY-MM. Dersom tilOgMed ikke er satt brukes inneværende år og måned som parameter.","required":false,"schema":{"type":"string"},"example":"2023-01"},{"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/Underenhet"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}