Innsending av omsorgsansvar

Velg operasjon

Hver operasjon har sitt eget endepunkt. Se OpenAPI-kontrakten for request- og responsskjemaer, feltnavn og datatyper.

Operasjon i Fiks-API-et Brukes når Betydningen av gyldighetsdato
POST /api/v1/omsorgsansvar/endre Ny relasjon mellom barn og fosterforelder registreres Dato omsorgsansvaret gjelder fra
POST /api/v1/omsorgsansvar/korrigere Fra-datoen for en eksisterende relasjon må rettes Korrigert gyldig-fra-dato
POST /api/v1/omsorgsansvar/opphoere Relasjonen avsluttes, eller til-datoen på den nyeste relasjonen rettes Dato omsorgsansvaret opphører
POST /api/v1/omsorgsansvar/annullere En registrering aldri skulle vært gyldig Påkrevd i forespørselen, men uten praktisk betydning
POST /api/v1/omsorgsansvar/overfoere Ansvarlig barnevernstjeneste endres Dato overføringen gjelder fra

korrigere kan ikke rette barn, fosterforelder, ansvarlig barnevernstjeneste eller til-dato. Ved feil person eller ansvarlig tjeneste: annuller registreringen og send eventuelt ny endre. opphoere kan også rette til-datoen på en relasjon som allerede er historisk. Ved overfoere skal dagens ansvarlige tjeneste være innsender, og den nye tjenesten oppgis som ansvarlig; send én melding per gjeldende relasjon.

For endre, korrigere, opphoere og overfoere skal datoen ikke ligge i fremtiden. Opphør og overføring skal tidligst meldes den dagen endringen gjelder fra. Se brukseksempler for situasjoner med flere meldinger.

Forespørselen til Fiks-API-et

Alle felter i forespørselen er påkrevd: meldingsidentifikator, saksreferanse, kildesystem, gyldighetsdato, innsendende barnevernstjeneste, fosterbarn, fosterforelder og ansvarlig barnevernstjeneste.

  • avsendersMeldingsidentifikator skal være en unik UUID for hver ny innsending og brukes som idempotensnøkkel.
  • avsendersSaksreferanse er din egen saksreferanse; samme verdi returneres i tilbakemeldingen.
  • kildesystem er navnet på fagsystemet. gyldighetsdato oppgis som dato i formatet YYYY-MM-DD.
  • foedselsEllerDNummer for barnet og fosterforelderen har 11 siffer. Organisasjonsnummeret til barnevernstjenesten har 9 siffer.

Kvittering, retry og feil

202 Accepted med status: MOTTATT bekrefter bare at Fiks har tatt imot meldingen. saksnummer er normalt først kjent når Folkeregisteret har behandlet meldingen. Sjekk alltid tilbakemeldingene, også etter vellykket innsending: meldingen kan bli avvist senere.

Ved timeout uten kvittering kan samme melding sendes på nytt med samme avsendersMeldingsidentifikator. Ikke lag en ny identifikator for et mulig allerede sendt forsøk; det kan opprette en duplikatsak. Gjenbruk av identifikatoren gir ikke 409 Conflict. Nye meldinger, også om samme sak, skal ha hver sin identifikator.

Ugyldig forespørsel gir 400, manglende eller ugyldig autentisering 401 og manglende tilgang 403.