Upload
vuongthu
View
216
Download
0
Embed Size (px)
Citation preview
Integration SF1320_A - CPR - Hændelser
Integrationsbeskrivelse - version 2.0.0
Kommunernes Datafællesskab - KDF
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 33
Versionshistorik
Relevans Dato Initialer Version Kommentarer
2014-01-10 PBO 0.1 Første version kopieret fra gammel skabelon
2014-01-10 PBO 0.2 Opdateret til fase 1
2014-11-18 PBO 0.3 Opdateret til fase 2
2015-03-17 EHE 0.5 Klargjort til SP
2015-08-18 EDM 0.5.1 Forkert systemnavn i integrationsflow 4.1 rettet til CPR.
2015-09-01 EDM 2.0.0 Generelle ændringer omkring Beskedfordeler. Afsnit 1.5 Forud-
sætninger, afsnit 3.1.3 ModtageBesked, afsnit 3.3 Serviceplat-
formen som Beskedagent og 4.1.2 Beskrivelse af Beskedkuvert.
Interne referencer opdateret.
Referencer
Ref Titel Kommentarer
[SPref] Bilag 7B Ydelser og servicemål for Serviceplatformen
[BFref] [Afklaring/KDF – indsæt reference dokumentation af
servicemål for BF]
Endnu ikke udarbejdet
[SIKKERHED] Use cases for brug af sikkerhedsmodeller på Ser-
viceplatformen - v.0.4.3
[STS-Sikkerhed] Se vilkår Bilag 2 - Vilkår for anvendelse af sikker-
hedsmodellen i Rammearkitekturen version 2.0 på
nedenstående link https://share-komm.kom-
bit.dk/P024/Delte%20dokumenter/Forms/Integrati-
onsvilkr.aspx
[SFTP] https://www.serviceplatformen.dk/administra-
tion/help/provider-tech-guide
”USM0005 Vejledning til Serviceplatformens SFTP
Service.pdf”
Vejledning med xsd.
[VBF] Se vilkår Underbilag 2N - Vilkår for integration til støt-
tesystemet Beskedfordeler version 2.0 på nedenstå-
ende link
https://share-komm.kombit.dk/P024/Delte%20doku-
menter/Forms/Integrationsvilkr.aspx
[SF1460_A] Modtag besked Beskrivelse af protokol for Besked-
fordeler
[SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Besked-
fordeler
[SF1460_C] Aflever besked Beskrivelse af protokol for Besked-
fordeler
[SF1460_D] Modtag besked via pull Beskrivelse af protokol for Besked-
fordeler
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 33
[WSDL-SP] Integrationsbeskrivelsen refererer til SF1320_A Tek-
nisk Spec 20150901.zip som indeholder WSDL på
serviceplatformen, og er placeret i samme mappe
som integrationsbeskrivelsen, se link https://share-
komm.kombit.dk/p089/Integrationsbeskrivelser/
[WSDL-EXT] Integrationsbeskrivelsen refererer til SF1320_A Bilag
20150901.zip som indeholder WSDL/WADL/XSD af
eksterne interfaces, som er placeret i samme mappe
som integrationsbeskrivelsen, se link https://share-
komm.kombit.dk/p089/Integrationsbeskrivelser/
Indholdsfortegnelse
1 Overordnet beskrivelse ............................................................................................. 4
1.1 Integrationens formål ............................................................................................ 4
1.2 Overordnet forretningsflow i integrationen .................................................................... 4
1.3 Servicebetingelser for den samlede integration ........................................................... 10
1.4 Teststrategi ...................................................................................................... 12
1.5 Forudsætninger for produktionssætning .................................................................... 13
2 Kontekst for integrationsparter .................................................................................. 14
2.1 Kontekst for KY[!@IP_FS1@!] ............................................................................... 14
2.2 Kontekst for KSD [!@IP_FS1@!] ............................................................................ 14
2.3 Kontekst for SAPA [!@IP_FS1@!] ........................................................................... 15
2.4 Kontekst for CPR [!@IP_CPR1@!] .......................................................................... 15
3 Specifikation for integrationsparter ............................................................................. 17
3.1 Specifikation af endpoints for fagsystem KY, KSD, SAPA[!@KY@!][!@KSD@!] [!@SAPA@!] ... 17
3.2 Specifikation af endpoints for CPR .......................................................................... 20
3.3 Specifikation af endpoints for Serviceplatformen som afsendende beskedagent [!@Systematic@!]
23
4 Beskrivelse for integrationsplatforme ........................................................................... 25
4.1 Beskrivelse for Serviceplatformen [!@Systematic@!] .................................................... 25
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 33
1 Overordnet beskrivelse
1.1 Integrationens formål
Integrationen har til formål at tilvejebringe og videresende relevante personhændelser på CPR-om-
rådet for fagsystemer, der benyttes af offentlige myndigheder via det fælleskommunale støttesy-
stem Beskedfordeler (Beskedfordeler).
Dette vil gøre fagsystemer i stand til at kunne reagere på personhændelser ift. de myndighedssa-
ger og arbejdsgange i forbindelse med forvaltningsvirksomhed som fagsystemet it-understøtter.
Integrationen leverer kun hændelser fra CPR registret og således ikke personhændelser fra fx ud-
lændingeområdet.
1.2 Overordnet forretningsflow i integrationen
Det overordnede flow for integrationen er som følger.
Serviceplatformen henter personhændelser fra CPR-registeret dagligt. Herefter analyseres data for
at afgøre hvilke forretningsmæssige personhændelser, som har fundet sted. Til sidst afleveres
data til Beskedfordeler med en besked per hændelse.
Fagsystemer skal oprette et abonnement i Beskedfordeler med angivelse af filtre på kuvertens me-
tadata, herunder relevante personhændelser, personnumre eller adresser. Fagsystemets adgang
til typer af personhændelser fra Beskedfordeler skal opsættes i det fælleskommunale støttesystem
Adgangsstyring.
Fagsystemet vil således kun kunne modtage personhændelser fra Beskedfordeler på angivne be-
skedtyper og som er indeholdt i fagsystemets abonnement.
Integrationen er en gennemstillingsintegration med ”content based routing” og transformation, som
integrerer til Beskedfordeler.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 33
Nedenfor er illustreret flowet i integrationen:
Se
rvic
ep
latfo
rme
nF
ag
syst
em
(n)
CP
RBe
sked
ford
eler
Modtag personhændelse
Hent data
Dan
forretnings-
hændelser
Opdater
lokalt
repository
Send
Besked
Modtag
Besked
Distribuer
besked til
dueslag
Udstil
besked
Modtag
Besked
Dan udtræk
Periodisk
Udstil
Persondata
CPR genererer hver nat et udtræk til Serviceplatformen på alle recordtyper, der er ændret i CPR-
registeret siden sidste udtræk, og Serviceplatformen kan derfor modtage alle personhændelser for
alle personer i CPR.
Serviceplatformen henter udtrækket og udregner for hver personhændelse en eller flere forret-
ningshændelser, som beskriver hvilken ændring, der har fundet sted. Derefter opdateres det lokale
CPR-repository, og endelig sendes beskederne til Beskedfordeler.
Beskedfordeler modtager beskederne og udregner hvilke abonnementer, som skal modtage be-
skeden og distribuerer herefter beskeder til de korrekte dueslag. Fagsystemerne kan selv opsætte
og administrere deres dueslag.
Fagsystemet modtager beskeden og behandler den efter egne forretningsregler jf. snitflade
SF1460_A/SF1460_D. Denne snitflade omhandler kun Serviceplatformens modtagelse af person-
hændelser og afsendelse af forretningshændelser vedr. person (Part).
1.2.1 Ændringer til den eksisterende snitflade for CPR Abonnement
Serviceplatformen skal implementere flowet beskrevet i punkt 1.2 herunder:
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 33
Serviceplatformen skal benytte det eksisterende ændringsudtræk fra CPR.
Serviceplatformen skal udarbejde en komponent til at generere forretningshændelser for
personhændelser jf. punkt 1.2.2.
Serviceplatformen skal benytte den eksisterende funktionalitet til at opdatere det lokale re-
pository.
Serviceplatformen skal udarbejde en integration til Beskedfordeler, herunder skal Service-
platformen oprettes som et afsendersystem til Beskedfordeler i det fælleskommunale støt-
tesystem Adgangsstyring.
Systematic skal udarbejde et XSD over indholdet af Personbeskeder som afsendes. XSD
skal godkendes af KOMBIT.
1.2.2 Service Management
1.2.2.1 Incident Management
Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen.
1.2.2.2 Problem Management
Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen.
1.2.2.3 Change Management
Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen.
1.2.3 Liste over forretningshændelser
Ud fra de modtagne personhændelser genereres forretningshændelser i Serviceplatformen som
beskrevet i nedenstående tabel.
[Afklaring/KDF – afventer endelige definition af hvorledes de forretningsmæssige hændelser kan
generes ud fra hændelser fra CPR]
Tabellen har følgende kolonner:
Hændelse ID, Serviceplatformens brugervendte ID på hændelsen.
Hændelse Navn, Navnet på hændelsen.
De næste to kolonner beskriver reglen for hvilke ændringer i data, som medfører en bestemt
hændelse på baggrund af en ændring på et CPR nummer modtaget i et CPR ændringsudtræk.
Tidligere Data: Tilstanden af det lokale replika på Serviceplatformen inden opdatering fra
CPR ændringsudtrækket udføres.
Nuværende Data: Det opdaterede data tilhørende et CPR nummer, som modtages i et
CPR ændringsudtræk.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 33
Hæn-
delse ID
Hændelse navn Tidligere data Nuværende data
CPR-001 Ændring af registrering Ikke relevant Nye data modtaget
CPR-002 Fødsel Ingen registrering Ny registrering, indrejsedato er
tom.
CPR-003 Navngivning Ingen navnedata Navnedata tilføjet
CPR-004 Navneændring Andet navn Navnedata ændret
CPR-005 Dødsfald Status ikke 90 Status ændret til 90
CPR-006 Dødsfald - som for-
svundet
Status 70 Status ændret til 90
CPR-007 Dødsfald - som udvan-
dret
Status 80 Status ændret til 90
CPR-008 Dødsfald som nyfødt Ingen fødselsregistrering Status ændret til 90
CPR-009 Dødsfald – ægtefælle Ægtefælle status ikke 90 Ægtefælle status ændret til 90
CPR-010 Forsvinding Status ikke 70 Status ændret til 70
CPR-011 Genfinding Status 70 Status ændret fra 70
CPR-012 Indvandring Ingen registrering Ny registrering, samt en angi-
velse af indrejsedato samt ud-
landsadresse
CPR-013 Udvandring Status ikke 80 Status ændret til 80
CPR-014 Genindvandring Status 80 Status ændret fra 80
CPR-015 Nynummerering Ingen registrering Nyt CPR nummer
CPR-016 Omnummerering nyt
nummer
Ingen registrering på
gældende personnum-
mer
Hændelse angiver andet CPR-
nummer, Feltet ”Afledtmarke-
ring” angiver typen, Feltet
”pnrgaeld” angiver gældende
personnummer og vil være til-
svarende PNR.
CPR-017 Sletning af personnum-
mer
Status ikke 30 Status ændret til 30
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 33
CPR-018 Tidligere dobbelt num-
mer
Status ikke 50 Status ændret til 50
CPR-019 Udgår grundet omnum-
merering
Status ikke 60 Status ændret til 60
CPR-020 Myndiggørelse Alder <18 eller Umyn-
diggjort
Alder>18 eller Umyndighed
slut
CPR-021 Umyndiggørelse Ikke umyndiggjort Umyndiggørelse start dato
CPR-022 Folkekirketilknytning
ændret
Folkekirkeforhold ændret Folkekirkeforhold ændret
CPR-023 Statsborgerskab æn-
dret
Statsborger landekode
ændret
Statsborger landekode ændret
CPR-024 Faderskab – far Barn far oprettet eller
ændret
Barn far oprettet eller ændret
CPR-025 Fødsel – mor Barn mor oprettet eller
ændret
Barn mor oprettet eller ændret
CPR-026 Faderskab – barn Barn far oprettet eller
ændret
Barn far oprettet eller ændret
CPR-027 Adoption – barn Barn mor oprettet eller
ændret
Barn mor oprettet eller ændret
CPR-028 Vielse Civilstand ikke "G" Civilstand ændret til "G"
CPR-029 Separation startet Separation ikke oprettet Separation startdato
CPR-030 Separation ophørt Separation oprettet Separation slettet
CPR-031 Skilsmisse Civilstand ikke "F" Civilstand ændret til "F"
CPR-032 Ændring vedrørende
ægtefælle
Ikke relevant Nye data modtaget og civ. "G"
CPR-033 Ændring vedrørende
slægtskab
Ændring af mor eller far Ændring af mor eller far
CPR-034 Flytning til kommunen Anden kommune Kommune ændret
CPR-035 Flytning fra kommunen Aktuel kommune i lokalt
repository
Kommune ændret
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 33
CPR-036 Fraflytning inden for
kommunen
Kommune uændret + Ny
adresse
Kommune uændret + Ny
adresse
CPR-037 Tilflytning inden for
kommunen
Kommune uændret + Ny
adresse
Kommune uændret + Ny
adresse
CPR-038 Indkaldelse til militæret Suppl. adresse ikke ud-
fyldt
Suppl. adresse angivet
CPR-039 Hjemsendelse fra mili-
tæret
Suppl. adresse angivet Suppl. adresse slettet
CPR-040 Start afsoning Notatlinje 3&4 ikke ud-
fyldt
Notatlinje 3 eller 4 ændret
CPR-041 Slut afsoning Notatlinje 3 eller 4 udfyldt Notatlinje 3&4 slettet
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 33
1.3 Servicebetingelser for den samlede integration
1.3.1 Servicemål
For Serviceplatformen gælder på punkterne tidsrum, svartid, tilgængelighed og servicevindue de
generelle betingelser fra driftsaftale for Serviceplatformen. Se [SPref].
Parameter CPR Hændelser
Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage
bortset fra når der udføres ændringer/hvor der er ser-
vicevinduer [SPref].
Beskedfordeler driftsafvikles hele døgnet alle dage
bortset fra når der udføres ændringer/hvor der er ser-
vicevinduer [BFref].
CPR driftsafvikles hele døgnet alle dage bortset fra,
når der udføres ændringer/hvor der er servicevinduer
Se ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
Svartid Serviceplatformen har forskellig SLA på svartid alt efter
hvilken integrationskompleksitet, der er tale om [SPref]:
Simpel = 1 sekund
Mellem = 1,5 sekund
Kompleks = 4 sekunder
Svartid for Beskedfordeler er beskrevet i [BFref].
CPR driftsafvikles hele døgnet alle dage bortset fra,
når der udføres ændringer/hvor der er servicevinduer
Se ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er
99,8% for perioden 06:00 -18:00 på arbejdsdage samt
98,5 % i den øvrige tid [SPref].
Tilgængelighed for Beskedfordeler er beskrevet i
[BFref].
CPR driftsafvikles hele døgnet alle dage bortset fra,
når der udføres ændringer/hvor der er servicevinduer
Se ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages
at være i perioden 06:00 -18:00 på arbejdsdage
[SPref].
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 33
Spidsbelastning for Beskedfordeler er beskrevet i
[BFref].
CPR driftsafvikles hele døgnet alle dage bortset fra,
når der udføres ændringer/hvor der er servicevinduer
Se ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
Servicevinduer Ved mindre opdateringer for Serviceplatformen:
En gang om ugen i tidsrummet 05:00 -06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer:
Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer
Ved omlægning af miljøer, arkitektur og services for Serviceplatformen:
1 gang pr. kvartal i tidrummet søndag kl. 22:00 til man-dag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref].
Servicevinduer for Beskedfordeler er beskrevet i
[BFref].
CPR driftsafvikles hele døgnet alle dage bortset fra,
når der udføres ændringer/hvor der er servicevinduer
Se ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
1.3.2 Service Management
Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil inte-
grationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data
Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til [email protected]. KDF sørger
for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne.
Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt test-
miljø her: https://share-komm.kombit.dk/p089/
Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Service-
platformens governanceproces. Beskrivelse af denne tilgår senere.
1.3.2.1 Incident Management
[Afklaring/Programmet – rejst emne: skal der være spoc på integrationer der anvender forskellige
integrationsplatforme, eller afgøres det pr. integration]
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 33
1.3.2.2 Problem Management
[Afklaring/Programmet – rejst emne: skal der være spoc på integrationer der anvender forskellige
integrationsplatforme, eller afgøres det pr. integration]
1.3.2.3 Change Management
[Afklaring/Programmet – rejst emne: skal der være spoc på integrationer der anvender forskellige
integrationsplatforme, eller afgøres det pr. integration]
1.3.3 Lifecycle Management
[Afklaring/Programmet: Håndteres i programemnelog #14]
1.4 Teststrategi
Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfø-
rer automatiserede tests af services og unit tests. Se [SPref] for detaljer.
Derudover:
[Afklaring/Programmet: Teststrategi håndteres i programemnelog #1]
1.4.1 Test i forbindelse med udvikling
Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfø-
rer automatiserede tests af services og unit tests. Se [SPref] for detaljer.
Derudover:
[Afklaring/Programmet: Teststrategi håndteres i programemnelog #1]
1.4.1.1 Testfaciliteter og testmiljø
Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfø-
rer automatiserede tests af services og unit tests. Se [SPref] for detaljer.
Derudover:
[Afklaring/Programmet: Teststrategi håndteres i programemnelog #1]
1.4.1.2 Testdata
[Afklaring/Programmet: Teststrategi håndteres i programemnelog #1]
1.4.2 Test i forbindelse med produktionssætning
I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der
gennemføres følgende 3 prøver:
Overtagelsesprøve
Idriftsættelsesprøve
Driftsprøve
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 33
Se [SPref] for detaljer.
Derudover:
[Afklaring/Programmet: Teststrategi håndteres i programemnelog #1]
1.5 Forudsætninger for produktionssætning
Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul,
og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leveran-
døren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af it-
systemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for
at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemty-
per (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-syste-
met jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed].
[Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, her-
under brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne mod-
tages fra STS]
1.5.1 Funktionalitet på Serviceplatformen
Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge ser-
vicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmod-
ning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed].
De nødvendige beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så systemet kan
sende de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfor-
deler [VBF].
Leverandøren skal være oprettet som tilslutningspart på SF1460_C.
Serviceplatformen skal have et opdateret lokalt replika for CPR for alle personer ved idriftsættelse.
1.5.2 Forudsætninger for tilslutning til integrationspart: CPR
KOMBIT har indgået aftale med CPR på vegne af kommunerne.
CPR beskriver tilslutningskravene i ”vk50_offentlige_vilkaar.pdf” [WSDL_EXT].
1.5.3 Forudsætninger for tilslutning til integrationspart: Fagsystemet
De nødvendige abonnementer og opsætninger skal være oprettet i Beskedfordeler, så systemet
kan modtage de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Be-
skedfordeler [STS-Sikkerhed].
Leverandøren skal være oprettet som tilslutningspart på SF1460_A/SF1460_D og SF1460_B.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 33
2 Kontekst for integrationsparter
SF1320_A indeholder følgende integrationsparter:
Kommunernes Ydelsessystem, der modtager information om personhændelser via Besked-
fordeler.
Kommunernes Sygedagpengesystem, der modtager information om personhændelser via
Beskedfordeler.
SAPA, der modtager information om personhændelser via Beskedfordeler.
CPR som leverer ændringsudtræk for persondata, som anvendes af Serviceplatformen
2.1 Kontekst for KY[!@IP_FS1@!]
2.1.1 Lovhjemmel og forvaltningsmæssigt formål
Som beskrevet i punkt 1.1
Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på be-
stillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen
til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at
denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor un-
derstrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en ori-
entering.
2.1.2 Kapacitets- og servicekrav
KY har 314.000 berørte personer om året (2012 tal). KOMBIT har estimeret at der vil være ca.
40.000 CPR ændringer til disse personer per år, ud fra tal fra Danmarks statistik om flytninger,
fødsler, dødsfald, vielser og skilsmisser.
Dvs. ca. 3.500 opdateringer om måneden.
2.1.3 Specifikke forhold for tilslutning af system
Det skal bemærkes at beskedfordeleren modtager beskeder for samtlige kommuner. Derfor skal
KY enten kun abonnere på beskeder for relevante kommuner, eller ignorere meddelelser for kom-
muner der ikke er aktive i KY.
2.2 Kontekst for KSD [!@IP_FS1@!]
2.2.1 Lovhjemmel og forvaltningsmæssigt formål
Som beskrevet i punkt 1.1.
Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på be-
stillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen
til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 33
denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor un-
derstrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en ori-
entering.
2.2.2 Kapacitets- og servicekrav
Det er estimeret at der maksimalt vil være 75.000 ændringer per måned. Hver ændring kan godt
medføre udsendelse af flere beskeder.
2.2.3 Specifikke forhold for tilslutning af system
For hver idriftsættelse af KSD (udrulning sker pr. kommune), vil der blive tegnet abonnement på
alle parter i sager i den kommune hvor KSD tages i drift.
2.3 Kontekst for SAPA [!@IP_FS1@!]
2.3.1 Lovhjemmel og forvaltningsmæssigt formål
Som beskrevet i punkt 1.1.
Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på be-
stillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen
til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at
denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor un-
derstrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en ori-
entering.
2.3.2 Kapacitets- og servicekrav
Alle kommuner som benytter SAPA vil udtrykkes som et geografisk abonnement, det forventes at
SAPA rulles ud i bølger til kommunerne.
SAPA forventes at modtage personhændelser på alle borgere i de kommuner som benytter SAPA.
Det vil sige op til cirka 5000 ændringer om dagen. Dette svarer ca. til alle hændelser der genereres
på Serviceplatformen.
2.3.3 Specifikke forhold for tilslutning af system
Det skal bemærkes at beskedfordeleren modtager beskeder for samtlige kommuner. Derfor skal
SAPA enten kun abonnere på beskeder for relevante kommuner, eller ignorere meddelelser for
kommuner der ikke er aktive i SAPA.
2.4 Kontekst for CPR [!@IP_CPR1@!]
2.4.1 Lovhjemmel og forvaltningsmæssigt formål
Som beskrevet i punkt 1.1.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 33
Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på be-
stillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen
til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at
denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor un-
derstrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en ori-
entering.
2.4.2 Kapacitets- og servicekrav
CPR udstiller cirka 5000 ændringer om dagen.
2.4.3 Specifikke forhold for tilslutning af system
Udtrækket leveres på CPR ftp platform og hentes via sftp af Serviceplatformen som beskrevet i
https://cpr.dk/kunder/produktdokumentation,-guides-og-tjeklister/ftp-(cpr-udtraek)/
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 33
3 Specifikation for integrationsparter
SF1320_A indeholder følgende integrationsparter:
Kommunernes Ydelsessystem, der modtager information om personhændelser via Besked-
fordeler. Kommunernes Ydelsessystem beskrives i afsnit 3.1.
Kommunernes Sygedagpengesystem, der modtager information om personhændelser via
Beskedfordeler. Kommunernes Sygedagpengesystem beskrives i afsnit 3.1.
SAPA, der modtager information om personhændelser via Beskedfordeler. SAPA beskrives
i afsnit 3.1.
CPR som leverer ændringsudtræk for persondata, som anvendes af Serviceplatformen.
CPR beskrives i afsnit 3.2.
Integrationen mellem Serviceplatformen og Beskedfordeler beskrives i afsnit 3.3.
Sammenhængen mellem endpoints er illustreret i afsnit 4.1.
3.1 Specifikation af endpoints for fagsystem KY, KSD, SAPA[!@KY@!][!@KSD@!] [!@SAPA@!]
Integrationen benyttes af fagsystemet til at modtage beskeder med ændringer i personoplysninger
fra Beskedfordeler. Fagsystemet benytter også integrationen til at vedligeholde værdilister på Be-
skedfordeler.
3.1.1 Overordnet forretningslogik
Fagsystemet modtager beskeder om ændringer i personoplysninger fra Beskedfordeler:
Fagsystemet modtager beskeder (push / pull) via EP_FS1
Fagsystemet opretter og vedligeholder et abonnement (værdiliste) på Beskedfordeler via
EP_FS2
3.1.2 Oversigt over endpoints
ID Navn
EP_FS1 ModtagBesked (ændringer til personoplysninger) [SF1460_A/SF1460_D]
EP_FS2 AdministrerVaerdiliste [SF1460_B]
3.1.3 Beskrivelse af endpoint EP_FS1 – ModtagBesked
Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull
[SF1460_D]. Fagsystemet vælger selv om der benyttes pull eller push.
Beskedfordeler udstiller beskeder fra CPR. Endpoint benyttes af fagsystemerne i forbindelse med
ændringer i personoplysninger.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 33
3.1.3.1 Abonnementsvilkår
Fagsystemet skal oprette abonnement på beskedtypen ’CPRopdatering’.
Beskedernes objekt er ”Person” identificeret med CPR-nummer.
Beskeden kan indeholde 7 relaterede objekter i denne orden:
0) CPR hændelseskode (urn 3 karakterer)
1) Mor (CPR-nr)
2) Far (CPR-nr)
3) Ægtefælle eller tidl. Ægtefælle (CPR-nr)
4) Barn (CPR-nr)
5) Gammelt CPR eller dobbelt (CPR-nr)
6) Adresse (urn)
Hvor det er muligt at udvælge det man ønsker i abonnementet. Adresse-urn er defineret som
urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;aaaa, hvilket er KOMKOD, VEJKOD, HUSNR,
ETAGE,SIDEDOER og BNR fra CPR-udtræksformat record 3. Dette vil give en entydig adresse i
urn’en.
Hvis man kun ønsker at få CPRopdateringer på de personer, som er tilknyttet fagsystemet, skal
fagsystemet vedligeholde en værdiliste med personkreds, som navngives ”Personkreds”. Værdili-
sten vedligeholdes som angive i afsnit Fejl! Henvisningskilde ikke fundet..
Tilsvarende kan fagsystemet tilknytte en adresseobservationsliste, hvor man vedligeholder en liste
med adresse-urn’er for de adresse som man ønsker at modtage CPRopdateringer på, kaldet
”Adresser”.
Eksempler på abonnementsudtryk:
”Giv alle beskeder, hvor personer er i værdilisten ’Personkreds’”:
Forretningsobjektets type er ”Person”, der har et UUID ”126667fa-edeb-40c6-9288-
58bb7de17a7b”.
Personkreds er vedligeholdt i en liste med navnet ”Personkreds”.
Match udtrykket bliver da:
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obj
ektType = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obje
ktId IN @Personkreds))
”Giv alle beskeder, hvor relaterede personer er i værdilisten ’Personkreds’”:
Forretningsobjektets type er ”Person”, der har et UUID ”126667fa-edeb-40c6-9288-
58bb7de17a7b”.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 33
Personkreds er vedligeholdt i en liste med navnet ”Personkreds”.
Match udtrykket bliver da:
(((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[1].Objek
tType = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[1].ObjektI
d IN @Personkreds)) OR
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[2].Objekt
Type = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[2].ObjektI
d IN @Personkreds))OR
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[3].Objekt
Type = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[3].ObjektI
d IN @Personkreds))OR
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[4].Objekt
Type = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[4].ObjektI
d IN @Personkreds))OR
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[5].Objekt
Type = “126667fa-edeb-40c6-9288-58bb7de17a7b”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[5].ObjektI
d IN @Personkreds)))
”Giv alle beskeder, hvor relaterede adresser er i værdilisten ’Adresser’”:
Forretningsobjektets type er ”Adresse”, der har et UUID ”<Indsæt UUID for ”Adresse”>”.
Adresselisten er vedligeholdt i en liste med navnet ”Adresser”.
Match udtrykket bliver da:
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[6].Objekt
Type = “<Indsæt UUID for ”Adresse”>”) AND
(Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[6].ObjektI
d IN @Adresser))
”Giv alle beskeder, hvor beskedhandling er ”Fødsel”:
Forretningsobjektets handling er ”Fødsel”, der har et UUID ”<Indsæt UUID for ”Fødsel”>”.
Match udtrykket bliver da:
((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obj
ektHandling = “<Indsæt UUID for ”Fødsel”>”))
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 33
3.1.3.2 Dataspecifikation
For beskedtyper og beskedindhold se beskrivelse i afsnit 4.1.2.4.
3.1.4 Beskrivelse af endpoint EP_FS2 – AdministrerVaerdiliste
Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B].
Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnemen-
ter. Endpoint kaldes af fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonne-
ment.
Kapitel 3.x.y.z Værdiliste
Fagsystemerne skal vedligeholde værdilister for de personkredse og adresselister, det ønsker at
abonnere på.
Værdilisterne skal oprettes med følgende navn:
Personkreds – ”Personkreds”
Adresseliste – ”Adresser”
Service Management
Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull
[SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B].
3.2 Specifikation af endpoints for CPR
Serviceplatformen modtager dagligt en liste af personændringer fra CPR.
3.2.1 Overordnet forretningslogik
Hvert døgn udstiller CPR ændringer i personoplysninger, udtrækket udstiller alle ændringer og re-
turnerer alle rækker. Serviceplatformen modtager således en fuld kopi af personens nuværende
oplysninger fra CPR ved hver ændring.
Serviceplatformen henter ændringerne fra CPR ftp service (EP_CPR1) og Serviceplatformen op-
daterer det lokale cpr replika og udsender beskeder om ændringer i det fælleskommunale støttesy-
stem Beskedfordeler.
3.2.2 Oversigt over endpoints
ID Navn
EP_CPR1 Modtag ændrede persondata fra CPR. EP_CPR1 svarer til den eksisterende integration
mellem Serviceplatformen og CPR.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 33
3.2.3 Beskrivelse af endpoint EP_CPR1
3.2.3.1 Transportspecifikation
3.2.3.1.1 Integrationsmønster
Integration til CPR fra Serviceplatformen via filoverførsel
3.2.3.1.2 Serviceudstiller
CPR er serviceudstiller
3.2.3.1.3 Serviceanvender
Serviceplatformen er serviceanvender
3.2.3.1.4 Teknologisk understøttelse
CPR Snitfladen er implementeret som en filoverførsel. CPR giver mulighed for sikkerhedsopsæt-
ning via SFTP eller FTPS: I denne integration anvendes SFTP.
Se flere detaljer på:
https://cpr.dk/kunder/produktdokumentation,-guides-og-tjeklister/ftp-(cpr-udtraek)/
3.2.3.1.5 Teknisk endpoint
Miljø: Produktion
URI til WSDL [Besvares senere af Systematic]
Endpoint navn
Endpoint IP
Miljø: Præproduktion
URI til WSDL [Besvares senere af Systematic]
Endpoint navn
Endpoint IP
3.2.3.1.6 Teknisk retning for udveksling
Serviceplatformen henter ændringsudtræk hos CPR.
3.2.3.1.7 Dataretning for udveksling
CPR udstiller ændringer til Serviceplatformen.
3.2.3.1.8 Service invokation / Triggers
Kommunikation initieres af at Serviceplatformen en gang i døgnet.
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 33
3.2.3.2 Dataspecifikation
Dataformatet er baseret på U12170-p, der modtages alle recordtyper. Udtrækket er identisk med
den eksisterende integration til CPR abonnement.
Se https://cpr.dk/kunder/offentlige-myndigheder/udtraek/dokumentation-for-udtraek-til-offentlige/
3.2.3.3 Sikkerhed
Sikkerhed er baseret på SFTP.
3.2.3.4 Leverancesikkerhed og fejlhåndtering
Serviceplatformen skal hente alle ændringer til personnumre, samt håndtere fejl som er angivet i
recordtype 910 i udtrækket.
3.2.3.5 Servicemål
Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid.
3.2.3.5.1 Aftalt driftstid
Parameter Værdi
Tidsrum [Udfyldes med tidsrummet hvor der sikres normal drift]
Svartid [Udfyldes med angivelse af det maksimale svartid for dataud-
vekslingen.]
Tilgængelighed [Udfyldes med krav til oppetid inden for aftalt driftstid – fx 99,5
pct.]
Spidsbelastningsperiode [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.]
Servicevinduer [Udfyldes med oplysninger om aftalte servicevinduer og varsling
af nedetid.]
3.2.4 Service Management
3.2.4.1 Incident Management
[Indhold afventer generel afklaring af governancestrukturer.]
3.2.4.2 Problem Management
[Indhold afventer generel afklaring af governancestrukturer.]
3.2.4.3 Change Management
[Indhold afventer generel afklaring af governancestrukturer.]
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 33
3.2.5 Testplan
3.2.5.1 Integrationstest
[Indhold afventer generel afklaring af test]
3.2.5.2 Produktionssætningstest
[Indhold afventer generel afklaring af test]
3.3 Specifikation af endpoints for Serviceplatformen som afsendende beskedagent [!@Systematic@!]
Integrationen benyttes af Serviceplatformen til at sende CPRopdateringsbeskeder til Beskedforde-
ler.
3.3.1 Overordnet forretningslogik
Serviceplatformen beregner og sender CPRopdateringsbeskeder til Beskedfordeler:
Serviceplatformen kalder EP_SP1
Beskedfordeler returnerer et synkront svar til afsender
3.3.2 Oversigt over endpoints
ID Navn
EP_SP1 AfsendBesked
3.3.3 Beskrivelse af endpoint EP_SP1 – AfsendBesked
Beskrivelsen af endpoint findes i Aflever besked [SF1460_C].
Serviceplatformen sender CPRopdateringsbeskeder. Endpoint kaldes ved ændring i CPR.
3.3.3.1 Dataspecifikation
En besked består af en kuvert og et beskedindhold.
3.3.3.1.1 Beskedkuverten dataspecifikation
Dataspecifikationen for beskedkuverten findes i følgende schema-filer:
Miljø: Produktion og Test
Inputdata Se [SF1460_C]
Outputdata Se [SF1460_C]
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 33
Beskedkuverten udfyldes som beskrevet i afsnit 4.1.2.4.
3.3.3.1.2 Beskedindhold dataspecifikation
Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer:
Miljø: Produktion og Test
Inputdata Se [SF1520]
Outputdata
3.3.4 Service Management
Beskrivelsen af Service Management findes i Aflever besked [SF1460_C].
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 33
4 Beskrivelse for integrationsplatforme
4.1 Beskrivelse for Serviceplatformen [!@Systematic@!]
Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i inter-
aktionen mellem integrationsparterne. Snitfladerne er defineret således i forhold til forretningsflo-
wet.
En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nær-
værende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være
specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3.
Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen.
IF01CPR
Serviceplatformen
EP_CPR1
Fagsystem(n)
SF1460_A/D
EP_FS1SF1460_B
EP_FS2
Beskedfordeler
EP_SP1
SF1460_C
4.1.1 Oversigt over integrationsflows
ID Navn
IF01 Hent og Distribuer CPR Hændelser
4.1.2 Integrationsflow [IF01]: Hent CPR Hændelser
4.1.2.1 Anvendte service endpoints
Endpoint ID Navn på endpoint Dokument-reference
EP_CPR1 Snitflade til at afhente personhændelser. Afsnit 3.2.3
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 33
EP_SP1 Snitflade til aflevere beskeder om personhændelser. Afsnit Fejl! Henvis-
ningskilde ikke fun-
det.
4.1.2.2 Integrationstype
Integrationen er en beskedagentintegration med transformation.
Forretningsbeskeder udsendes via det fælleskommunale støttesystem Beskedfordeler
[SF1460_C].
4.1.2.3 Diagram over integrationsflowet
Jf. figuren nedenfor indgår følgende integrationsflows i integrationen.
Fagsystem(n) Beskedfordeler Serviceplatformen CPR
Hent CPR Udtræk
EP_CPR1
Gentag indtil alt sendt
4.1.2.4 Datatransformering
Data skal transformeres fra CPR’s GCTP format til xsd format i beskeder som afsendes via det
fælleskommunale støttesystem Beskedfordeler.
Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer.
Værdier angivet med ” ” er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal
afsendersystemet selv udfylde.
[De fleste Id’er er baseret på UUID dog med undtagelse af:
KLE - urn:oio:kle:nn.nn.nn
CPR - urn:oio.cpr:nnnnnnnnnn
CVR - urn:oio:cvr:nnnnnnnn
PNR – urn:oio:pnr:nnnnnnnnnn
Fuldtnavn - urn:oio:fuldtnavn:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Adresse - urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;aaaa
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 33
da disse ikke repræsenteret af et UUID og derfor skal benytte urn.]
[Afklaring/KDF: Endelig definition af urn]
Element Beskrivelse Værdifelt udfyldelse
Filtreringsdata
Beskedtype ”CPRopdatering” [Afklaring/KDF: UUID for beskedtypen
”CPRopdatering”]
BeskedAnsvarligAktør Det it-system, der afsender
beskeden, er CPR
[Afklaring/KDF: UUID for it-systemet CPR]
TilladtModtager Borgerenes bopælskom-
mune
Tomt
RelateretObjekt[0] ”CPR Hændelseskode”
ObjektId CPR hændelseskode på 3
tegn
[Afklaring/KDF: urn for CPR hændelses-
kode]
ObjektType Forretningsobjektet ”CPR
Hændelseskode”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”CPRhændelseskode”]
ObjektRolle Tomt
RelateretObjekt[1] ”Mor”
ObjektId CPR-nummer på ”Mor” ”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”Person”]
ObjektRolle
RelateretObjekt[2] ”Far”
ObjektId CPR-nummer på ”Far” ”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 33
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”Person”]
ObjektRolle
RelateretObjekt[3] ”Ægtefælle (evt. tidligere)”
ObjektId CPR-nummer på ægtefælle ”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”Person”]
ObjektRolle
RelateretObjekt[4] ”Barn”
ObjektId CPR-nummer på barn ”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”Person”]
ObjektRolle
RelateretObjekt[5] ”Gammelt/Dobbelt CPR”
ObjektId Gammelt CPR-nummer på
borgeren
”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for forretningsobjek-
tet ”Person”]
ObjektRolle
RelateretObjekt[6] ”Adresse”
ObjektId Adresse [Afklaring/KDF:
”urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;
aaaa”]
ObjektType Forretningsobjektet
”Adresse”
[Afklaring/KDF: Indsæt UUID for forret-
ningsobjektet ”Adresse”]
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 af 33
ObjektRolle
Objektregistrering
ObjektRegistreringId Identifikation af hændelsen,
der ligger til grund for be-
skeden.
[Afklaring/KDF: urn:kombit:cpr-tran-
sid:nnnnnn-nnnnnn for CPR udtræk id – re-
cord 000 OPGAVENR-PRODDTO]
RegistreringsAktoer Det it-system, der har gene-
reret hændelsen, er SP
[Afklaring/KDF: UUID for SP]
Registreringstidspunkt Tidspunkt for hændelsens
udsendelse fra kilden
SP’s tid i DateTime format
ObjektAnsvarligMyndighed Borgerenes bopælskom-
mune (CVR)
”urn:oio:cvr:nnnnnnnn” (hvor nnnnnnnn
er et 8-cifret CVR nummer).
ObjektId Borgerens CPR-nummer ”urn:oio:cpr:nnnnnnnnnn” (hvor
nnnnnnnnnn erstattes med 10-cifret CPR-
nummer uden bindestreg)
ObjektType Forretningsobjektet ”Per-
son”
[Afklaring/KDF: UUID for ”Person”]
ObjektHandling Handlingen ”CPRopdate-
ring”
[Afklaring/KDF: UUID for ”CPR-001” –
”CPR-041”]
OpgaveEmne
Leveranceinformation
Dannelsestidspunkt Tidspunkt hvor beskeden
opstod
SP’s tid i DateTime format
Sikkerhedsklassificering Klassificeringen f.eks. ”Per-
sonfølsomt”
[Afklaring/KDF: UUID for ”Personfølsomt”]
GyldighedFra Tidspunkt hvor hændelsen
skal gælde fra
SP’s tid i DateTime format
De relaterede objekter udfyldes forskelligt ud fra handlingstypen.
[Afklaring/KDF: Nedenstående tabel angiver de 5 felter i kuverten, som skal udfyldes forskelligt for
specifikke hændelser for personer (CPR-001 til CPR-041) – er under opdatering af SAPA – skal
indeholde klare regler for generering af beskeder].
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 af 33
Felter markeret i citationstegn (””) angiver at det er en statisk tekststreng som er ens for alle be-
skeder. Felter markeret med (tom) betyder at feltet ikke skal udfyldes for alle beskeder.
Personen som ændres skal være indeholdt som en objektregistrering, adresse er indeholdt som et
relateret objekt. Tilknytningskommune, bopælskommune og fraflytningskommune er angivet som
ObjektAnsvarligMyndighed og TilladtModtager.
ID fra afsnit 1.2.3 Beskedtype Beskedtypetekst RelateretObjek
t
ObjektAnsvarli
gMyndighed
TilladtModtage
r
Ændring af regi-
strering CPR-001
Ændring af regi-
strering
URN på tilflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Fødsel CPR-002 Fødsel (tom) Bopælskommune (tom)
Navngivning CPR-003 Navngivning (tom) Bopælskommune (tom)
Navneændring CPR-004 Navneændring (tom) Bopælskommune (tom)
Dødsfald CPR-005 Dødsfald (tom) Bopælskommune (tom)
Dødsfald - som
forsvundet CPR-006
Dødsfald - som for-
svundet (tom) Bopælskommune (tom)
Dødsfald - som
udvandret CPR-007
Dødsfald - som ud-
vandret (tom) Bopælskommune (tom)
Dødsfald som ny-
født CPR-008
Dødsfald som ny-
født (tom) Bopælskommune (tom)
Dødsfald – ægte-
fælle CPR-009
Dødsfald – ægte-
fælle (tom) Bopælskommune (tom)
Forsvinding CPR-010 Forsvinding URN på fraflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Genfinding CPR-011 Genfinding URN på tilflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Indvandring CPR-012 Indvandring URN på tilflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Udvandring CPR-013 Udvandring URN på fraflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Genindvandring CPR-014 Genindvandring URN på tilflytnings-
adresse
Fraflytningskom-
mune Tilflytningskommune
Nynummerering CPR-015 Nynummerering (tom) Bopælskommune (tom)
Omnummerering
nyt nummer CPR-016
Omnummerering
nyt nummer (tom) Bopælskommune (tom)
Sletning af per-
sonnummer CPR-017
Sletning af person-
nummer (tom) Bopælskommune (tom)
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 af 33
Tidligere dobbelt
nummer CPR-018
Tidligere dobbelt
nummer (tom) Bopælskommune (tom)
Udgår grundet
omnummerering CPR-019
Udgår grundet om-
nummerering (tom) Bopælskommune (tom)
Myndiggørelse CPR-020 Myndiggørelse (tom) Bopælskommune (tom)
Umyndiggørelse CPR-021 Umyndiggørelse (tom) Bopælskommune (tom)
Folkekirketilknyt-
ning ændret CPR-022
Folkekirketilknyt-
ning ændret (tom) Bopælskommune (tom)
Statsborgerskab
ændret CPR-023
Statsborgerskab
ændret (tom) Bopælskommune (tom)
Faderskab – far CPR-024 Faderskab – far (tom) Bopælskommune (tom)
Fødsel – mor CPR-025 Fødsel – mor (tom) Bopælskommune (tom)
Faderskab – barn CPR-026 Faderskab – barn (tom) Bopælskommune (tom)
Adoption – barn CPR-027 Adoption – barn (tom) Bopælskommune (tom)
Vielse CPR-028 Vielse (tom) Bopælskommune (tom)
Separation startet CPR-029 Separation startet (tom) Bopælskommune (tom)
Separation ophørt CPR-030 Separation ophørt (tom) Bopælskommune (tom)
Skilsmisse CPR-031 Skilsmisse (tom) Bopælskommune (tom)
Ændring vedrø-
rende ægtefælle CPR-032
Ændring vedrø-
rende ægtefælle (tom) Bopælskommune (tom)
Ændring vedrø-
rende slægtskab CPR-033
Ændring vedrø-
rende slægtskab (tom) Bopælskommune (tom)
Flytning til kom-
munen CPR-034
Flytning til kommu-
nen
URN på tilflytnings-
adresse, URN på fra-
flytningsadresse
Fraflytningskom-
mune Tilflytningskommune
Flytning fra kom-
munen CPR-035
Flytning fra kom-
munen
URN på tilflytnings-
adresse, URN på fra-
flytningsadresse
Fraflytningskom-
mune Tilflytningskommune
Fraflytning inden-
for kommunen CPR-036
Fraflytning indenfor
kommunen
URN på tilflytnings-
adresse, URN på fra-
flytningsadresse
Fraflytningskom-
mune Tilflytningskommune
Tilflytning inden-
for kommunen CPR-037
Tilflytning indenfor
kommunen
URN på tilflytnings-
adresse, URN på fra-
flytningsadresse
Fraflytningskom-
mune Tilflytningskommune
Indkaldelse til mi-
litæret CPR-038
Indkaldelse til mili-
tæret
URN på bopæls-
adresse Bopælskommune Bopælskommune
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 af 33
Hjemsendelse fra
militæret CPR-039
Hjemsendelse fra
militæret
URN på bopæls-
adresse Bopælskommune Bopælskommune
Start afsoning CPR-040 Start afsoning URN på bopæls-
adresse Bopælskommune Bopælskommune
Slut afsoning CPR-041 Slut afsoning URN på bopæls-
adresse Bopælskommune Bopælskommune
Beskedindholdet’s XSD skal være tilsvarende XSD fra SF1520. Systematic skal eventuelt udar-
bejde et forslag til XSD for beskedindholdet i beskeddata for persondata, som modtages i forbin-
delse med en ændring modtaget fra CPR.
Beskedkuverten i hver besked skal indeholde ”Hændelseskoden” fra cpr udtrækket, såfremt et æn-
dringsudtræk fra CPR indeholder flere hændelseskoder, så skal der udløses en besked for alle
hændelseskoder, ud fra forretningsreglerne. CPR-001er en generel CPR-ændring og skal kun ud-
løses én gang per CPR-nummer, og kan benyttes til at opdatere et lokalt replika af CPR. Besked-
indhold er altid det nye dataindhold i SP’s CPR replika.
4.1.2.5 Datapersistering
Det lokale replika skal opdateres med ændringer modtaget fra CPR.
Beskeder skal opbevares indtil de er modtaget af Støttesystemet Beskedfordeler.
4.1.2.6 Databerigelse
Data beriges ikke, men transformeres jf. afsnit 4.1.2.4.
4.1.2.7 Routing
Ændringer i CPR vil medføre en eller flere beskeder jf. transformeringen i afsnit 4.1.2.4
4.1.2.8 Orkestrering
N/A
4.1.2.9 Sikkerhed
Der er sikkerhedsopsætning i EP_CPR1, EP_SPB1, EP_FS1 og EP_FS2.
EP_CPR1 er en integration, hvor serviceplatformen henter ændringer hos CPR. Systematic skal
anvende SFTP for at afhente det ændringer.
Sikkerhedsopsætningen hos CPR er dokumenteret i https://cpr.dk/kunder/produktdokumentation,-
guides-og-tjeklister/ftp-(cpr-udtraek)/
9Integrationsbeskrivelse
SF1320_A - CPR - Hændelser
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 33 af 33
EP_SPB1 er en integration til det fælleskommunale støttesystem Beskedfordeler. Serviceplatfor-
mens service skal oprettes som et anvendersystem og være autoriseret til at sende personbeske-
der. Integrationsmønsteret skal følge UC-SEC-04 og benytte Tokens til autentificering og autorise-
ring mellem Serviceplatform og Beskedfordeler.
4.1.2.10 Logning
Det skal logges at beskeder er modtaget af det fælleskommunale Støttesystem Beskedfordeler.
4.1.2.11 Testdata og testfaciliter
[Indhold afventer generel afklaring af test]
4.1.2.12 Konfiguration
Det skal være muligt for en systemadministrator at administrere hvilke forretningshændelser som
beskrevet i afsnit 1.2.3 som er aktive/inaktive. Det skal være muligt at tilføje og fjerne forretnings-
hændelser.
4.1.2.13 Supplerende information
Ingen