Ny fødselsmelding – oversikt
Ny fødselsmelding (BirthSystem) skal erstatte dagens fødselsmelding. Jordmødre og forløsende leger registrerer fødsler i systemet via et REST-API, og systemet videreformidler meldingene til Folkeregisteret (Skatteetaten) for tildeling av fødselsnummer.
Important
Det nye systemet er separat fra det eksisterende. Systemene kjøres samtidig i en periode mens konsumenter migrerer fra det gamle systemet til det nye. Meldinger sendt i det gamle systemet eksisterer ikke i det nye, og omvendt. Du må vite hvilket system du sender meldingene til.
Kanal
Det nye systemet har én kanal: et REST-API (JSON) med autentisering via HelseID. I motsetning til det gamle systemet er det ingen bruk av NHN Tjenestebuss, ingen AppRec og ingen publisering av Person-objekter på topic. Fagsystemet henter (poller) status på fødselsmeldingen fra APIet for å få barnets fødselsnummer.
Overordnet flyt
sequenceDiagram
participant EPJ as Fagsystem (EPJ)
participant API as Ny fødselsmelding (REST-API)
participant FREG as Folkeregisteret (Skatteetaten)
Note over EPJ, API: Registrering (synkront)
EPJ->>+API: POST /v1/birth (HelseID)
API-->>-EPJ: 200 OK med messageId
Note over API, FREG: Videresending (asynkront)
API->>FREG: Registrer fødsel (foedsel_v1)
FREG-->>API: Beslutning + fødselsnummer (via feed)
Note over EPJ, API: Oppslag av fødselsnummer (polling)
EPJ->>API: GET /v1/birth/{messageId}
API-->>EPJ: Status + barnets fødselsnummer (når godkjent)
- Registrering – Fagsystemet POSTer fødselen. APIet validerer og lagrer meldingen, og returnerer umiddelbart en
messageId. Identiteten til jordmor eller lege (navn, HPR-nummer og organisasjon) hentes fra HelseID-tokenet og inngår ikke i forespørselen. - Videresending til Folkeregisteret – Bakgrunnstjenester sender lagrede meldinger til Folkeregisteret og leser svarene tilbake.
- Status – Fagsystemet poller status på meldingen. Når Folkeregisteret har godkjent meldingen, er barnets fødselsnummer tilgjengelig via status-endepunktet.
Status på en fødselsmelding
stateDiagram-v2
[*] --> Mottatt
Mottatt --> SendtTilSkatteetaten: sendt til Folkeregisteret
SendtTilSkatteetaten --> Godkjent: godkjent + fødselsnummer
SendtTilSkatteetaten --> Avslått
SendtTilSkatteetaten --> Avvist
SendtTilSkatteetaten --> Avbrutt
SendtTilSkatteetaten --> ManuellBehandling
Statusverdiene (slik de returneres i JSON) og status-endepunktene er dokumentert i Status.
Viktige forskjeller fra det gamle systemet
| Gammelt system | Nytt system | |
|---|---|---|
| Kanal | NHN Tjenestebuss (XML) og webportal | REST-API (JSON) med HelseID |
| Kvittering | AppRec (applikasjonskvittering) på Tjenestebussen | HTTP-svar (statuskode og feilmelding) |
| Fødselsnummer | Person-objekt publisert på topic-kø |
Polling av status-endepunkt |
| Identifikasjon av barn | H-nummer (11 siffer, innkodet i referansen) | Fritekst-identifikator (hospitalChildIdentificationNumber, maks 200 tegn), unik pr. organisasjon |
| Jordmor/lege | Sendes i meldingen (Signaturinfo) |
Hentes fra HelseID-tokenet |
| Institusjon | Institusjonsnummer (OrgReg) + adresse | Institusjonsnavn + kommunenummer |
| Korrigering | referanseTidligereMelding |
isCorrectedRequest + originalMessageId |
| Foreldre med fødselsnummer | Personalia (navn, fødselsdato, fødselsnummer) sendes i meldingen | Kun fødselsnummeret sendes – navn og fødselsdato slås opp i Persontjenesten |
| Barnets fødselsdato | Ingen nedre grense (datoen i H-nummeret kan ikke ligge i fremtiden) | Må være innenfor det siste året |
Endepunkter
| Endepunkt | Metode | Formål |
|---|---|---|
/v1/birth |
POST | Registrer en fødsel |
/v1/birth/{messageId} |
GET | Hente status på en melding ved meldings-ID |
/v1/birth/get-by-hospital-child-identification-number |
POST | Hente status på meldinger ved sykehusets identifikasjonsnummer |