Integration SF CPR online opslag Integrationsbeskrivelse - version 2.0.0

Transkript

1 F Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer PBO Første version PBO Klar til fase PBO Klar til fase EHE 0.3 Klar til fagprojekt review EHE 0.5 Klar til SP EDM Klar til SP med fejlrettelse i integrationsflow EDM Opdateret med beslutning i emne 91 / Jira AE56. urn:oio.cprnr:xxxx EHE Opdateret volumental for SAPA EDM Opdateret med referencer og nye WSDL og XSD MHO Referencerettelser mm EHE Teknisk beskrivelse indarbejdet Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS-Sikkerhed] [WSDL-SP] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Integrationsbeskrivelsen refererer til SF1520 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link KOMBIT A/S Halfdansgade København S CVR Side 2 af 32

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Kontekst for SAPA Kontekst for CPR Specifikation for integrationsparter Specifikation af endpoints for Fagsystemer(n) Specifikation af endpoints for CPR Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 32

4 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at give offentlige myndigheders fagsystemer mulighed for at fremsøge personoplysninger, som er relevante i forbindelse med offentlige myndigheders behandling af myndighedssager eller som led i forvaltningsvirksomhed. Integrationen skal understøtte, at der kan fremsøges lister over personer ud fra navn eller fødselsdato samt et detaljeret personopslag inklusive adressehistorik baseret på et personnummer. Følgende fagsystemer anvender denne snitflade: Kommunernes Ydelsessystem (KY) Kommunernes Sygedagpengesystem (KSD) Sagsoverblik/Partsoverblik (SAPA) 1.2 Overordnet forretningsflow i integrationen Jf. figuren indgår følgende forretningsflow i integrationen. Daglig opdatering, CPR udstiller et ændringsudtræk for personer en gang i døgnet. Serviceplatformen henter overførslen og opdateret replikaet, som er en lokal kopi af CPR registret. Daglig opdatering, CPR Vej udstiller et ændringsudtræk for distriktsinformation en gang i døgnet på hverdage. Serviceplatformen henter overførslen og opdateret replikaet med distriktsinformation. Når CPR Vej udfases skal der benyttes en eller flere kilder. Dette er ikke en del af scope af denne snitflade. Serviceplatformen udstiller to søgeservices til brug for fagsystemer. o Personliste, opslag som kan fremsøge lister af personer på baggrund af valgfrie parametre såsom navn, fødselsdato, samt angivelse af kommunekode. o Personopslag på personnummer som returnerer oplysninger om person, adresse og familie. KY, KSD og SAPA anvender de udstillede søgeservices. Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. IF01 Daglig opdatering af CPR IF02 Daglig opdatering af CPR-Vej IF03 Personliste IF04 Personopslag KOMBIT A/S Halfdansgade København S CVR Side 4 af 32

5 Serviceplatformen Anvendersystem (KY,KSD,SAPA) CPR Vej CPR Serviceplatformen Integrationsbeskrivelse SF1520 IF01 Daglig Opdatering af CPR IF02 Daglig Opdatering af CPR Vej Periodisk Persister data Periodisk Persister data Hent data Modtag data Hent data Modtag data Udstil Persondata Periodisk Dan udtræk Udstil vej- data Periodisk Dan udtræk SF1520 IF03 Personliste IF04 Personoplsag Forespørg Personliste Modtag Personliste Forespørg Personopslag Modtag Personopslag Modtag forespørgsel Udstil data Modtag forespørgsel Udstil data KOMBIT A/S Halfdansgade København S CVR Side 5 af 32

6 1.2.1 Ændringer ift. eksisterende snitflade Den eksisterende funktionalitet til opdatering af CPR replikaet skal genbruges på Serviceplatformen. De eksisterende services på Serviceplatformen skal bibeholdes. I forhold til den eksisterende snitflade så skal der tilføjes en ny cpr-vej replika opdatering og to nye services: CPR-Vej Replika opdatering Personopslag-service Personliste-service CPR-Vej replikaet vil indeholde information om følgende distrikter: Kode i CPR-Vej Distrikts navn 004 POSTDIST Post distrikt 006 BYFORNYDIST Byfornyelsesdistrikt 007 DIVDIST Diverse distrikter 008 EVAKUERDIST Evakueringsdistrikt 009 KIRKEDIST Kirke distrikt 010 SKOLEDIST Skole distrikt 011 BEFOLKDIST Befolkningsdistrikt 012 SOCIALDIST Social distrikt 013 SOGNEDIST Sogne distrikt 014 VALGDIST Valg distrikt 015 VARMEDIST Varme distrikt Følgende skal kendetegne de nye ændringer: CPR Vej Replika. Der skal udarbejdes en CPR Vej replika som indeholder adresser og alle distrikter. CPR-Vej replikaet skal etableres og herefter opdateres dagligt via et ændringsudtræk. Ændringsudtrækket bestilles af KOMBIT som myndighed. Personopslag-service. Der skal udarbejdes en Personopslag service, der datamæssigt rummer de samme entiteter som Person Stamdata og Familie+ services (jf. dog skal Personopslaget udvides til at medtage yderligere felter omkring person, adresse, forældre og familieoplysninger, adressehistorik samt distriktsinformation. Personliste-service. Der skal udarbejdes en Personliste service, der er mere bredt anvendelig end den, der i dag findes på Serviceplatformen ved navn ADRSOG1, jf.: KOMBIT A/S Halfdansgade København S CVR Side 6 af 32

7 ( Den generiske Personliste skal udvides fra ADRSOG1 til at medtage muligheden for at søge på fødselsdato. Endvidere skal alle parametre være valgfrie, således at kun én væsentlig parameter er krævet. I stedet for kommunekode så skal CVR nummer på kommunen angives. [Afklaring/SSE: SSE har gjort KDF opmærksom på, at det kan medføre performanceproblemer at gøre flere parametre valgfri - der kan altså vise sig behov for mere restriktive søgekriterier. SSE bedes konkretisere hvilken betydning dette har ift. de svartider, der gælder i den nuværende kontrakt.] For begge services gælder at de autentificeres og autentikeres ved at benytte den fælleskommunale støttesystem Adgangsstyring. De skal således oprettes som fælleskommunale services. For begge services skal der udarbejdes nye XML-skemaer (XSD) for returdata, som skal godkendes af KOMBIT. [Afklaring/SSE: KOMBIT ønsker et forslag fra Systematic til hvorledes status på den daglige opdatering af begge replika kan udstilles både online og programmatisk, fx kunne en løsning være at en status returneres ved forespørgsler eller som en service eller driftsovervågning. Løsningen skal således gøre det muligt at et fagsystem bliver i stand til se dato på seneste opdatering samt status på evt. fejl fra CPR og CPR-Vej på den nemmeste måde.] 1.3 Servicebetingelser for den samlede integration Personliste og Personopslag er replikaintegrationer, som benytter Serviceplatformens lokale kopi af CPR-data Servicemål Parameter Personliste Personopslag Tidsrum Svartid Tilgængelighed Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. 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 Servicemålene for Serviceplatformen driftseffektivitet er 99,8% Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. 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 Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for KOMBIT A/S Halfdansgade København S CVR Side 7 af 32

8 Spidsbelastningsperiode Servicevinduer for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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 mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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 mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref] Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen 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 testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere. KOMBIT A/S Halfdansgade København S CVR Side 8 af 32

9 1.4 Teststrategi [Indhold afventer generel afklaring af governancestrukturer.] Test i forbindelse med udvikling [Indhold afventer generel afklaring af governancestrukturer.] Testfaciliteter og testmiljø [Indhold afventer generel afklaring af governancestrukturer.] Testdata [Indhold afventer generel afklaring af governancestrukturer.] Test i forbindelse med produktionssætning [Indhold afventer generel afklaring af governancestrukturer.] 1.5 Tilslutning af services Funktionalitet på Serviceplatformen Serviceplatformen skal understøtte autentifikation og autorisation ved at udstille Personopslag og Personliste som fælleskommune services via Støttesystemet Adgangsstyring. Fagsystemer er anvendere af Personopslag og Personliste Generelle forhold for tilslutning til integrationspart: KY, KSD og SAPA Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] KOMBIT A/S Halfdansgade København S CVR Side 9 af 32

10 2 Kontekst for integrationsparter SF1520 indeholder følgende integrationsparter: Kommunernes Ydelsessystem (KY) Kommunernes Sygedagpengesystem(KSD) Sags og Partsoverblik (SAPA) CPR 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål KY anvender CPR Service snitfladen på Serviceplatformen til at hente autoritative stamdata omkring borgeren i forbindelse med sagsbehandling. Stamdata hentes synkront online i forbindelse med at brugeren oplyser borgerens sag. Data kan udsøges enten via CPR nummer, navn eller fødselsdato. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. 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 understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav KY forventes at foretage opslag per måned, primært i forbindelse med oprettelse af nye sager, hvor der foretages opslag på borgeren samt dennes eventuelle ægtefælle og børn Specifikke forhold for tilslutning af system Ingen identificeret. 2.2 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål Løsningen anvender CPR Service snitfladen på serviceplatformen til at hente autoritative stamdata omkring borgeren i forbindelse med sagsbehandling. Stamdata hentes synkront fra Serviceplatformens lokale replika i forbindelse med at brugeren oplyser borgerens sag. Data kan udsøges enten via CPR nummer, navn eller fødselsdato. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. 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 understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. KOMBIT A/S Halfdansgade København S CVR Side 10 af 32

11 2.2.2 Kapacitets- og servicekrav Der forventes maksimalt opslag per måned Specifikke forhold for tilslutning af system Ingen identificeret. 2.3 Kontekst for SAPA Lovhjemmel og forvaltningsmæssigt formål Løsningen anvender CPR Service snitfladen på serviceplatformen til at hente autoritative stamdata omkring borgeren i forbindelse med behandling af forespørgsler. Stamdata hentes synkront online i forbindelse med at brugeren oplyser borgerens sag. Data kan udsøges enten via CPR nummer, navn eller fødselsdato. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. 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 understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav Løsningen forventes at foretage opslag per dag Specifikke forhold for tilslutning af system Ingen. 2.4 Kontekst for CPR Lovhjemmel og forvaltningsmæssigt formål Serviceplatformen anvender CPR ændringsudtræk for personer og CPR-Vej. CPR udstiller et ændringsudtræk for alle person ændringer og et ændringsudtræk for CPR-Vej. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. 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 understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav CPR udstiller alle ændringer til personer og distrikter Specifikke forhold for tilslutning af system Ingen. KOMBIT A/S Halfdansgade København S CVR Side 11 af 32

12 3 Specifikation for integrationsparter SF1520 indeholder følgende integrationsparter i afsnit 3: Kommunernes Ydelsessystem (KY), der beskrives som fagsystem i afsnit 3.1 Kommunernes Sygedagpengesystem(KSD), der beskrives som fagsystem i afsnit 3.1 Sags og Partsoverblik (SAPA), der beskrives som fagsystem i afsnit 3.1 CPR, der beskrives som fagsystem i afsnit Specifikation af endpoints for Fagsystemer(n) Integrationen benyttes til at give fagsystemerne, herunder Kommunernes Ydelsessystem (KY), Kommunernes Sygedagpengesystem (KSD) og Sagsoverblik/Partsoverblik (SAPA) mulighed for at fremsøge personoplysninger, som er relevante i forbindelse med offentlige myndigheders behandling af myndighedssager eller forvaltningsvirksomhed. Fagsystemerne kalder Serviceplatformen, som udstiller en Personliste service til fremsøgning af borgere på forskellige parametre herunder navn og fødselsdato, samt en Personopslag service til fremsøgning af detaljerede oplysninger på om en specifik borger. Serviceplatformen foretager opslag på et lokalt replika, der opdateres hvert døgn på baggrund af et ændringsudtræk fra CPR og CPR-Vej Overordnet forretningslogik Serviceplatformen udstiller en synkron Personliste service (IF03), der udstiller persondata 1. Fagsystemet kalder EP_FS1 Personliste på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet, returformat er angivet i Serviceplatformen udstiller en synkron Personopslags service (IF04), der udstiller persondata 1. Fagsystemet kalder EP_FS2 Personopslag på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet, returformat er angivet i Oversigt over endpoints ID Navn EP_FS1 EP_FS2 Personliste Personopslag KOMBIT A/S Halfdansgade København S CVR Side 12 af 32

13 3.1.3 Beskrivelse af endpoint EP_FS1 Personliste Transportspecifikation Integrationsmønster IMID05 Ekstern WS SP Ekstern proces kalder webservice på Serviceplatformen Serviceudstiller Serviceplatformen udstiller servicen Personliste Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP 1.2 over HTTPS med TLS 1.1 og nyere Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP URI til Adgangsstyring URL til Administrationsmodul [Afklaring/SP: Endelig IP skal indsættes] [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP URI til Adgangsstyring [Afklaring/SP: Endelig IP skal indsættes] [Udfyldes af Systematic senere] KOMBIT A/S Halfdansgade København S CVR Side 13 af 32

14 URL til Administrationsmodul [Udfyldes af Systematic senere] Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen via web service kald Dataretning for udveksling Serviceplatformen returnerer persondata til Fagsystemet ud fra angivne parametre Service invokation / Triggers Kommunikationen initieres af Fagsystemet, når der ønskes personoplysninger i forbindelse med sagsbehandling og forvaltningsvirksomhed Dataspecifikation Personliste funktionen skal have samme input parametre som ADRSOG1, samt udvides med fødselsdato, mindst en parameter af typerne navn, fødselsdato, personnummer, vejnavn eller vejkode skal være angivet. Parametrenes konkrete betydning er uddybet i _adrsog1.pdf. Systematic skal udarbejde en specifikation af dette. Fagprojektet SAPA har ønske om for enkelte felter at kunne angive flere værdier, samt om det søgningen skal matche alle eller nogle af værdierne (AND/OR). De *-markerede nøgler i nedenstående tabel angiver hvilke felter det drejer sig om. Dertil er der ønske om wildcard-angivelse i søgningen (? og *). Sidst er der ønske om angivelse af hvilken kolonne søgeresultatet skal sorteres efter. Systematic bedes vurdere omfang og impact af disse ønsker og kontakte KDF herom. Nøgle AIA Bygningsnummer * Etage * Fødselsdato * Historiskvejmarkering Historisksøgning Husnummer * Husnummerfra Beskrivelse Angiver om søgningen også skal levere oplysning om, hvor mange personer der opfylder søgekriterierne (Systemafhængigt om dette ønskes). Bygningsnr. Hvis denne er udfyldt, medtages kun personer der bor/har boet i det angivne Bnr. Etage. Hvis denne er udfyldt, medtages kun personer der bor/har boet på den angivne etage. Personens registrerede fødselsdato Markering for at vejen findes på CTHISVEJ. (fra den valgte række på sekundær-vejsøgning) Medtag personer der tidligere har opfyldt kriterierne. (De historiske rækker på CTPERSONBOLIG) Husnr. Hvis denne er udfyldt, medtages kun personer der bor/har boet i det angivne husnr. Husnrfra. Hvis denne er udfyldt, medtages kun personer der bor/har boet i det angivne husnr eller i et højere nummer. KOMBIT A/S Halfdansgade København S CVR Side 14 af 32

15 Husnummertil KommuneCVR * Køn LigeUlige Maxantal Navnedelnummer Navn * Navnedel1 * Navnedel2 * Navnedel3 * Postnummer * Personnummer * Restart Sidedør * Tildato Vejkode * Vejadresseringsnavn * Husnrtil. Hvis denne er udfyldt, medtages kun personer der bor/har boet i det angivne husnr eller i et lavere nummer. Kommune kode i form af CVR nummer Køn. Hvis denne er udfyldt, medtages kun mænd eller kvinder. Værdisæt kan være M eller K. Lige/ulige-markering. Hvis denne er udfyldt, medtages kun personer der bor/har boet på et lige eller et ulige husnr. Angiver hvor mange rækker der læses ad gangen. For denne hændelse er det 20. Navnedel nummer, antallet af navnedele i navnet. Navn. Ekstra navnedel til Personnavne-søgning Ekstra navnedel til Personnavne-søgning Ekstra navnedel til Personnavne-søgning Postnummer Personnummer Restart nøgle - Der læses normalt 20 rækker ad gangen. Restart (genstart) nøglen benyttes, når de næste 20 rækker skal læses. Fx kan der angives 120, og så vil resultatsættet returnere 20 rækker fra række 120. Sidedør. Hvis denne er udfyldt, medtages kun personer der bor/har boet i den angivne side/dør. Til-dato. Hvis denne er udfyldt, medtages kun personer der har boet på adressen frem til denne dato. Vejkode Vejnavn som er standardadresse, som indeholder Vej Husnr,etage,side/dørnr Output data skal have følgende felter fra CPR replika: Output data Adressebeskyttelse Adresseringsnavn Kontaktadresse Personnummer Vejadresseringsnavn Vejviserbeskyttelse Bopælskommune CPRStatus Civilstand Beskrivelse Angiver om personen har adressebeskyttelse Navn på Personen Personens kontaktadresse (adresse4). Kan være tom Personnummer Angivelse af adressen Angiver om personen har vejviserbeskyttelse Kommunen som adressen tilhører Status på personen Personens civilstand Systematic skal udarbejde detaljeret dataspecifikation, som godkendes af KOMBIT. XSD vedlagt i SF1520-WSDL.zip KOMBIT A/S Halfdansgade København S CVR Side 15 af 32

16 Sikkerhed Personliste skal udstilles som beskrevet i afsnit Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere retursvaret. Da der er tale om en forespørgsel, som kan kaldes gentagne gange for samme person, vil fagsystemet selv være ansvarlig for at kalde igen i tilfælde af driftsforstyrrelser Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Beskrivelse af endpoint EP_FS2 Personopslag Transportspecifikation Serviceudstiller Serviceplatformen udstiller servicen Personopslag Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP 1.2 over HTTPS med TLS 1.1 og nyere Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: KOMBIT A/S Halfdansgade København S CVR Side 16 af 32

17 Miljø: Produktion URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP URI til Adgangsstyring URL til Administrationsmodul [Afklaring/SP: Endelig IP skal indsættes] [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP URI til Adgangsstyring URL til Administrationsmodul [Afklaring/SP: Endelig IP skal indsættes] [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen via web service kald Dataretning for udveksling Serviceplatformen returnerer persondata til Fagsystemet ud fra et personnummer Service invokation / Triggers Kommunikationen initieres af Fagsystemet, når der ønskes personoplysninger i forbindelse med sagsbehandling og forvaltningsvirksomhed Dataspecifikation Personopslag skal have følgende input parameter: Nøgle PNR Beskrivelse Personnummer - urn:oio.cpr-nr:xxxxxxxxxx Output data skal have følgende felter fra CPR replika: KOMBIT A/S Halfdansgade København S CVR Side 17 af 32

18 Type Felt Beskrivelse Person Adressebeskyttelse Angiver adressebeskyttelse for personen Person Alder Personens alder Person Børn under 18 år Angiver om personen har børn under 18 år. Person Civilstand Personens civilstand Person Civilstandsdato Dato for oprettelsen af den nuværende civilstand Person Familieoplysninger Kompleks type som giver personnumre eller fødselsdage på familie som kan være: - Ægtefælle - Mor - Far - Barn - Andet Angiver forældremyndighedsoplysninger for personen, Person liste af personers pnr eller fødselsdato såfremt Forældremyndighedsoplysninger de ikke har cpr Person FritagetforDigitalpost Angiver om personen er fritaget for digital post, dette felt skal hentes fra serviceplatformens replika af fritagelse jf. SF1600 og SF1601, såfremt det ikke påvirker performance. Person Fødselsdato Personens fødselsdato Person Fødselsregistreringssted Personens fødselsregistreringssted Person Køn Personens køn Person Personnavn Personens fulde navn Person Personnummer Personens aktive personnummer urn:oio.cprnr:xxxxxxxxxx Person Statsborgerskab Statsborgerskab for personen Person Statsborgerskabdato Dato for statsborgerskab Person Vejviserbeskyttelse Angiver vejviserbeskyttelse for personen Person Værgemål Kompleks type, som angiver information om Værgemål Person Værge Kompleks type, som angiver information om Værge Adresse Adressehistorik Kompleks type, som angiver personens adressehistorik Adresse C/O adresse Angiver en nuværende C/O adresse Adresse Etage Adresse Husnummer Adresse Kommunenummer Adresse Kontaktadresse Adresse Kontaktadressetype Adresse Sidedørnummer Adresse Tilflytningsdato Etage angivelse på nuværende adresse Husnummer angivelse på nuværende adresse Kommunens CVR nummer angivelse på nuværende adresse Personens fulde kontaktadresse (Adresse4) Angivelse af kontaktadressetype Sidedørs angivelse på nuværende adresse Tilflytningsdato på nuværende adresse KOMBIT A/S Halfdansgade København S CVR Side 18 af 32

19 Adresse Vejkode Adresse Vejnavn Adresse Vejadresseringsnavn Adresse Distrikter Vejkode på nuværende adresse Vejnavn på nuværende adresse Vejadresseringsnavn på nuværende adresse Liste over alle distrikter som er tilknyttet personens bopælsadresse Systematic skal udarbejde detaljeret dataspecifikation, som godkendes af KOMBIT. XSD vedlagt i SF1520-WSDL.zip Sikkerhed Personopslag skal udstilles som beskrevet i afsnit Et fagsystem tilgår altid servicen på vegne af en given myndighed Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere retursvaret inden for svartiderne og ved at tage højde for den angivne kapacitet. Da der er tale om en forespørgsel, der kan kaldes gentagne gange for samme person, vil fagsystemet selv være ansvarlig for at kalde igen i tilfælde af driftsforstyrrelser Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [SPref] [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Tilgængelighed Spidsbelastningsperiode Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KOMBIT A/S Halfdansgade København S CVR Side 19 af 32

20 Servicevinduer Ved mindre opdateringer: 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: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref] Service Management Incident Management [Indhold afventer generel afklaring af governancestrukturer.] Problem Management [Indhold afventer generel afklaring af governancestrukturer.] Change Management [Indhold afventer generel afklaring af governancestrukturer.] Testplan Integrationstest [Indhold afventer generel afklaring af governancestrukturer.] Produktionssætningstest [Indhold afventer generel afklaring af governancestrukturer.] 3.2 Specifikation af endpoints for CPR CPR benyttes til at hente alle ændringer til personer i CPR registret via et ændringsudtræk og hente alle ændringer til distrikter fra CPR-Vej. KOMBIT skal bestille abonnementet hos CPR-Vej Overordnet forretningslogik CPR udstiller hvert døgn en batch fil med ændringer til personer i CPR registret. CPR-Vej udstiller hver mandag til fredag en batch fil med ændringer til distriktsinformation. Serviceplatformen henter begge ændringsudtræk og opdaterer det lokale replika på Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 20 af 32

21 3.2.2 Oversigt over endpoints ID Navn EP_CPR1 EP_CPR2 Udstilling af ændringsudtræk for CPR personer Udstilling af ændringsudtræk for CPR-Vej Beskrivelse af endpoint EP_CPR1 Integration til CPR. Denne integration findes allerede på Serviceplatformen og skal ikke udvides yderligere, dog undtaget afklaringspunktet i afsnit Transportspecifikation Integrationsmønster Serviceplatformen benytter IMID14. IMID14 Ekstern FTP SP Serviceudstiller CPR udstiller en ftp fil på deres egen FTP server Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er SFTP baseret Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion Host IP SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test Host IP SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CPR FTP site. KOMBIT A/S Halfdansgade København S CVR Side 21 af 32

22 Dataretning for udveksling CPR udstiller ændringer i personer til Serviceplatformen Service invokation / Triggers Ændringsudtrækket genereres hvert døgn Dataspecifikation Filen er i GCTP format og returnerer alle records på baggrund af alle hændelser. Record format og indhold er beskrevet på Sikkerhed Sikkerheden er opsat via SFTP, som beskrevet på: Dette svarer sikkerhedsmodel UC-SEC Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere fejl og ændringer svarende til den nuværende løsning Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Beskrivelse af endpoint EP_CPR2 Integration til CPR-Vej. Denne integration skal etableres og implementeres på Serviceplatformen Transportspecifikation Integrationsmønster Serviceplatformen benytter IMID14. KOMBIT A/S Halfdansgade København S CVR Side 22 af 32

23 IMID14 Ekstern FTP SP Serviceudstiller CPR-Vej udstiller en ftp fil på deres egen FTP server Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er SFTP baseret Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion Host IP SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test Host IP SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CPR-Vej FTP site Dataretning for udveksling CPR-Vej udstiller ændringer i distrikter til Serviceplatformen Service invokation / Triggers Ændringsudtrækket genereres hvert døgn Dataspecifikation Filen er i record format og returnerer alle records på baggrund af alle hændelser. Record format og indhold er beskrevet på Se eksempel på: KOMBIT A/S Halfdansgade København S CVR Side 23 af 32

24 Sikkerhed Sikkerheden er opsat via SFTP, som beskrevet på: Dette svarer sikkerhedsmodel UC-SEC Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere fejl og ændringer svarende til den nuværende løsning i EP_CPR Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst KOMBIT A/S Halfdansgade København S CVR Side 24 af 32

25 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nærvæ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. Serviceplatformen Fagsystem EP_FS1 IF03 Replika Persistering IF01 EP_CPR1 CPR EP_FS2 IF04 IF02 EP_CPR Oversigt over integrationsflows ID Navn [IF01] [IF02] [IF03] [IF04] Daglig opdatering af CPR. Opdatering af CPR Replika er eksisterende funktionalitet og beskrives ikke yderligere Daglig opdatering af CPR-Vej. Opdatering af CPR-Vej Replika med distriktsinformation Personliste Personopslag KOMBIT A/S Halfdansgade København S CVR Side 25 af 32

26 4.1.2 Integrationsflow IF01 Daglig opdatering af CPR Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_CPR1 CPR Person ændringer Afsnit Integrationstype Integrationen er en Replikaintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende sekvens i integrationen. CPR Serviceplatform EP_CPR1 Opdater replika Sekvens: 1. Serviceplatformen henter cpr ændringer fra CPR ftp site 2. Serviceplatformen persisterer data på det lokale replika Datatransformering Datapersistering Alle ændringer til personer skal opdateres i det lokale replika på Serviceplatformen Databerigelse Routing KOMBIT A/S Halfdansgade København S CVR Side 26 af 32

27 Orkestrering Sikkerhed Udvekslingen sker via SFTP Logning Ingen yderligere krav Testdata og testfaciliteter [Indhold afventer generel afklaring af test] Konfiguration Ingen krav Supplerende information Ingen supplerende information Integrationsflow IF02 Daglig opdatering af CPR-Vej Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_CPR2 CPR-Vej distriksændringer Afsnit Integrationstype Integrationen er en Replikaintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende sekvens i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 27 af 32

28 CPR-Vej Serviceplatform EP_CPR2 Opdater replika Sekvens: 1. Serviceplatformen henter cpr ændringer fra CPR-Vej ftp site 2. Serviceplatformen persisterer data på det lokale replika Datatransformering Datapersistering Alle ændringer til distrikter skal opdateres i det lokale replika på Serviceplatformen Databerigelse Routing Orkestrering Sikkerhed Udvekslingen sker via SFTP Logning Ingen yderligere krav Testdata og testfaciliteter Indhold afventer generel afklaring af test KOMBIT A/S Halfdansgade København S CVR Side 28 af 32

29 Konfiguration Ingen krav Supplerende information Ingen supplerende information Integrationsflow IF03 Personliste Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 Personliste Afsnit Integrationstype Integrationen er en Replikaintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende sekvens i integrationen. Fagsystem Serviceplatform EP_FS1 Find data i lokalt replika Sekvens: 1. Fagsystem kalder Serviceplatformen med søgeparametre (synkront kald) 2. Serviceplatformen validerer og henter data 3. Serviceplatformen returnerer søgeresultat til fagsystemet, og returnerer eventuelle valideringsfejl til fagsystemet. KOMBIT A/S Halfdansgade København S CVR Side 29 af 32

30 Datatransformering Datapersistering Databerigelse Routing Orkestrering Sikkerhed EP_FS1 udstilles som beskrevet i afsnit Dette svarer til sikkerhedsmodellen UC-SEC Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration Ingen krav Supplerende information Ingen supplerende information Integrationsflow IF04 Personopslag Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS2 Personopslag Afsnit KOMBIT A/S Halfdansgade København S CVR Side 30 af 32

31 Integrationstype Integrationen er en Replikaintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende sekvens i integrationen. Fagsystem Serviceplatform EP_FS2 Find data i lokalt replika Sekvens: 1. Fagsystem kalder Serviceplatformen med et personnummer (synkront kald) 2. Serviceplatformen validerer og henter data 3. Serviceplatformen returnerer detaljeret information om personen til fagsystemet, og returnerer eventuelle valideringsfejl til fagsystemet Datatransformering Datapersistering Databerigelse Routing Orkestrering KOMBIT A/S Halfdansgade København S CVR Side 31 af 32

32 Sikkerhed EP_FS2 udstilles som beskrevet i afsnit Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration Ingen krav Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade København S CVR Side 32 af 32