Integration SF CPR online opslag Integrationsbeskrivelse - version 2.1.0

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer EHE Teknisk beskrivelse godkendt EDM Opdateret operation med avanceret søgning samt tilføjelse af CPR Myndighedsregister. Udvidet data for opslag med et par felter for at matche nødvendige data i CPR-hændelsesintegrationen. Der er ikke fjernet felter. Referencer Ref Titel Kommentarer [SPref] [STS-Sikkerhed] [WSDL-SP] [SOLR] Integrationsbeskrivelsen refererer til SF1520 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link [Myndighed- Kommunekode] [MYN-REG] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Apache SOLR dokumentation og query syntaks. Oversættelsestabel mellem Myndigheders CVRnumre og Kommunekode. CPRs myndighedsregister, som er beskrevet i udtr_ksbeskrivelse_myndighedsregister.pdf Er placeret i SF1520 Bilag zip se link Er placeret i SF1520 Bilag zip se link Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi... 9 KOMBIT A/S Halfdansgade København S CVR Side 2 af 42

3 1.5 Tilslutning af services Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Kontekst for SAPA 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 42

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 udvalgte søgekriterier som f.eks. navn eller fødselsdato, som kan kombineret til mere avanceret søgning, samt et detaljeret personopslag inklusive adressehistorik baseret på et personnummer. Følgende fagsystemer anvender denne snitflade på nuværende tidspunkt: 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. Periodiske opdatering, CPR Vej udstiller et udtræk for vej og distriktsinformation gratis på CPRs hjemmeside. CPR Myndighedsregister udstiller også et udtræk på CPRs hjemmeside. Serviceplatformen henter udtrækket, når der kommer opdateringer og opdaterer replikaet med distriktsinformation (månedsvis) eller myndighedsinformation (kvartalsvis). CPR adviserer gennem et nyhedsbrev, når der er nye versioner. 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 en query baseret på Apache SOLR med udvalgte parametre såsom navn, fødselsdato, samt angivelse af myndighed (CVR-nr for kommune). o Personopslag på personnummer som returnerer samtlige CPR-oplysninger om personen, 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 Periodisk opdatering af CPR-Vej IF03 Periodisk opdatering af CPR Myndighedsregister IF04 Personliste IF05 Personopslag KOMBIT A/S Halfdansgade København S CVR Side 4 af 42

5 Serviceplatformen Anvendersystem (KY,KSD,SAPA) CPR Serviceplatformen Integrationsbeskrivelse IF01 Daglig Opdatering af CPR SF1520 IF02 Periodisk Opdatering af CPR Vej IF03 Periodisk Opdatering af CPR Myndighed Dagligt Persister data Periodisk Persister data Periodisk Persister data Hent data Modtag data Hent data Modtag data Hent data Modtag data Udstil Persondata Udstil vej- data Udstil myndighed - data Dagligt Dan udtræk Periodisk Dan udtræk Periodisk Dan udtræk SF1520 IF04 Personliste IF05 Personopslag 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 42

6 1.2.1 Ændringer ift. eksisterende snitflade Serviceplatformen udstiller allerede services fra et CPR-replika på serviceplatformen, som ikke er beskrevet i dette dokument. Disse services bliver videreført uden ændringer. Derfor vil den eksisterende funktionalitet til opdatering af CPR replikaet blive genbrugt på Serviceplatformen. De eksisterende services på Serviceplatformen bliver bibeholdt. I forhold til denne snitflade så skal der tilføjes nye replika opdatering og to nye services: CPR-Vej Replika opdatering CPR Myndighed 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 CPR Myndighedsregister indeholder oplysninger om de enkelte myndigheders navne, adresse og langt myndighedsnavn (benyttes til Fødested), så KOMKOD og MYNKOD kan omsættes til tekster. Følgende skal kendetegne de nye ændringer: KOMBIT A/S Halfdansgade København S CVR Side 6 af 42

7 CPR Replika. Replikaet eller forespørgsler skal udvides med myndigheden (CVR-nummer) sammen med kommunekode på alle CPR data. Opsætningstabellen mellem kommunekode og CVR er vist i [Myndighed-Kommunekode]. CPR Myndighedsregister. Et replika af CPRs Myndighedsregister [MYN-REG] etableres på Serviceplatformen til opslag af myndigheders navn og fødested (langt navn). Myndighedsregisteret hentes på CPRs hjemmeside. Replikaet opdateres, når CPR oplyser via nyhedsbrev, at der er opdateringer (kvartalsvis). CPR Vej Replika. Der skal udarbejdes en CPR Vej replika som indeholder adresser og alle distrikter. CPR-vej downloades fra CPRs hjemmeside, hvorefter CPR-Vej replikaet skal etableres. Replikaet opdateres, når CPR oplyser via nyhedsbrev, at der er opdateringer (månedlig). Også her skal replikaet udvides med myndighed (CVR_nummer) sammen med kommunekode. Personopslag-service. Der skal udarbejdes en Personopslag service, der datamæssigt rummer en persons samtlige stamdata, adresse, familieoplysninger, adressehistorik samt distriktsinformation, så den afspejler samtlige data i CPR replikaet. 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.: ( Den generiske Personliste skal udvides fra ADRSOG1 til at søge på CPR, Navn, Fødselsdato, Køn, Adresse, Vejnavn, Interval af husnumre, Husnumre, Etage, Side/dørnummer, Postnummer, By, Distrikt, Kommune, Vejkode samt Historisk adresse søgning. 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 som hovedregel angives. Den nye søge service vil blive baseret på Apache SOLR og kaldes med SOLR query streng. Dette giver en stor fleksibilitet i søgningen, og kan ifølge SSE svare med rimelige svartider. 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. [Det skal være muligt at få status på den daglige og periodiske opdateringer af replika. Enten ved udstillelse online eller programmatisk. 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, CPR-Vej og CPR Myndighedsregister på den nemmeste måde.] 1.3 Servicebetingelser for den samlede integration Personliste og Personopslag er replika-integrationer, som benytter Serviceplatformens lokale kopi af CPR-data Servicemål Parameter Personliste Personopslag KOMBIT A/S Halfdansgade København S CVR Side 7 af 42

8 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [svartid er under afklaring] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. 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. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [svartid er under afklaring] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. 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. KOMBIT A/S Halfdansgade København S CVR Side 8 af 42

9 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. 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 SPTest@kombit.dk. 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. 1.4 Teststrategi 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 unittests Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests Testdata [KDF: Udfyldes når behov fra bestiller er fastlagt] 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 1.5 Tilslutning af services 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 KOMBIT A/S Halfdansgade København S CVR Side 9 af 42

10 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] Funktionalitet på Serviceplatformen 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]. 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 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] Generelle forhold for tilslutning til integrationspart: CPR Der er en eksisterende indgået aftale med CPR omkring de daglige opdateringer med CPR ændringer. De to nye replika, CPR-vej og CPR Myndighed, er baseret på gratis download fra CPRs hjemmeside. CPR informerer om gratis data via nyhedsbrev. Der bliver hver måned lagt et nyt vejregister på CPR s hjemmeside og myndighedsregisteret bliver opdateret hver kvartal. Når hjemmesiden er opdateret med vejregister og myndighedsregister, bliver der sendt et nyhedsbrev ud om dette. Tilmelding til nyhedsbrev findes her: KOMBIT A/S Halfdansgade København S CVR Side 10 af 42

11 2 Kontekst for integrationsparter 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 Kapacitets- og servicekrav Der forventes maksimalt opslag per måned Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 11 af 42

12 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. KOMBIT A/S Halfdansgade København S CVR Side 12 af 42

13 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 persondata, hvor CPR-Vej og CPR Myndighedsregister hentes på CPRs hjemmeside ved ændringer 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 13 af 42

14 3.1.3 Beskrivelse af endpoint EP_FS1 Personliste Transportspecifikation 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 Endpoint IP [WSDL-SP] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] 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 understøtter samme input parametre som ADRSOG1 fra CPR, og udvides med fødselsdato. Mindst en parameter af typerne navn, fødselsdato, personnummer, vejnavn eller vejkode skal være angivet. KOMBIT A/S Halfdansgade København S CVR Side 14 af 42

15 Der benyttes en query løsning baseret på Apache SOLR, som giver stor fleksibilitet i forhold til at sammenstille og vægte parametre i søgningen [SOLR]. Søgningen understøtter fleksibel søgning på kombinationer af CPR, Navn, Fødselsdato, Køn, Adresse, Vejnavn, Interval af husnumre, Husnumre, Etage, Side/dørnummer, Postnummer, By, Distrikt, Kommune, Vejkode samt Historisk adresser. Enkeltfelter at kunne angive flere værdier, samt om det søgningen skal matche alle eller nogle af værdierne (AND/OR). Der kan angives wildcards i søgningen (? og *), ligesom man kan angive hvilken kolonne søgeresultatet skal sorteres efter. Fagsystemerne kalder PersonListe med en SOLR-query streng, som indeholder korrekt SOLRsyntaks [SOLR]. Fagsystemet kan selv angive, hvor mange resultater der returneres i svaret som en parameter i requesten. Fagsystemerne skal selv håndtere paginering. Nedenstående tabel indeholder de SOLR søgefelter, der kan søges på. Tabellen viser også hvor data hentes i CPR (jf. [MYN-REG]). Feltnavn i SOLR Feltnavn i CPR Kommentar CPR 001:PNR (pnr - urn:oio.cprnr:xxxxxxxxxx) Man skal kunne søge på dele af CPR-nummeret, dvs. anvende trunkering og maskering. Navn 003:ADRNVN Fælles søgefelt for alle navndele dvs. fornavne, mellemnavne og efternavne. Fritekstsøgning på dele af navnet. Fødselsdato 001:FOED_DT Køn 001:KOEN Mand eller kvinde. Adresse 003:STANDARDADR Et samlet adressefelt, som indeholder Vejnavn, husnummer, etage og side/dør Fritekstsøgning på dele af adressen. Vejnavn Interval af husnumre 002:KOMKOD+002:VEJKOD omsat til vejnavn i CPRvej 001:VEJNVN 002:HUSNR (format NNNX) Fritekstsøgning på dele af vejnavnet. Et fra og til husnummer, som også kan håndtere bogstaver dvs. hvis man skriver fra 5C til 7H, så skal både 5E, 6B og 7A findes, men ikke 5A og ikke 7J. KOMBIT A/S Halfdansgade København S CVR Side 15 af 42

16 Husnumre Etage CPR-Vej 003:LIGEULIGE (Værdierne L/U) 002:ETAGE Og hvis man søger på husnummer 5 til 7 så får man også 5A, 5B mv. Angivelse af, om der søges på lige eller ulige husnumre. Side/dørnummer 002:SIDEDOER Fritekstsøgning så man kan skrive tv uden at vide, at der i feltet står tv. Postnummer 003:POSTNR By 003:POSTDISTTXT Mulighed for at søge på tværs af postnumre. Fx hvis jeg angiver bynavnet Vejle så skal man både finde borgere i 7100 Vejle og 7120 Vejle Ø Distrikt CPR-Vej har følgende distrikttyper: Byfornyelse 006: Diverse 007: Evakuer 008 Kirke 009: Skole 010: Befolk 011: Social 012: Sogne 013: Valg 014: Varme 015: Kommune CVR-nummer på kommune som omsættes til KOMKOD i SP Vejkode 002:VEJKOD Historisk søgning STANDARDADR ikke findes i historik 023 så der benyttes 023:KOMKOD+ 023:VEJKOD+ 023:HUSNR+ 023:ETAGE+ Fritekstsøgning på dele af bynavnet. Kommune skal vælges før man kan søge på distrikter, fordi distrikterne anvendes forskelligt fra kommune til kommune. SAPA sender: CVR for kommunen Distrikttype Distriktskode Fritekstfelt Søgningen foregår ud fra nuværende kommunenavne (nuværende kommuneinddeling) Søgning på historisk adresser. En markering af, at brugeren også ønsker at søge i historiske folkeregister registreringer dvs. at de borgere, som tidligere har boet på den søgte adresse. Søgningen foregår KOMBIT A/S Halfdansgade København S CVR Side 16 af 42

17 023:SIDEDOER på det nuværende og det historiske vejnavn mens resultat viser det nuværende vejnavn. Historisk søgning kan kun foretages på adressesøgninger på enkeltfelter og dermed ikke på feltet STAN- DARDADR. [Eksempler på SOLR-requests tilgår] Output data har følgende felter fra CPR replika: Feltnavn i SOLR/ Feltnavn i CPR/SOLR Kommentar CPR-replika Antal SOLR antal Resultat i antal fundet i søgning. CPR 001:PNR urn:oio.cpr-nr:xxxxxxxxxx Navn 008:ADRNVN samt 008:FORNVN 008:MELNVN 008:EFTERNVN Adresse 003:STANDARDADR Et samlet adressefelt, som indeholder Vejnavn, husnummer, etage og side/dør By 003:BYNVN Postnummer 003:POSTNR Postdistrikt 003:POSTDISTTXT Kommune Opslag i myndighed med 003:KOMKOD eller CVR Kommunens navn Fornavne, mellemnavne og efternavne. Kommunenummer Kommunekode Status CVR-nummer fra 003:KOMKOD 003:KOMKOD 001:STATUS 01 = Aktiv, bopæl i dansk folkeregister 03 = Aktiv, speciel vejkode ( ) i dansk folkeregister Status på personen i CPR i klartekst (ikke en kode). KOMBIT A/S Halfdansgade København S CVR Side 17 af 42

18 Kontaktadresse Adressebeskyttelse 05 = Aktiv, bopæl i grønlandsk folkeregister 07 = Aktiv, speciel vejkode ( ) i grønlandsk folkeregister 20 = Inaktiv, uden bopæl i dansk/grønlandsk folkeregister men tildelt personnummer af skattehensyn (kommunekoderne 0010, 0011, 0012 og 0019) 30 = Inaktiv, annulleret personnummer 50 = Inaktiv, slettet personnummer ved dobbeltnummer 60 = Inaktiv, ændret personnummer ved ændring af fødselsdato og køn 70 = Inaktiv, forsvundet 80 = Inaktiv, udrejst 90 = Inaktiv, død 006:ADR1-KONTAKTADR 006:ADR2-KONTAKTADR 006:ADR3-KONTAKTADR 006:ADR4-KONTAKTADR 006:ADR5-KONTAKTADR 004:BESKYTTYPE=1 Og dato ligger i intervallet 004:START_DT-BESKYT- TELSE 004:SLET_DT- BESKYTTELSE Ja/Nej Servicen levere én bolean værdi eller lignende tilbage Sikkerhed Personliste skal udstilles som beskrevet i afsnit KOMBIT A/S Halfdansgade København S CVR Side 18 af 42

19 Leverancesikkerhed og fejlhåndtering Servicen er udstillet fra Serviceplatformen, hvor der benyttes replika fra CPR. SOLR løsningen håndterer at levere svaret i aftalt format. 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 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 Servicevinduer 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]. 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]. KOMBIT A/S Halfdansgade København S CVR Side 19 af 42

20 3.1.4 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ø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] 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: KOMBIT A/S Halfdansgade København S CVR Side 20 af 42

21 Nøgle PNR Beskrivelse Personnummer - urn:oio.cpr-nr:xxxxxxxxxx Output data skal have følgende felter fra CPR replika: Feltnavn Record:Feltnavn i CPR Kommentar CPR 001:PNR urn:oio.cpr-nr:xxxxxxxxxx Navn Fødselsdato Døddato GaeldendePersonnumer Fødselsregistreringssted 001:PNRGAELD 008:ADRNVN samt 008:FORNVN 008:MELNVN 008:EFTERNVN 001:FOED_DT 001:SLUT_DT-PERSON 009:START_MYNKOD-FØDESTED omsat til tekst (001:MYNNVN_XL - langt myndighedsnavn) + 009:MYNTXT-FØDESTED urn:oio.cpr-nr:xxxxxxxxxx Tekster hentes fra Myndighedsregistret. Køn 001:KOEN Mand eller kvinde Alder Beregnes Dagsdato 001:FOED_DT Statsborgerskabsdato Status Statusdato Statsborgerskab 010:LANDEKOD omsat til tekst Tekster hentes fra Myndighedsregistret. 010:HAENSTART-STATSBOR- GERSKAB 001:STATUS 001:STATUSHAENSTART Børn under 18 år Beregnes Antal Stilling 001:STILLING Civilstand 012:CIVST U=Ugift, G=Gift, F=Fraskilt, E=Enke/Enkemand, P=Regi- KOMBIT A/S Halfdansgade København S CVR Side 21 af 42

22 streret partnerskab, O=Ophævet partnerskab, L=Længstlevende partner, D=Død Civilstandsdato Umyndiggjort 012:HAENSTART-CIVILSTAND Dagsdato i intervallet Værge Familieoplysninger 017:START_DT-UMYNDIG 017:SLET_DT-UMYNDIG 017:UMYN_RELTYP 017:RELPNR 017:RELADRSAT_RELPNR_TXT 017:RELTXT1 017:RELTXT2 017:RELTXT3 017:RELTXT4 017:RELTXT5 015:PNRMOR/MOR_FOED_DT 015:PNRFAR/FAR_FOED_DT 012:AEGTEPNR/AEGTEFOED_DT 014:PRNBARN x N Hvem der er værge for denne borger. Kompleks type som giver CPR eller fødselsdage samt relationstype på familiemedlemmer, som kan være: Ægtefælle, mor, far, barn, andet. Separeret 013:START_DT-SEPARATION Ja/nej Forældremyndighedsoplysninger 016:RELTYP-FORÆLDREMYN angiver ved 0003 = mor (015:PNR- MOR/MOR_FOED_DT) og ved 0004 = far (015:PNR- FAR/FAR_FOED_DT) og ved 005 = anden indehaver 1 og ved 006 = anden indehaver 2 (016:RELPNR) Angiver gældende forældremyndighedsoplysninger for personen, liste af personers CPR eller fødselsdato såfremt de ikke har CPR Der kan være flere med forældremyndighed og alle medtages. Fritaget for digital post Opslag i Digital Post replika Ja/nej c/o navn 003:CONVN KOMBIT A/S Halfdansgade København S CVR Side 22 af 42

23 Adresse 003:STANDARDADR Et samlet adressefelt, som indeholder Vejnavn, husnummer, etage og side/dør Lokation By Postnummer Postdistrikt Kommune Kommunekode Vejkode Vejnavn Vejadresseringsnavn 003:LOKALITET 003:BYNVN 003:POSTNR 003:POSTDISTTXT CVR-nummer fra 003:KOMKOD 003:KOMKOD 003:VEJKOD CPR-vej 001:VEJNVN 003:VEJADRNVN Husnummer 003:HUSNR Format (000X) Etage Sidedør Bygningsnummer 003:ETAGE 003:SIDEDOER 003:BNR Fraflytningsdato 002:FRAFLYKOMDTO Fraflytningsdato kommune Adressebeskyttelse 004:BESKYTTYPE=1 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Vejviserbeskyttelse 004:BESKYTTYPE=2 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Tilflytningsdato 002:TILFLYDTO Tilflytningsdatoen for hovedadressen. Markedsføringsbeskyttelse 004:BESKYTTYPE=3 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE KOMBIT A/S Halfdansgade København S CVR Side 23 af 42

24 Kontaktadresse Supplerende adresse Udlandsadresse Land 006:ADR1-KONTAKTADR 006:ADR2-KONTAKTADR 006:ADR3-KONTAKTADR 006:ADR4-KONTAKTADR 006:ADR5-KONTAKTADR ADR1-SUPLADR ADR2-SUPLADR ADR3-SUPLADR ADR4-SUPLADR ADR5-SUPLADR 005:UDLANDADR1 005:UDLANDADR2 005:UDLANDADR3 005:UDLANDADR4 005:UDLANDADR5 005:UDR_LANDEKOD Omsættes til tekst fra Myndighedsregistret Den fulde kontaktadresse inkl følgende felter: vejnavn, husnummer, etage, side/dør, postnummer og by. (Angives kun ved status 20, 30, 70, 80 og 90) Angiver militærværnepligt Enten Danmark eller det land som borgeren er flyttet til i klar tekst i forbindelse med en udenlandsadresse. Historisk adresse 023: KOMKOD, KommuneCVR, VEJ- KOD, HUSNR, ETAGE, SIDEDOER, BNR, CONVN, TIL- FLYDTO, TILFLYDTO samt CPR- Vej VEJNVN Kompleks type med de historiske adresse data Kommunalt notat 019:NOTATNR 019:NOTATLINIE 019:START_DT-NOTAT 019:SLET_DT-NOTAT Der findes flere linjer. Dvs. vi får et antal linjer tilbage med jeres nummer tilknyttet. Fx indeholder linje 3 og 4 en angivelse af fængselsadresse. Byfornyelsesdistrikt CPRvej 006: Opslag i CPRvej med KOM- KOD og VEJKOD med check KOMBIT A/S Halfdansgade København S CVR Side 24 af 42

25 BYFORNYKOD DISTTXT Evakueringsdistrikt CPRvej 008: EVAKUERKOD DISTTXT Kirkedistrikt CPRvej 009: KIRKEKOD DISTTXT Skoledistrikt CPRvej 010: SKOLEKOD DISTTXT på LIGEULIGE og HUSNR- FRA og HUSNRTIL Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Befolkningsdistrikt CPRvej 011: Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Socialdistrikt CPRvej 012: Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Sognedistrikt CPRvej 013: Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Valgdistrikt CPRvej 014: Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Varmedistrikt CPRvej 015: Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL Diverse distrikter CPRvej 007: DISTTYP DIVDISTKOD Opslag i CPRvej med KOM- KOD og VEJKOD med check på LIGEULIGE og HUSNR- FRA og HUSNRTIL. Kom- DISTTXT KOMBIT A/S Halfdansgade København S CVR Side 25 af 42

26 pleks type vi mangler information om, hvad vi kan forvente af finde her. (der er op til 49 og de benyttes forskelligt fra kommune til kommune) 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 26 af 42

27 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 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 SPTest@kombit.dk. 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 Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. 3.2 Specifikation af endpoints for CPR CPR benyttes til at hente alle ændringer til personer i CPR registret via et ændringsudtræk samt hente nye versioner af CPR-Vej (månedsvis) og CPR Myndighedsregister (kvartalsvis). CPR-Vej og CPR Myndighedsregister hentes fra CPRs hjemmeside Overordnet forretningslogik CPR udstiller hvert døgn en batch fil med ændringer til personer i CPR registret. CPR-Vej udstiller en ny version en gang om måneden, og dette annonceres i CPRs nyhedsbrev. Tilsvarende bliver CPR Myndighedsregister udstillet i en ny version en gang i kvartalet. KOMBIT A/S Halfdansgade København S CVR Side 27 af 42

28 Serviceplatformen henter alle udtræk og opdaterer det lokale replika på Serviceplatformen Oversigt over endpoints ID Navn EP_CPR1 EP_CPR2 EP_CPR3 Udstilling af ændringsudtræk for CPR personer Udstilling af ændringsudtræk for CPR-Vej Udstilling af ændringsudtræk for CPR Myndighedsregister 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 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 ftp.cpr.dk port 2222 IP [Afklaring/KDF oplysninger leveres af Systematic] SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test Host ftp-demo.cpr.dk port 2222 IP [Afklaring/KDF oplysninger leveres af Systematic] SFTP bruger: [Afklaring/KDF oplysninger leveres af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CPR FTP site. KOMBIT A/S Halfdansgade København S CVR Side 28 af 42

29 Dataretning for udveksling CPR udstiller ændringer i personer til Serviceplatformen Service invokation / Triggers Ændringsudtrækket genereres hvert døgn Dataspecifikation Filen er i fast record 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-08. Der skal benyttes et *.cpr.dk certifikat, som kan hentes på CPRs hjemmeside, i både produktionsog testmiljø Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere fejl og ændringer svarende til den nuværende løsning, hvor der opbygges en ny version af replika ved hver opdatering, og ved fejl går man tilbage til den tidligere version 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 CPR-systemet er til rådighed 24 timer i døgnet, 7 dage om ugen. Ikke oplyst Batch-leverancer afvikles på hverdage mandag til fredag i tidsrummet efter kl , undtagen 5/6, 24/12 og 31/12. Derudover kan særlige batch-opgaver afvikles efter aftale. Ikke oplyst Med henblik på service og vedlige- holdelse m.v. kan der forekomme nedlukninger - normalt i weekenden - på nogle timers varighed. Tidspunkter for nedlukninger offentliggøres på og på CPR-systemets lysavis. KOMBIT A/S Halfdansgade København S CVR Side 29 af 42

30 3.2.4 Beskrivelse af endpoint EP_CPR2 Integration til CPRs CPR-Vej. Denne integration skal etableres og implementeres på Serviceplatformen Transportspecifikation Serviceudstiller CPR udstiller en udtræksfil på deres egen hjemmeside Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er web-baseret download Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion Host-URL IP [Afklaring/KDF oplysninger leveres af Systematic] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test Host-URL IP [Afklaring/KDF oplysninger leveres af Systematic] Teknisk retning for udveksling Serviceplatformen downloader fra CPRs hjemmeside Dataretning for udveksling CPR udstiller CPR-Vej udtræk til Serviceplatformen Service invokation / Triggers Ændringsudtrækket genereres hver måned og annonceres gennem nyhedsbrev Dataspecifikation Filen er i fast record format og returnerer alle CPR-vej records. Record format og indhold er beskrevet på: Sikkerhed Der er ingen sikkerhed, da CPR-vej udtræk stilles gratis til rådighed ved download fra CPRs hjemmeside. KOMBIT A/S Halfdansgade København S CVR Side 30 af 42

31 Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere fejl og ændringer svarende til den nuværende løsning i EP_CPR1. Hvis filen ikke kan hentes fra CPRs hjemmeside skal CPR adviseres, og processen gentages 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 CPR-systemet er til rådighed 24 timer i døgnet, 7 dage om ugen. Ikke oplyst Batch-leverancer afvikles på hverdage mandag til fredag i tidsrummet efter kl , undtagen 5/6, 24/12 og 31/12. Derudover kan særlige batch-opgaver afvikles efter aftale. Ikke oplyst Med henblik på service og vedlige- holdelse m.v. kan der forekomme nedlukninger - normalt i weekenden - på nogle timers varighed. Tidspunkter for nedlukninger offentliggøres på og på CPR-systemets lysavis Beskrivelse af endpoint EP_CPR3 Integration til CPRs Myndighedsregsiter. Denne integration skal etableres og implementeres på Serviceplatformen Transportspecifikation Serviceudstiller CPR udstiller en udtræksfil på deres egen hjemmeside Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er web-baseret download Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion KOMBIT A/S Halfdansgade København S CVR Side 31 af 42

32 Host-URL IP [Afklaring/KDF oplysninger leveres af Systematic] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test Host-URL IP [Afklaring/KDF oplysninger leveres af Systematic] Teknisk retning for udveksling Serviceplatformen downloader fra CPRs hjemmeside Dataretning for udveksling CPR udstiller Myndighedsregister udtræk til Serviceplatformen Service invokation / Triggers Ændringsudtrækket genereres hver måned og annonceres gennem nyhedsbrev Dataspecifikation Filen er i fast record format og returnerer alle CPR-vej records. Record format og indhold er beskrevet på: Sikkerhed Der er ingen sikkerhed, da Myndighedsregister udtræk stilles gratis til rådighed ved download fra CPRs hjemmeside Leverancesikkerhed og fejlhåndtering Serviceplatformen skal håndtere fejl og ændringer svarende til den nuværende løsning i EP_CPR1. Hvis filen ikke kan hentes fra CPRs hjemmeside skal CPR adviseres, og processen gentages Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Værdi CPR-systemet er til rådighed 24 timer i døgnet, 7 dage om ugen. Ikke oplyst Batch-leverancer afvikles på hverdage mandag til fredag i tidsrummet efter kl , undtagen 5/6, 24/12 og 31/12. Derudover kan særlige batch-opgaver afvikles efter aftale. KOMBIT A/S Halfdansgade København S CVR Side 32 af 42

33 Spidsbelastningsperiode Servicevinduer Ikke oplyst Med henblik på service og vedlige- holdelse m.v. kan der forekomme nedlukninger - normalt i weekenden - på nogle timers varighed. Tidspunkter for nedlukninger offentliggøres på og på CPR-systemets lysavis. KOMBIT A/S Halfdansgade København S CVR Side 33 af 42

34 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 EP_CPR1 IF04 IF01 Fagsystem EP_FS1 Replika Persistering IF02 EP_CPR2 CPR EP_FS2 IF05 IF03 EP_CPR Oversigt over integrationsflows ID Navn [IF01] [IF02] [IF03] [IF04] [IF05] Daglig opdatering af CPR. Opdatering af CPR Replika er eksisterende funktionalitet og beskrives ikke yderligere Månedlig opdatering af CPR-Vej. Opdatering af CPR-Vej Replika Kvartalsvis opdatering af CPR Myndighed. Opdatering af CPR Myndighed Replika Personliste Personopslag KOMBIT A/S Halfdansgade København S CVR Side 34 af 42

35 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 35 af 42