# info.description
Grensesnitt for overføring av krav/transaksjoner mellom bidragsområdet og Elin/Navi.

# paths./api/vedlikeholdsmodus.post.description
Operasjonen administrerer vedlikeholdsmodus i tjenesten. Når vedlikeholdsmodus er aktivert vil tjenesten avvise alle ny krav.

# paths./api/vedlikeholdsmodus.post.responses.200.description
Oppdateringen av vedlikeholdsmodus er OK.

# paths./api/vedlikeholdsmodus.post.responses.403.description
Dersom klienten ikke har tilgang. For eksempel at klienten ikke har lov til å skru av vedlikeholdsmodus eller tilgang til den bestemte årsakskoden.

# paths./api/vedlikeholdsmodus.post.responses.403.content.application/json.example.feilmelding
Ingen tilgang til å deaktivere vedlikeholdsmodus.

# paths./api/krav.post.description
Operasjon for å levere en batch med krav fra NAV til regnskapet hos Skatteetaten. En krav-batch består av en liste med krav. Et krav består av en liste med konteringer. Det forventes at disse konteringen behandles samlet. Det vil si at hvis én av konteringene feiler, skal ingen av konteringene i kravet benyttes.

Dersom et krav feiler kan det forsøkes overført på nytt gjentatte ganger inntil kravet er overført. Krav som gjelder samme fagsak må leveres i korrekt rekkefølge. Feiler et krav i en sak, skal ikke senere krav i samme sak overføres. Senere krav i andre saker kan overføres, selv om noen av partene fra den feilende fagsaken er involvert.

Det forventes at et krav alltid inneholder de samme konteringene. Dersom et nytt vedtak fører til et nytt krav som venter på et tidligere feilende krav, skal ikke konteringene fra det seneste kravet slås sammen med det ventende kravet.

NAV har ansvar for å manuelt følge opp krav som ved flere forsøk ikke kan overføres, og vil løse opp i problemet i samarbeid med Skatteetaten.

Ved månedlig påløp skal ikke dette grensesnittet benyttes. Tilsvarende krav legges i stedet inn i en fil som overføres til Skatteetaten gjennom filslusa. Formatet på påløpsfilen skal leveres på gammelt XML-format, men uten persondata, kun br10.

# paths./api/krav.post.requestBody.content.application/json.examples.Førstegangsfastsettelse bidrag.description
3 perioder med bidrag og gebyr til begge parter. DelytelsesId er satt til det samme for alle periodene av bidraget. For gebyrkonteringene angir gebyrRolle om gebyret gjelder bidragspliktig eller bidragsmottaker. Gebyrlinjene har forskjellig delytelsesId. Tekst-feltet er kun utfyllt for bidragskonteringene.

# paths./api/krav.post.requestBody.content.application/json.examples.Forskudd - førstegangsvedtak.description
Vedtak om forskudd fattes for første gang 18.03.2022. Vedtaket fattes etter påløp for april har gått, 04.03.2022, så perioden 2022-04 er inkludert i overføringen.

# paths./api/krav.post.requestBody.content.application/json.examples.Forskudd - endring.description
Det blir fattet nytt vedtak som reduserer forskuddet til ordinær sats fra 01.03.2022. Dermed korrigeres beløpet bort med A3 i periodene 2022-03 og 2022-04. Vedtaksdato blir satt til da endrinen ble utført, 27.03.2022, med delytelsesid hentes fra det første vedtaket. Beløpet for A3-konteringene er negative som betyr at de er fradrag.

# paths./api/krav.post.responses.202.description
Alle konteringene i kravet er oppdatert OK. Responsen har tom body.

Det forventes også responskode 200 dersom kravet (og dermed konteringene) er overført tidligere.
Det forventes da at kravet ignoreres slik at ikke konteringene posteres dobbelt.

# paths./api/krav.post.responses.503.description
Service unavailable - Påløpsmodus er på.

# paths./api/krav.post.responses.503.content.application/json.example.feilmelding
Tjenesten er utilgjengelig under vedlikehold

# paths./api/liveness.get.responses.400.description
Dersom én av konteringene ikke går gjennom validering forkastes alle konteringene i kravet og en liste over konteringer som har feilet returneres, sammen med informasjon om hva som er feil.

Det er ingen garanti for at konteringer som ikke kommer med på listen over feilede konteringer er feilfrie.

# paths./api/liveness.get.responses.503.description
Service unavailable - Påløpsmodus er på.

# paths./api/liveness.get.responses.503.content.application/json.example.feilmelding
Tjenesten er utilgjengelig under vedlikehold

# paths./api/krav/{batchUid}.get.responses.503.description
Service unavailable - Påløpsmodus er på.

# paths./api/krav/{batchUid}.get.responses.503.content.application/json.example.feilmelding
Tjenesten er utilgjengelig under vedlikehold

# components.schemas.KonteringId.properties.periode.description
Angir hvilken periode (måned og år) konteringen gjelder.

# components.schemas.KonteringId.properties.delytelsesId.description
Unik referanse til perioden i vedtaket. I bidragssaken kan en periode strekke over flere måneder, og samme referanse blir da benyttet for alle månedene. Samme referanse kan ikke benyttes to ganger for samme transaksjonskode i samme måned.

# components.schemas.Konteringsfeil.properties.feilkode.description
En kode som angir type feil som har oppstått. Feilkoden er ment å kunne brukes til å maskinelt sortere feil.

# components.schemas.Konteringsfeil.properties.feilmelding.description
En beskrivelse av feilen som har oppstått. Feilmeldingen er ment å være forståelig for et menneske ved manuell gjennomgang.

# components.schemas.KravResponse.properties.batchUid.description
Referanse til prosessering av konteringene.

# components.schemas.KravResponse.description
Svar med referane til videre behandling av konteringene.

# components.schemas.Feilsituasjon.properties.feilkode.description
En kode som beskriver feilsituasjonen. Koden skal være lik for like situasjoner.

# components.schemas.Feilsituasjon.properties.feilmelding.description
En tekst som beskriver denne konkrete feilsituasjonen. Beskrivelsen bør inneholde nok informasjon til at problemet kan løses.

# components.schemas.Vedlikeholdsmodus.properties.aktiv.description
Angir om vedlikeholdsmodus skal skrus på eller ikke

# components.schemas.Vedlikeholdsmodus.properties.aarsakKode.description
Forhåndsavklart kode som beskriver årsaken til vedlikeholdsmodus.

Eksempel på årsakskoder:
| Kode              | Brukes av             | Beskrivelse                                                                      |
|-------------------|-----------------------|----------------------------------------------------------------------------------|
| PAALOEP_GENERERES | Bidrag-regnskap (NAV) | Vedlikeholdsmodus startes før påløpsfilen genereres.                             |
| PAALOEP_LEVERT    | Bidrag-regnskap (NAV) | Vedlikeholdsmodus oppdateres når påløpsfilen er generert og levert til filslusa. |
| PAALOEP_BEHANDLET | Elin (SKE)            | Vedlikeholdsmodus opphører når Elin er ferdig med å behandle påløpsfilen.        |

# components.schemas.Vedlikeholdsmodus.properties.kommentar.description
Beskriver årsaken til at vedlikeholdsmodus aktiveres/deaktiveres. Feltet er ment for sporingsformål/logg.

# components.schemas.Kontering.properties.transaksjonskode.description
Type transaksjon.

Gyldige transaksjonskoder er:
| Kode  | Korreksjonskode | Beskrivelse                                |
|-------|-----------------|--------------------------------------------|
| A1    | A3              | Bidragsforskudd                            |
| B1    | B3              | Underholdsbidrag (m/u tilleggsbidrag)      |
| D1    | D3              | 18årsbidrag                                |
| E1    | E3              | Bidrag til særlige utgifter (særtilskudd)  |
| F1    | F3              | Ekrefellebidrag                            |
| G1    | G3              | Gebyr                                      |
| H1    | H3              | Tilbakekreving                             |
| I1    |                 | Motregning                                 |
| K1    |                 | Ettergivelse                               |
| K2    |                 | Direkte oppgjør (innbetalt beløp)          |
| K3    |                 | Tilbakekreving ettergivelse                |

# components.schemas.Kontering.properties.type.description
Konteringstypen er NY for nye konteringer for en stønad i en periode. Deretter skal alle konteringer for samme stønad i samme periode markere ENDRING, altså B3-konteringen og for alle påfølgende B1-konteringer.

# components.schemas.Kontering.properties.soknadType.description
Angirtypen behandling som har ført til konteringen.
| Kode | Beskrivelse |
|------|----------------------------------------------------------------------------|
| IN   | Sendes første måned i et indeksreguleringsvedtak. Etter dette benyttes EN. |
| FABM | Benyttes for gebyr som gjelder BM.                                         |
| FABP | Benyttes for gebyr som gjelder BP.                                         |
| EN   | Alle andre typer endringer. Også førstegangsvedtak.                        |
Legg merke til at dette er et svært begrenset utvalgt sammenliknet med hva som tidligere ble sendt fra Oppdrag.

# components.schemas.Kontering.properties.gjelderIdent.description
Personident (FNR/DNR) til bidragsmottaker i bidragssaken. I saker der bidragsmottaker ikke er satt benyttes et dummynr 22222222226

# components.schemas.Kontering.properties.kravhaverIdent.description
Personident (FNR/DNR) eller aktoernummer (TSS-ident/samhandler) til kravhaver.

Kravhaver angis ikke for gebyr.

# components.schemas.Kontering.properties.mottakerIdent.description
Personident (FNR/DNR) eller aktoernummer (TSS-ident/samhandler) til mottaker av kravet.

For gebyr settes mottakerIdent til NAVs aktoernummer 80000345435.

# components.schemas.Kontering.properties.skyldnerIdent.description
Personident (FNR/DNR) eller aktoernummer (TSS-ident/samhandler) til skyldner. For Bidrag er dette BP i saken.

For forskudd settes skyldnerIdent til NAVs aktoernummer 80000345435.

# components.schemas.Kontering.properties.belop.description
Konteringens beløp. Positive beløp og 0 regnes som tillegg, negative beløp som fradrag.

# components.schemas.Kontering.properties.periode.description
Angir hvilken periode (måned og år) konteringen gjelder.

# components.schemas.Kontering.properties.kjoredato.description
Datoen kravet/konteringen gjøres klart for overføring. For direkteoverførte online-vedtak blir datoen sannsynligvis det samme som vedtaksdato. For påløp blir datoen satt til dagen påløpet genereres.

# components.schemas.Kontering.properties.saksbehandlerId.description
NAVs brukerid for saksbehandler som har fattet vedtaket

# components.schemas.Kontering.properties.attestantId.description
NAVs brukerid for saksbehandler som har attestert vedtaket (sannsynligvis samme som saksbehandlerId over).

# components.schemas.Kontering.properties.tekst.description
Felt hvor utlandsavdelingen legger inn referansenummer (ffu-ref). Dette er et fritekstfelt som kan inneholde spesialtegn.

TODO: Bedre navn på feltet? Hva blir riktig regnskapsmessig?

# components.schemas.Kontering.properties.fagsystemId.description
Bidragssakens saksnummer angitt som String.

# components.schemas.Kontering.properties.delytelsesId.description
Unik referanse til perioden i vedtaket angitt som String. I bidragssaken kan en periode strekke over flere måneder, og samme referanse blir da benyttet for alle månedene. Samme referanse kan ikke benyttes to ganger for samme transaksjonskode i samme måned.

# components.schemas.Kontering.description
En kontering angir hvor mye som skal betales av skyldner til mottaker på vegne av kravhaver.

Konteringen kan unikt identifiseres med kombinasjonen transaksjonskode, delytelsesId og periode. Det forutsettes at delytelsesid'n er unik også på tvers av fagsystemid'er.

Personidenter for gjelderIdent, kravhaverIdent, mottakerIdent og skyldnerIdent angis med enten FNR eller DNR. (Håndtering av BNR og NPID er uavklart.) Aktoernummer kan benyttes i kravhaverIdent, mottakerIdent og skyldnerIdent. Aktoernummere er elleve siffer og starter med enten 8 eller 9. 

I testmiljøene må Tenor-identer støttes i stedet for FNR/DNR. Disse identene har 8 eller 9 i tredje siffer.

# components.schemas.Krav.description
Et krav består av en liste med konteringer. 