Grensesnitt for overføring av krav/transaksjoner mellom bidragsområdet og Elin/Navi.
Operasjonen administrerer vedlikeholdsmodus i tjenesten. Når vedlikeholdsmodus er aktivert vil tjenesten avvise alle ny krav.
{
"aktiv": true,
"aarsakKode": "PAALOP_GENERERES",
"kommentar": "Påløp for 2022-12 genereres hos NAV."
}
Dersom klienten ikke er autentisert.
{
"feilkode": "TOKEN_MANGLER",
"feilmelding": "Fant ingen token i requesten."
}
Oppdateringen av vedlikeholdsmodus er OK.
{
"batchUid": "bd27abf5-0632-414d-af4e-47bdecff2c2a"
}
Dersom klienten ikke er autentisert.
{
"feilkode": "TOKEN_MANGLER",
"feilmelding": "Fant ingen token i requesten."
}
Dersom klienten ikke har tilgang. For eksempel at klienten ikke har lov til å skru av vedlikeholdsmodus eller tilgang til den bestemte årsakskoden.
{
"feilkode": "INGEN_TILGANG",
"feilmelding": "Ingen tilgang til å deaktivere vedlikeholdsmodus."
}
Ukjent feil.
{
"feilkode": "UKJENT_FEIL",
"feilmelding": "Intern feil"
}
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.
{
"krav": [
{
"konteringer": [
{
"transaksjonskode": "B1",
"type": "NY",
"soknadType": "EN",
"gjelderIdent": "15878598161",
"kravhaverIdent": "14871298182",
"mottakerIdent": "15878598161",
"skyldnerIdent": "28848596401",
"belop": 2000,
"valuta": "NOK",
"periode": "2022-02-01",
"vedtaksdato": "2022-03-18",
"saksbehandlerId": "a123456",
"attestantId": "a123456",
"tekst": "VII W → 550 → 50 /11",
"fagsystemId": "2201234",
"delytelsesId": "123456789"
},
{
"transaksjonskode": "B1",
"type": "NY",
"soknadType": "EN",
"gjelderIdent": "15878598161",
"kravhaverIdent": "14871298182",
"mottakerIdent": "15878598161",
"skyldnerIdent": "28848596401",
"belop": 2000,
"valuta": "NOK",
"periode": "2022-03-01",
"vedtaksdato": "2022-03-18",
"saksbehandlerId": "a123456",
"attestantId": "a123456",
"tekst": "VII W → 550 → 50 /11",
"fagsystemId": "2201234",
"delytelsesId": "123456789"
},
{
"transaksjonskode": "B1",
"type": "NY",
"soknadType": "EN",
"gjelderIdent": "15878598161",
"kravhaverIdent": "14871298182",
"mottakerIdent": "15878598161",
"skyldnerIdent": "28848596401",
"belop": 2000,
"valuta": "NOK",
"periode": "2022-04-01",
"vedtaksdato": "2022-03-18",
"saksbehandlerId": "a123456",
"attestantId": "a123456",
"tekst": "VII W → 550 → 50 /11",
"fagsystemId": "2201234",
"delytelsesId": "123456789"
},
{
"transaksjonskode": "G1",
"type": "NY",
"soknadType": "FABM",
"gjelderIdent": "15878598161",
"kravhaverIdent": "80000345435",
"mottakerIdent": "80000345435",
"skyldnerIdent": "15878598161",
"belop": 1223,
"valuta": "NOK",
"periode": "2022-03-01",
"vedtaksdato": "2022-03-18",
"saksbehandlerId": "a123456",
"attestantId": "a123456",
"fagsystemId": "2201234",
"delytelsesId": "123456790"
},
{
"transaksjonskode": "G1",
"type": "NY",
"soknadType": "FABP",
"gjelderIdent": "15878598161",
"kravhaverIdent": "80000345435",
"mottakerIdent": "80000345435",
"skyldnerIdent": "28848596401",
"belop": 1223,
"valuta": "NOK",
"periode": "2022-03-01",
"vedtaksdato": "2022-03-18",
"saksbehandlerId": "a123456",
"attestantId": "a123456",
"fagsystemId": "2201234",
"delytelsesId": "123456791"
}
]
}
]
}
Forespørsel er ugyldig.
{
"feilkode": "UGYLDIG_JSON",
"feilmelding": "Did not expect ' on line 35, column 3"
}
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.
{
"batchUid": "bd27abf5-0632-414d-af4e-47bdecff2c2a"
}
Dersom klienten ikke er autentisert.
{
"feilkode": "TOKEN_MANGLER",
"feilmelding": "Fant ingen token i requesten."
}
Dersom klienten ikke har tilgang.
{
"feilkode": "INGEN_TILGANG",
"feilmelding": "Ingen tilgang med vedlagte token"
}
Ukjent feil.
{
"feilkode": "UKJENT_FEIL",
"feilmelding": "Intern feil"
}
Service unavailable - Påløpsmodus er på.
{
"feilkode": "VEDLIKEHOLD_MODUS",
"feilmelding": "Tjenesten er utilgjengelig under vedlikehold"
}
Returnerer behandlingsstatus og mulige feilmeldinger
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.
Tjenesten er OK.
Dersom klienten ikke er autentisert.
{
"feilkode": "TOKEN_MANGLER",
"feilmelding": "Fant ingen token i requesten."
}
Dersom klienten ikke har tilgang.
{
"feilkode": "INGEN_TILGANG",
"feilmelding": "Ingen tilgang med vedlagte token"
}
Ukjent feil. Tjenesten er ikke OK.
{
"feilkode": "UKJENT_FEIL",
"feilmelding": "Intern feil"
}
Service unavailable - Påløpsmodus er på.
{
"feilkode": "VEDLIKEHOLD_MODUS",
"feilmelding": "Tjenesten er utilgjengelig under vedlikehold"
}
Returnerer behandlingsstatus og mulige feilmeldinger
Forespørsel er ugyldig.
{
"feilkode": "UGYLDIG_BATCHUID",
"feilmelding": "Fant ikke batchUid 98969948-a74a-4e89-8162-0403b9cd4f64"
}
Behandlingsstatus for tidligere leverte konteringer.
Dersom klienten ikke er autentisert.
{
"feilkode": "TOKEN_MANGLER",
"feilmelding": "Fant ingen token i requesten."
}
Dersom klienten ikke har tilgang.
{
"feilkode": "INGEN_TILGANG",
"feilmelding": "Ingen tilgang med vedlagte token"
}
Ukjent feil.
{
"feilkode": "UKJENT_FEIL",
"feilmelding": "Intern feil"
}
Service unavailable - Påløpsmodus er på.
{
"feilkode": "VEDLIKEHOLD_MODUS",
"feilmelding": "Tjenesten er utilgjengelig under vedlikehold"
}