...

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 andre 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. Kun en type xml element er tilladt i hver request.

Kirkeministeriets elektroniske Kirkebog

Et MidwifeRegistrationStructure element sendes videre til Kirkeministeriets elektroniske Kirkebog.

Se snitfladebeskrivelse: Håndbog Til Personregistrering SOAP services, Ajourføringsservice - Servicespecifikation Jordemoderanmeldelse

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.

Fejl i autentificeringen (herunder whitelisting) rapporteres tilbage til brugeren som en SOAP Fault.

...

• 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:

<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>

• 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

Fejlkoder i forbindelse med: Tildeling af CPR nummer for nyfødt

I forbindelse med kald til FIBS, så foretager FIBS kald videre til CPR kontorets tildeling af personnummer fed fødsler service. Denne service kan give en række fejlkoder tilbage til FIBS. FIBS fortolker ikke selv på disse, men sender dem videre til FIBS anvenderen.

• 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 teste 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.

Snitfladebeskrivelser og endpoints

FIBS udstiller beskrivelse af udstillede services i WSDL fil (her findes konkrete endpoint).

http://<NSP miljø>/fibs/iti41

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

<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>

• 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