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).
Fejl i forhold til autentificering rapporteres tilbage til anvendere af FIBS vha SOAPFault:
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.
Der findes desuden følgende testdata i den service FIBS kontakter hos kirkeministeriet:
Eksempel 1 | |
---|---|
Filnavn | KMtest1.xml |
Ugift mor, hvor farens CPR kendes. 1 barn | |
Barn | |
CprNr | XXXXXX-XXXX |
Link til person | |
Klokkeslæt for fødsel | 14:20:00+01:00 |
Fødselssekvens | 1 |
Flerfødsels indikator | false |
Køn | male |
Fødested | Odense Universitetshospital |
Fritekst | Test af fødsel i Odense. Ugift mor, fars CPR kendes. |
Sognekode | 7545 |
Mor | |
CprNr | XXXXXX-XXXX |
Link til person | |
Far | |
CprNr | XXXXXX-XXXX |
Link til person |
Eksempel 2 | |
---|---|
Filnavn | KMtest2.xml |
Gift mor. 1 barn | |
Barn | |
CprNr | XXXXXX-XXXX |
Link til person | |
Klokkeslæt for fødsel | 03:02:00 |
Fødselssekvens | 1 |
Flerfødsels indikator | false |
Køn | female |
Fødested | Odense Universitetshospital |
Fritekst | Test af fødsel i Odense. Gift mor. 1 barn. |
Sognekode | 7545 |
Mor | |
CprNr | XXXXXX-XXXX |
Link til person | |
Far | |
CprNr |
Eksempel 3 | ||
---|---|---|
Filnavn | KMtest3.xml | KMtest4.xml |
Ugift mor, tvillinger, far uden CPR | ||
Barn | ||
CprNr | XXXXXX-XXXX | XXXXXX-XXXX |
Link til person | ||
Klokkeslæt for fødsel | 07:10:00 | 08:00:00 |
Fødselssekvens | 1 | 2 |
Flerfødsels indikator | true | true |
Køn | female | male |
Fødested | Odense Universitetshospital | Odense Universitetshospital |
Fritekst | Test af tvillingefødsel i Odense, Ugift mor, fars CPR ikke kendt | Test af tvillingefødsel i Odense, Ugift mor, fars CPR ikke kendt |
Sognekode | 7545 | 7545 |
Mor | ||
CprNr | XXXXXX-XXXX | |
Link til person | ||
Far | ||
CprNr | ||
Eller: | ||
Fødselsdato | 1967-08-13 | 1967-08-13 |
Navn | ||
- fornavn | Jens | Jens |
- mellemnavn | Otto | Otto |
- efternavn | Jensen | Jensen |
Adresse | ||
- Linie 1 | Bülowsvænget 32 | Bülowsvænget 32 |
- Linie 2 | 5700 Svendborg | 5700 Svendborg |
- Linie 3 | Danmark | Danmark |
- Linie 4 | ||
- Linie 5 | ||
- Linie 6 |
Eksempel 4 | ||
---|---|---|
Filnavn | KMtest5.xml | KMtest6.xml |
Gift mor, tvillinger | ||
Barn | ||
CprNr | XXXXXX-XXXX | XXXXXX-XXXX |
Link til person | ||
Klokkeslæt for fødsel | 11:11:11 | 14:14:00 |
Fødselssekvens | 1 | 2 |
Flerfødsels indikator | true | true |
Køn | male | male |
Fødested | Odense Universitetshospital | Odense Universitetshospital |
Fritekst | Test af tvillingefødsel, gift mor. | Test af tvillingefødsel, gift mor. |
Sognekode | 7545 | 7545 |
Mor | ||
CprNr | XXXXXX-XXXX | |
Link til person | ||
Far | ||
CprNr | ||
Eller: | ||
Fødselsdato | ||
Navn | ||
- fornavn | ||
- mellemnavn | ||
- efternavn | ||
Adresse | ||
- Linie 1 | ||
- Linie 2 | ||
- Linie 3 | ||
- Linie 4 | ||
- Linie 5 | ||
- Linie 6 |
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.
Bemærk følgende felter i requestet (se under body):
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:
Bemærk følgende felter i response (se under body):
- PersonCivilRegistrationIdentifier Den nyfødtes CPR nummer
Understøttelse af brugerhistorie: Registrering af oplysninger i den elektroniske kirkebog
I følende eksempel vises et kald til FIBS for at få registrert oplysninger om barnet i den elektroniske kirkebog.
Bemærk følgende felter i requestet (se under body):
ChildStructure/PersonCivilRegistrationIdentifier Barnets CPR nummer
ChildStructure/ParishCode: Sognekode
MotherCivilRegistrationIdentifier: Moderens CPR nummer
FatherStructure/PersonCivilRegistrationIdentifier: Faderens CPR nummer
Svar fra FIBS: