Publisert - 10.11.2026

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)
  1. 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.
  2. Videresending til Folkeregisteret – Bakgrunnstjenester sender lagrede meldinger til Folkeregisteret og leser svarene tilbake.
  3. 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

Dokumentasjon

Søk i Utviklerportalen

Søket er fullført!