Formål

Dette dokument er en vejledning til anvendelse af den Fødselsindberetningsservice (FIBS). På baggrund af denne guide er det muligt at lave en teknisk implementation af de brugerhistorier der er beskrevet i FIBS - Brugerhistorier.

Formålet med dette dokument er at vejlede udviklere, der skal udvikle eller vedligeholde systemer, som anvender FIBS snitflader.

Introduktion til FIBS

Fødselsindberetningsservicen (FIBS) bruges til at indberette information om fødsler med at viderestille til to eksterne services:

• CPR kontorets tildeling af personnummer ved fødsler: Bruges til at tildele et cpr nummer til en nyfødt
• Kirkeministeriets elektroniske Kirkebog: Tilføjelse af yderlige oplysninger om den nyfødte via Den elektroniske Kirkebog.

FIBS udstiller således disse to services på NSP med en ensartet sikkerhedshåndtering (DGWS).

Viderestilling sker på bases af forskellige xml elementer i requestet:

• Et NewbornRegistrationStructure element sendes videre til CPR kontorets tildeling af personnummer ved fødsler
• Et MidwifeRegistrationStructure element sendes videre til Kirkeministeriets elektroniske Kirkebog.

Kun en type xml element er tilladt i hver request - dvs. at tildeling af CPR nummer og tilføjelse af yderligere oplysninger til den elektroniske Kirkebog ikke kan ske i samme kald til FIBS men må ske i (minimum) to seperate kald til FIBS.

Da der er tale om viderestilling til eksterne services så kan f.eks. fejlkoder fra de bagvedliggende services blive returneret til anvendere af FIBS. For at få et overblik over disse henvises til dokumentation af de bagvedliggende services:

• CPR kontorets tildeling af personnumre: For at forstå de returnerede fejlkoder henvises til Håndbog for CPR Services med bilag - specifik tabellen i bilag 13 kan anvendes til oversættelse af fejl-nummer.
• Snitfladebeskrivelse af Kirkeministeriets elektroniske Kirkebog: Håndbog Til Personregistrering SOAP services, Ajourføringsservice - Servicespecifikation Jordemoderanmeldelse

Testpersoner der anbefales til kald af FIBS

Til at udvikle op i mod FIBS kan med fordel anvendes følgende personer (som forældre).

Disse er både lovlige i den bagvedliggende CPR service og er oprettet som officielle testpersoner på NSPs testmiljøer.

Understøttelse af Brugerhistorier

Med udgangspunkt i brugerhistorierne i FIBS - Brugerhistorier beskrives i det følgende, hvorledes de enkelte snitflader skal anvendes til at understøtte disse.

Alle brugerhistorier indeholder eksempler på succesfulde requests og responses.

Understøttelse af brugerhistorie: Tildeling af CPR nummer for nyfødt

I følende eksempel vises et kald til FIBS for at få tildelt et CPR nummer for en nyfødt.

<personregistrering:NewbornRegistrationStructure xmlns:personregistrering="http://rep.oio.dk/personregistrering.dk/xml/schemas/2007/01/02/" xmlns="http://rep.oio.dk/personregistrering.dk/xml/schemas/2007/01/02/" xmlns:cpr="http://rep.oio.dk/cpr.dk/xml/schemas/2007/01/02/" xmlns:dkcc="http://rep.oio.dk/ebxml/xml/schemas/dkcc/2007/01/02/" xmlns:itst="http://rep.oio.dk/itst.dk/xml/schemas/2006/01/17/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <personregistrering:NewbornStructure>
      <cpr:PersonCivilRegistrationIdentifier></cpr:PersonCivilRegistrationIdentifier>
      <cpr:BirthTime></cpr:BirthTime>
      <cpr:PersonBirthSequence></cpr:PersonBirthSequence>
      <dkcc:PersonGenderCode></dkcc:PersonGenderCode>
   </personregistrering:NewbornStructure>
</personregistrering:NewbornRegistrationStructure>

Bemærk følgende felter i requestet:

• PersonCivilRegistrationIdentifier Moderens CPR nummer

• Birthtime Fødselstidspunkt

• PersonBirthSequence Sekvensnummer i flerfoldsfødsel. 1 hvis det ikke er en flerfoldsfødsel

• PersonGenderCode Køn - M hvis der er en dreng og K, hvis der er en pige

Servicen returner et personnummer på den nyfødte

<NewbornReturnStructure>
   <PersonCivilRegistrationIdentifier>
   </PersonCivilRegistrationIdentifier>
</NewbornReturnStructure>

• PersonCivilRegistrationIdentifier Den nyfødtes CPR nummer