Integration Integrationsbeskrivelse - version 3.1.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2015-07-01 EHE 2.0.0 Teknisk beskrivelse godkendt 2015-11-10 EDM 2.1.0 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. 2015-12-01 EHE 3.0.0 Ny major, da det er selvstændig ny version af servicen. 2016-02-08 EDM 3.0.1 Opdateret vilkår og forudsætninger i 1.5, 2.x.3 og 4.1.2. 2016-02-10 EDM 3.0.2 Tilpasset vilkår og forudsætninger i 1.5, 2.x.3, 2.4 og 4.1.2. 2016-06-23 JAND 3.0.3 Forøgelse af læsbarhed. Sproglige korrektioner og omformulering af tvetydige beskrivelser. Tilføjelse af eksempler. 2016-07-13 JJN 3.0.4 Mindre rettelser i vilkår og forudsætninger i 1.5, 2.x.3, 2.4 og 4.1.2. 2016-08-08 EHE 3.1.0 Fejlrettelse: Fjernet Doedsdato fra Personopslag (afsnit 3.1.4). Tilføjet PersonopslagV2 (tilføjet afsnit 3.1.5). Præciseret reference til endpoints samt navngivning på SP. Punkt 1 og 2 har medført opdatering af [WSDL-SP]. Opdatering af [WSDL-EXT] med refererede dokumenter. Fejlrettet databeskrivelse i afsnit 3.1.4, så den afspejler den wsdl der blev udmeldt ultimo 2015. Referencer Ref Titel Kommentarer [SPref] [STS-Sikkerhed] [WSDL-SP] [WSDL-EXT] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: https://share-komm.kombit.dk/p089/referencedokumenter Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Integrationsbeskrivelsen refererer til SF1520 Teknisk Spec 20160808.zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Integrationsbeskrivelsen refererer til SF1520 Bilag 20160808.zip som bl.a. indeholder WSDL af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 57
[SOLR] [Myndighed- Kommunekode] [MYN-REG] [GVF] Apache SOLR dokumentation og query syntaks. http://wiki.apache.org/solr/frontpage DDD0032 Solr Service og IFS0004 CPR Query Service (Solr) vedlagt i [WSDL-EXT] Oversættelsestabel mellem Myndigheders CVRnumre og Kommunekode. CPRs myndighedsregister, som er beskrevet i udtr_ksbeskrivelse_myndighedsregister.pdf Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Generelle vilkår og forudsætninger De to supplerende dokumenter om den aktuelle feltimplementering i SOLR er placeret i [WSDL-EXT] Er placeret i [WSDL-EXT] Er placeret i [WSDL-EXT] 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... 8 1.4 Teststrategi... 10 1.5 Tilslutning af services... 10 2 Kontekst for integrationsparter... 12 2.1 Kontekst for KY... 12 2.2 Kontekst for KSD... 13 2.3 Kontekst for SAPA... 15 2.4 Kontekst for CPR... 16 3 Specifikation for integrationsparter... 18 3.1 Specifikation af endpoints for Fagsystemer(n)... 18 3.2 Specifikation af endpoints for CPR... 40 4 Beskrivelse for integrationsplatforme... 46 4.1 Beskrivelse for Serviceplatformen... 46 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 57
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 Integration er indrettet så Serviceplatformen vedligeholder en lokal kopi af data fra CPR Registret, CPR vej og CPR Myndighedsregister. Dagligt og periodisk modtager Serviceplatformen ændringer til disse data fra CPR. Ændringerne bliver dels brugt til at generere CPR-ændringsbeskeder, som udsendes via en anden snitflade (SF1320), og de bliver dels brugt til at opdatere det lokale replika, som anvendersystemerne kan hente information fra via snitfladen. CPR udstiller et ændringsudtræk for personer en gang i døgnet. Serviceplatformen henter dagligt overførslen og opdaterer det lokale replika. CPR Vej udstiller ligeledes et udtræk for vej og distriktsinformation på CPRs hjemmeside. På CPRs hjemmeside udstiller CPR Vej udstiller et udtræk for vej og distriktsinformation. Serviceplatformen henter periodisk udtrækket, og opdaterer replikaet med distriktsinformation (månedsvis). Bemærk! Når CPR Vej udfases skal der benyttes en eller flere kilder. Dette er pt. ikke i scope for denne snitflade. Slutteligt udstiller CPR Myndighedsregister også et udtræk på CPRs hjemmeside. Serviceplatformen henter ligeledes periodisk udtrækket, og opdaterer replikaet med myndighedsinformation (kvartalsvis). For både vej og myndighedsregister adviserer CPR gennem et nyhedsbrev, når der er nye versioner. Serviceplatformen videreformidler denne information ved hjælp af to søgeservices, der stilles til rådighed for anvendersystemerne. Personliste som kan fremsøge lister af personer på baggrund af en forespørgselsstreng baseret på Apache SOLR med udvalgte parametre såsom navn, fødselsdato, samt angivelse af myndighed (CVR-nr for kommune). Personopslag via personnummer som returnerer samtlige CPR-oplysninger om personen, adresse og familie. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 57
KY 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 IF06 PersonopslagV2 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 57
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 IF06 PersonopslagV2 Anvendersystem (KY,KSD,SAPA) Forespørg Personliste Modtag Personliste Forespørg Personopslag Modtag Personopslag Forespørg Personopslag Modtag Personopslag Serviceplatformen Modtag forespørgsel Udstil data Modtag forespørgsel Udstil data Modtag forespørgsel Udstil data KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 57
1.2.1 Ændringer ift. eksisterende snitflade Serviceplatformen udstiller allerede andre services fra et CPR-replika på serviceplatformen, som ikke er beskrevet i dette dokument. Disse services bibeholdes uden ændringer. Derudover vil den eksisterende funktionalitet til opdatering af CPR replikaet blive genbrugt på til de nye services. I forhold til denne snitflade så skal der tilføjes to yderligere replika opdateringer samt tre nye services til forespørgsel på de hentede data: CPR-Vej Replika opdatering CPR Myndighed Replika opdatering Personopslag-service Personopslag-serviceV2 Personliste-service CPR-Vej replikaet vil komme til at 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. Herudover implementeres følgende ændringer: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 57
CPR Replika. Replikaet eller forespørgsler udvides med myndigheden (CVR-nummer) og 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, hvilket sker kvartalsvis. CPR Vej Replika. Der udarbejdes et CPR Vej replika som indeholder adresser og alle distrikter. CPR-vej hentes fra CPRs hjemmeside og opdateres, når CPR oplyser via nyhedsbrev, at der er opdateringer, hvilket sker månedligt. Også her skal replikaet udvides med myndighed (CVR_nummer) sammen med kommunekode. Personopslag service. Der udarbejdes en Personopslag service, som kan levere samtlige CPR data fra replikaet, som findes på en person, herunder stamdata, adresse, familieoplysninger, adressehistorik og distriktsinformation. Personer slås op via CPR nummer. Personopslag servicev2. Der udarbejdes en Personopslag service, som kan levere samtlige CPR data fra replikaet, som findes på en person, herunder stamdata, adresse, familieoplysninger, adressehistorik og distriktsinformation. Personer slås op via CPR nummer. Personliste service. Der udarbejdes en Personliste service, der er mere fleksibel end den, der i dag findes på Serviceplatformen ved navn ADRSOG1, jf.: (https://www.serviceplatfor- men.dk/administration/serviceoverview/show?uuid=d0361006-6891-11e3-9ed6- e376a4d43aa6). Den generiske Personliste udvides fra ADRSOG1 til at kunne 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 ét væsentligt parameter er krævet. I stedet for kommunekode så skal CVR nummer på kommunen som hovedregel angives. Den nye søgeservice vil blive baseret på Apache SOLR, og kaldes med SOLR query streng som parameter i stedet for en fast liste af parametre. Den nye version vil derfor være væsentligt mere fleksibel. 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. 1.3 Servicebetingelser for den samlede integration Personliste og Personopslag er replika-integrationer, som benytter Serviceplatformens lokale kopi af CPR-data. 1.3.1 Servicemål Parameter Personliste Personopslag/PersonopslagV2 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 57
Tidsrum Svartid 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 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 Tilgængelighed Spidsbelastningsperiode Servicevinduer 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. 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 57
06:00. Varsling 1. måned, varighed max 8 timer [SPref]. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. 1.3.2 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: https://share-komm.kombit.dk/p089/ 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 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 unittests. 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 unittests. 1.4.1.2 Testdata Behov fra bestillere pt. ukendt. 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 1.5 Tilslutning af services For at kunne anvende snitfladen er der en række vilkår og forudsætninger, som skal være opfyldt af tilslutningsparterne, hvilket vil sige kildesystemet og anvendersystemerne. Disse er opdelt i generelle vilkår og forudsætning, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger, som gælder tilslutning til selve snitfladen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 57
De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter der skal udføreres som forudsætning for tilslutning af en tilslutningspart er beskrevet for hver enkelt tilslutningspart i kapitel 2 1.5.1 Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen af et anvendersystem inden for KOMBIT rammearkitektur under monopolbrudsprojektet. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge af den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssig kan udføres i. 1.5.2 Supplerende information om tilslutning Intet. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 57
2 Kontekst for integrationsparter 2.1 Kontekst for KY 2.1.1 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. 2.1.2 Kapacitets- og servicekrav KY forventes at foretage 44.000-50.000 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. 2.1.3 Tilslutning til Snitflade for KY Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID TS101 Aktivitet Opgavekategori Aftale Komponent Ansvarlig Udførende Fase og afhængighed Indgåelse af Dataudvekslingsaftale Serviceplatformen Kommentar Kommune KOMBIT Fase 1 Aftale gælder også SF1320_A version 2 og 3, og er indgået af KOM- BIT på vegne af kommunerne TS102 Anmodning om serviceaftale for snitflade SF1520 Konfiguration Administrationsmodul Leverandør af Anvendersystem Leverandør af Anvendersystem Fase 2.2 Refereres til samme aftale som TS201, TS301 og TS401 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 57
TS103 version 2. Afsendende myndighed skal godkende serviceaftale for snitflade SF1520 version Konfiguration Administrationsmodul Leverandør af Anvendersystem Afsendende Myndighed/Kommune Fase 2.2 TS102, såfremt Afsendelsesmyndighed og Bogføringsansvarlig myndig er forskellige TS101 - Kommuner skal indgå dataudvekslingsaftale med CPR-administrationen under Social- og Indenrigsministeriets departement. KOMBIT har på vegne af kommunerne allerede indgået denne aftale for KY. TS102 - Leverandøren af anvendersystemet skal anmode om indgåelse af serviceaftale på SF1520 version 3, i serviceplatformens administrationsmodul, og kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1520 version 3 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. TS103 - Kommune skal godkende ovenstående serviceaftale. 2.2 Kontekst for KSD 2.2.1 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. 2.2.2 Kapacitets- og servicekrav Der forventes maksimalt 3.000 opslag per måned. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 57
2.2.3 Tilslutning til Snitflade for KSD Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et anvendersystem kan benytte snitfladen. TS201 Aftale Indgåelse af Dataudvekslingsaftale Serviceplatformen Kommune KOMBIT Fase 1 Aftale gælder også SF1320_A version 2 og 3, og er indgået af KOM- BIT på vegne af kommunerne TS202 TS203 Anmodning om serviceaftale for snitflade SF1520 version 2. Afsendende myndighed skal godkende serviceaftale for snitflade SF1520 version Konfiguration Administrationsmodul Leverandør af Anvendersystem Leverandør af Anvendersystem Konfiguration Administrationsmodul Leverandør af Anvendersystem Afsendende Myndighed/Kommune Fase 2.2 Fase 2.2 Refereres til samme aftale som TS101, TS301 og TS401 TS102, såfremt Afsendelsesmyndighed og Bogføringsansvarlig myndig er forskellige TS201 - Kommuner skal indgå dataudvekslingsaftale med CPR-administrationen under Social- og Indenrigsministeriets departement. KOMBIT har på vegne af kommunerne allerede indgået denne aftale for KSD. TS202 - Leverandøren af anvendersystemet skal anmode om indgåelse af serviceaftale på SF1520 version 3, i serviceplatformens administrationsmodul, og kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1520 version 3 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. TS203 - Kommune skal godkende ovenstående serviceaftale. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 57
2.3 Kontekst for SAPA 2.3.1 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. 2.3.2 Kapacitets- og servicekrav Løsningen forventes at foretage 450.000 opslag per dag. 2.3.3 Tilslutning til Snitflade for SAPA Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et anvendersystem kan benytte snitfladen. TS301 Aftale Indgåelse af Dataudvekslingsaftale Serviceplatformen Kommune KOMBIT Fase 1 Aftale gælder også SF1320_A version 2 og 3, og er indgået af KOM- BIT på vegne af kommunerne TS302 Anmodning om serviceaftale for snitflade SF1520 version 2. Konfiguration Administrationsmodul Leverandør af Anvendersystem Leverandør af Anvendersystem Fase 2.2 Refereres til samme aftale som TS101, TS201 og TS401 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 57
TS303 Afsendende myndighed skal godkende serviceaftale for snitflade SF1520 version Konfiguration Administrationsmodul Leverandør af Anvendersystem Afsendende Myndighed/Kommune Fase 2.2 TS102, såfremt Afsendelsesmyndighed og Bogføringsansvarlig myndig er forskellige TS301 - Kommuner skal indgå dataudvekslingsaftale med CPR-administrationen under Social- og Indenrigsministeriets departement. KOMBIT har på vegne af kommunerne allerede indgået denne aftale for KSD. TS302 - Leverandøren af anvendersystemet skal anmode om indgåelse af serviceaftale på SF1520 version 3, i serviceplatformens administrationsmodul, og kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1520 version 3 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. TS303 - Kommune skal godkende ovenstående serviceaftale. 2.4 Kontekst for CPR 2.4.1 Lovhjemmel og forvaltningsmæssigt formål Ikke oplyst af kildesystem. 2.4.2 Kapacitets- og servicekrav Ikke oplyst af kildesystem. 2.4.3 Tilslutning til Snitflade for CPR Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen for CPR, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori TS301 Indgåelse Aftale af Dataudvekslingsaftale Komponent Serviceplatformen Ansvarlig Udførende Fase og afhængighed Kommentar Kommune KOMBIT Fase 1 Aftale gælder også SF1320_A og SF1520 version 3, og er indgået af KOM- BIT på vegne af kommunerne Refereres til samme aftale som TS101, KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 57
TS201 og TS301 TS201 - Kommuner skal indgå dataudvekslingsaftale med CPR-administrationen under Social- og Indenrigsministeriets departement. KOMBIT har på vegne af kommunerne allerede indgået denne aftale for KSD. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 57
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 3.2 3.1 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 Personopslag services til fremsøgning af detaljerede oplysninger på om en specifik borger alene via CPR nummer. 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. 3.1.1 Overordnet forretningslogik Serviceplatformen udstiller en synkron Personliste service (IF04), der udstiller persondata 1. Fagsystemet kalder EP_FS1 Personliste på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet, returformat er angivet i 3.1.3.23.1.3. Serviceplatformen udstiller en synkron Personopslags service (IF05), der udstiller persondata 1. Fagsystemet kalder EP_FS2 Personopslag på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet, returformat er angivet i 3.1.5.2. Serviceplatformen udstiller en synkron Personopslags service V2 (IF06), der udstiller persondata 1. Fagsystemet kalder EP_FS3 Personopslag på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet, returformat er angivet i 3.1.5.2. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 57
3.1.2 Oversigt over endpoints ID Navn EP_FS1 EP_FS2 EP_FS3 Personliste Personopslag PersonopslagV2 3.1.3 Beskrivelse af endpoint EP_FS1 Personliste 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatformen udstiller servicen Personliste. 3.1.3.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.3.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP 1.2 over HTTPS med TLS 1.1 og nyere. 3.1.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger: Reference til WSDL [WSDL-SP] /CPRListe/CPRQueryService.wsdl Operationen hedder callcprpersonlist Serviceplatform oplsyninger Dette endpoint ligger under Servicenavn CPR QueryService 3.1.3.1.5 Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen via web service kald. 3.1.3.1.6 Dataretning for udveksling Serviceplatformen returnerer persondata til Fagsystemet ud fra angivne parametre. 3.1.3.1.7 Service invokation / Triggers Kommunikationen initieres af Fagsystemet, når der ønskes personoplysninger i forbindelse med sagsbehandling og forvaltningsvirksomhed. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 57
3.1.3.2 Dataspecifikation Personliste søgefunktionen (Solr) understøtter samme søgeparametre som ADRSOG1 fra CPR, dog udvidet med fødselsdato. Mindst et parameter af typen navn, fødselsdato, personnummer, vejnavn eller vejkode skal være angivet. 3.1.3.2.1 Inputparametre 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. Se yderligere information SOLR generelt og den specifikke implementering anvendt i denne snitflade under [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 et enkelt parameter som skal være en syntaktisk korrekt formateret SOLR querystring. SOLR understøtter komplekse forespørgsler både i forhold til contraints, fritekst & wildcardsøgninger og søgninger på tværs af flere felter. Anvendersystemet kan også angive, hvor mange resultater der returneres i svaret som en parameter i forespørgslen. Anvendersystemet skal dog selv håndtere paging. Et eksempel på en søgestreg ser således ud: q=*:*&rows=250&deftype=edismax Denne ville blive til følgende request: <ns2:callcprpersonlistrequest xmlns:ns2="http://serviceplatformen.dk/xml/wsdl/soap11/cprqueryservice/1/" xmlns:ns1="http://serviceplatformen.dk/xml/schemas/call- Context/1/"> <!--Optional:--> <ns1:callcontext> <!--You may enter the optional following 3 items in any order--> <ns1:onbehalfofuser>?</ns1:onbehalfofuser> <ns1:callersservicecallidentifier>?</ns1:callersservicecallidentifier> <ns1:accountinginfo>?</ns1:accountinginfo> </ns1:callcontext> <ns2:searchparameter>q=*:*&rows=250&deftype=edismax</ns2:searchparameter> </ns2:callcprpersonlistrequest> Denne tabel viser nogle eksempelforespørgsler, der er brugt i forbindelse med afprøvningen af SOLR, forud for ændringen. Query (as received by the Service platform) Egon AND Olsen&wt=xml&start=0&rows=250&defType=edismax Ivan AND Petersen&wt=xml&start=0&rows=250&defType=edismax Jens AND Jensen&wt=xml&start=0&rows=250&defType=edismax Comment Search on full names Search on full names Search on full names KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 57
Finn AND Larsen AND 251&wt=xml&start=0&rows=250&defType=edismax Jens AND *vej AND 43&wt=xml&start=0&rows=250&defType=edismax *vej AND Ott*&wt=xml&start=0&rows=250&defType=edismax fornavn:jens AND efternavn:jensen&wt=xml&start=0&rows=250&deftype=edismax Jens OR Jensen&wt=xml&start=0&rows=250&defType=edismax Jensen&qf=efternavn^20.0 fornavn^1.0&wt=xml&start=0&rows=250&deftype=edismax Jensen&qf=efternavn^1.0 fornavn^20.0&wt=xml&start=0&rows=250&deftype=edismax Peter AND Hansen&wt=xml&start=250&rows=250&defType=edismax vej* AND *4* OR *A*&timeAllowed=2000&wt=xml&start=250&rows=250&defType=edismax Search on full names Search using wildcards Search using wildcards Search on specific fields (fornavn, efternavn) Search using OR Search where specific fields are valued higher than others are. Here efternavn is valued hith, meaning first hit on this query is persons with efternavn=jensen Search where specific fields are valued higher than others are. Here efternavn is valued hith, meaning first hit on this query is persons with fornavn=jensen Search using paging. Getting rows 250 500 Search with timeallowed, which limits the query time Solr is allowed to use. In this sample set to 2 seconds. 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 Felttype Flerværdifelt Felt i CPR cprnummer string Nej 001:PNR fornavn text_general Nej mellemnavn text_general Nej efternavn text_general Nej fuldenavn text_general Nej 003:ADRNVN foedselsdato string Nej 001:FOED_DT koen text_general Nej 001:KOEN doed boolean Nej vejnavn text_general Nej 002:KOMKOD+002:VEJKOD omsat til vejnavn i CPRvej 001:VEJNVN husnummer text_general Nej 002:HUSNR (format NNNX) husnummerlige boolean Nej CPR-Vej 003:LIGEULIGE (Værdierne L/U) etage string Nej 002:ETAGE sidedoer text_general Nej 002:SIDEDOER standardadresse text_general Nej 003:STANDARDADR postnummer string Nej 002:SIDEDOER by text_general Nej 003:POSTDISTTXT distrikt text_general Ja kommunecvr text_general Nej CVR-nummer på kommune som omsættes til KOMKOD i SP vejkode string Nej 002:VEJKOD KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 57
historiskhusnummer text_general Ja 023:HUSNR+ historiskvejnavn text_general Ja historisketage text_general Ja 023:ETAGE+ historisksidedoer text_general Ja 023:SIDEDOER historiskkomunecvr text_general Ja 023:KOMKOD+ historiskvejkode string Ja 023:VEJKOD+ 3.1.3.2.2 Outputparametre Output data har følgende felter fra CPR replika: Feltnavn i SOLR Feltnavn i CPR Kommentar antal SOLR antal Resultat i antal fundet i søgning. gaeldendepersonnummer 001:PNR fornavn 008:FORNVN Fornavne urn:oio.cpr-nr:xxxxxxxxxx mellemnavn 008:MELNVN mellemnavne efternavn 008:EFTERNVN efternavne adrnavn vejnavn husnummer etage sidedoer bynavn postnummer postdistrikt navn nummer kode 008:ADRNVN 003:STANDARDADR 003:BYNVN 003:POSTNR 003:POSTDISTTXT Opslag i myndighed med 003:KOM- KOD eller CVR CVR-nummer fra 003:KOMKOD 003:KOMKOD Et samlet adressefelt, som indeholder Vejnavn, husnummer, etage og side/dør Kommunens navn status 001:STATUS Status på personen i CPR: 01 = Aktiv, bopæl i dansk folkeregister 03 = Aktiv, speciel vejkode (9900-9999) i dansk folkeregister 05 = Aktiv, bopæl i grønlandsk folkeregister 07 = Aktiv, speciel vejkode (9900-9999) 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 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 57
kontaktadr1 kontaktadr2 Kontaktadr3 Kontaktadr4 Kontaktadr5 adressebeskyttelse 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-BESKYTTELSE 004:SLET_DT-BESKYTTELSE 60 = Inaktiv, ændret personnummer ved ændring af fødselsdato og køn 70 = Inaktiv, forsvundet 80 = Inaktiv, udrejst 90 = Inaktiv, død True / false Selve svaret kan f.eks. se således ud: <n1:antal>0</n1:antal> <n1:person> <n1:gaeldendepersonnummer>a</n1:gaeldendepersonnummer> <n1:navn> <n1:fornavn>string</n1:fornavn> <n1:mellemnavn>string</n1:mellemnavn> <n1:efternavn>string</n1:efternavn> <n1:adrnavn>string</n1:adrnavn> </n1:navn> <n1:adresse> <n1:vejnavn>string</n1:vejnavn> <n1:husnummer>string</n1:husnummer> <n1:etage>string</n1:etage> <n1:sidedoer>string</n1:sidedoer> <n1:postnummer>string</n1:postnummer> <n1:bynavn>string</n1:bynavn> <n1:postdistrikt>string</n1:postdistrikt> <n1:kommune> <n1:navn>string</n1:navn> <n1:nummer>0</n1:nummer> <n1:kode>0</n1:kode> </n1:kommune> </n1:adresse> <n1:kontaktadresse> <n1:kontaktadr1>string</n1:kontaktadr1> <n1:kontaktadr2>string</n1:kontaktadr2> <n1:kontaktadr3>string</n1:kontaktadr3> <n1:kontaktadr4>string</n1:kontaktadr4> <n1:kontaktadr5>string</n1:kontaktadr5> </n1:kontaktadresse> <n1:status>30</n1:status> <n1:adressebeskyttelse>true</n1:adressebeskyttelse> </n1:person> KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 57
3.1.3.3 Sikkerhed Personliste udstilles med rammearkitekturens tokenbaserede sikkerhedsmodel. 3.1.3.4 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. 3.1.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.3.5.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 57
3.1.4 Beskrivelse af endpoint EP_FS2 Personopslag 3.1.4.1 Transportspecifikation 3.1.4.1.1 Serviceudstiller Serviceplatformen udstiller servicen Personopslag. 3.1.4.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.4.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP 1.2 over HTTPS med TLS 1.1 og nyere. 3.1.4.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger: Miljø: URI til WSDL [WSDL-SP] /CPROpslag/CPRInformationService.wsdl Operationen hedder callcprpersonlookup Serviceplatform oplsyninger Dette endpoint ligger under Servicenavn Udvidet person stamdata (lokal) 3.1.4.1.5 Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen via web service kald. 3.1.4.1.6 Dataretning for udveksling Serviceplatformen returnerer persondata til Fagsystemet ud fra et personnummer. 3.1.4.1.7 Service invokation / Triggers Kommunikationen initieres af Fagsystemet, når der ønskes personoplysninger i forbindelse med sagsbehandling og forvaltningsvirksomhed. 3.1.4.2 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: Feltnavn Record:Feltnavn i CPR Kommentar KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 57
Navn Fødselsdato GaeldendePersonnumer Fødselsregistreringssted 001:PNRGAELD 008:ADRNVN samt 008:FORNVN 008:MELNVN 008:EFTERNVN 001:FOED_DT 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 Statsborgerskab 010:LANDEKOD omsat til tekst Tekster hentes fra Myndighedsregistret. 010:HAENSTART-STATSBOR- GERSKAB 001:STATUS Børn under 18 år Beregnes (Ja/Nej) Ja/Nej Stilling 001:STILLING Civilstand 012:CIVST U=Ugift, G=Gift, F=Fraskilt, E=Enke/Enkemand, P=Registreret partnerskab, O=Ophævet partnerskab, L=Længstlevende partner, D=Død Civilstandsdato Værge 012:HAENSTART-CIVILSTAND 017:UMYN_RELTYP 017:RELPNR 017:RELADRSAT_RELPNR_TXT 017:RELTXT1 017:RELTXT2 Hvem der er værge for denne borger. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 57
017:RELTXT3 017:RELTXT4 017:RELTXT5 Familieoplysninger Forældremyndighedsoplysninger Adresse Adressebeskyttelse Vejviserbeskyttelse Markedsføringsbeskyttelse 015:PNRMOR/MOR_FOED_DT 015:PNRFAR/FAR_FOED_DT 012:AEGTEPNR/AEGTEFOED_DT 014:PRNBARN x N 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) 004:BESKYTTYPE=1 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE 004:BESKYTTYPE=2 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE 004:BESKYTTYPE=3 Og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Kompleks type som giver CPR eller fødselsdage samt relationstype på familiemedlemmer, som kan være: Ægtefælle, mor, far, barn, andet. 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. Et samlet adressefelt, som indeholder AktuelAdresse, evt. Udrejseoplysninger, Kontaktadresse, Adressehistorik og Distrikter. 3.1.4.3 Sikkerhed Personopslag udstilles med rammearkitekturens tokenbaserede sikkerhedsmodel. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 57
Et fagsystem tilgår altid servicen på vegne af en given myndighed. 3.1.4.4 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. 3.1.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.4.5.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 57
3.1.5 Beskrivelse af endpoint EP_FS3 PersonopslagV2 3.1.5.1 Transportspecifikation 3.1.5.1.1 Serviceudstiller Serviceplatformen udstiller servicen Personopslag. 3.1.5.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.5.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP 1.2 over HTTPS med TLS 1.1 og nyere. 3.1.5.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger: Miljø: URI til WSDL [WSDL-SP] /CPROpslag/CPRInformationServiceV2.wsdl Operationen hedder callcprpersonlookup Serviceplatform oplsyninger Dette endpoint ligger under Servicenavn Udvidet person stamdata (lokal) 3.1.5.1.5 Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen via web service kald. 3.1.5.1.6 Dataretning for udveksling Serviceplatformen returnerer persondata til Fagsystemet ud fra et personnummer. 3.1.5.1.7 Service invokation / Triggers Kommunikationen initieres af Fagsystemet, når der ønskes personoplysninger i forbindelse med sagsbehandling og forvaltningsvirksomhed. 3.1.5.2 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: Feltnavn Recor:Feltnavn i CPR KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 af 57
personnummer gaeldendepersonnummer personadresseringsnavn fornavn mellemnavn efternavn fornavnmarkering mellemnavnmarkering efternavnmarkering (Navnestartdato) dato (Navnestartdato) usikkerhedsmarkering (foedselsdato) dato (foedselsdato) usikkerhedsmarkering 001:PNR 001:PNRGAELD 008:ADRNVN 008:FORNVN 008:MELNVN 008:EFTERNVN 001:FOED_DT foedselsregistreringsstedkode 009:START_MYNKOD-FØDESTED omsat til tekst (001:MYNNVN_XL - langt myndighedsnavn) + 009:MYNTXT-FØDESTED. Tekster hentes fra Myndighedsregistret. foedselsregistreringsstedkodemyndighedsnavn supplerendefoedselsregistreringssted (startdato) dato (startdato) usikkerhedsmarkering (slutdato) dato (slutdato) usikkerhedsmarkering alder koen antalboernunder18 stilling status (statusdato) dato (statusdato) usikkerhedsmarkering separeret (Separationsdato) dato (Separationsdato) usikkerhedsmarkering civilstand 001:SLUT_DT-PERSON Beregnes udfra Dagsdato 001:FOED_DT 001:KOEN Beregnet felt 001:STILLING 001:STATUS 001:STATUSHAENSTART Beregnet felt 013:START_DT-SEPARATION 012:CIVST U=Ugift, G=Gift, F=Fraskilt, E=Enke/Enkemand, P=Registreret partnerskab, O=Ophævet partnerskab, L=Længstlevende partner, D=Død (civilstandsdato) dato (civilstandsdato) usikkerhedsmarkering landekode (statsborgerskabdato) dato (statsborgerskabdato) usikkerhedsmarkering 012:HAENSTART-CIVILSTAND 010:LANDEKOD omsat til tekst. Tekster hentes fra Myndighedsregistret. 010:HAENSTART-STATSBORGERSKAB KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 af 57
landekodemyndighedsnavn (umyndiggoerelse) umyndiggorelserelationtype (umyndiggoerelse) relationpersonnummer (umyndiggoerelse) relationstartdato (umyndiggoerelse) relationvaergenavn (umyndiggoerelse) relationvaergeadressestartdato (umyndiggoerelsestartdato) dato (umyndiggoerelsestartdato) usikkerhedsmarkering umyndiggoerelseslettedato umyndiggjort (umyndiggoerelse) relationtekst1 (umyndiggoerelse) relationtekst2 (umyndiggoerelse) relationtekst3 (umyndiggoerelse) relationtekst4 (umyndiggoerelse) relationtekst5 (forsvindingsdato) dato (forsvindingsdato) usikkerhedsmarkering (adressebeskyttelse) startdato (adressebeskyttelse) slutdato (adressebeskyttelse) beskyttet (vejviserbeskyttelse) startdato (vejviserbeskyttelse) slutdato (vejviserbeskyttelse) beskyttet (markedsfoeringsbeskyttelse) startdato (markedsfoeringsbeskyttelse) slutdato (markedsfoeringsbeskyttelse) beskyttet tilmeldtnemsms tilmeldtdigitalpost (aktueladresse) kommunecvr (aktueladresse) kommunekode (aktueladresse) vejkode (aktueladresse) husnummer (aktueladresse) etage (aktueladresse) sidedoer (aktueladresse) bygningsnummer (aktueladresse) conavn 017:UMYN_RELTYP 017:RELPNR 017:RELADRSAT_RELPNR_TXT. Hvem der er værge for denne borger. 017:START_DT-UMYNDIG 017:SLET_DT-UMYNDIG Beregnet: Dagsdato er i intervallet 017:START_DT-UMYNDIG og 017:SLET_DT-UMYNDIG 017:RELTXT1 017:RELTXT2 017:RELTXT3 017:RELTXT4 017:RELTXT5 Beregnet felt (Ja/nej) - 004:BESKYTTYPE=1 og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Beregnet felt (Ja/nej) - 004:BESKYTTYPE=2 og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Beregnet felt (Ja/nej) - 004:BESKYTTYPE=3 og dato ligger i intervallet 004:START_DT-BESKYTTELSE 004:SLET_DT-BESKYTTELSE Opslag i Digital Post replika (Ja/Nej) Opslag i Digital Post replika (Ja/Nej) CVR-nummer fra 003:KOMKOD 003:KOMKOD 003:VEJKOD 003:HUSNR (Format (000X)) 003:ETAGE 003:SIDEDOER 003:BNR 003:CONVN KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 af 57
(aktueladresse) lokalitet (aktueladresse) bynavn (aktueladresse) postnummer (aktueladresse) postdistrikt (aktueladresse) vejnavn (aktueladresse) standardadresse (aktueladresse) adresseringsnavn (aktueladresse) vejadresseringsnavn (aktueladresse)(tilflytningsdato) dato (aktueladresse)(tilflytningsdato) usikkerhedsmarkering (aktueladresse) adr1-supladr (aktueladresse) adr2-supladr (aktueladresse) adr3-supladr (aktueladresse) adr4-supladr (aktueladresse) adr5-supladr (distrikter) postnummer (distrikter) postdistrikt (distrikter) byfornyelsesdistriktkode (distrikter) byfornyelsesdistrikt (distrikter)(diversedistrikter) distrikttype (distrikter)(diversedistrikter) distrikkode (distrikter)(diversedistrikter) distrikt (distrikter) evakueringsdistriktkode (distrikter) evakueringsdistrikt (distrikter) kirkedistriktkode (distrikter) kirkedistrikt (distrikter) skoledisstriktkode (distrikter) skoledistrikt 003:LOKALITET 003:BYNVN 003:POSTNR 003:POSTDISTTXT CPR-vej 001:VEJNVN 003:STANDARDADR 003:VEJADRNVN 002:TILFLYDTO ADR1-SUPLADR (Angiver militærværnepligt) ADR2-SUPLADR ADR3-SUPLADR ADR4-SUPLADR ADR5-SUPLADR (distrikter) befolkningsdistriktkode CPRvej 011: (distrikter) befolkningsdistrikt CPRvej 011: (distrikter) sognedistriktkode CPRvej 013: (distrikter) sognedistrikt CPRvej 013: (distrikter) socialdistriktkode CPRvej 012: (distrikter) socialdistrikt CPRvej 012: (distrikter) valgdistriktkode CPRvej 014: (distrikter) valgdistrikt CPRvej 014: (distrikter) varmedistriktkode CPRvej 015: (distrikter) varmedistrikt CPRvej 015: udrejselandekode udrejselandekodemyndighedsnavn CPRvej 006: BYFORNYKOD (Opslag i CPRvej med KOMKOD og VEJ- KOD) CPRvej 006: DISTTXT (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 007: DISTTYP (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 007: DIVDISTKOD (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 007: DISTTXT (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 008: EVAKUERKOD (Opslag i CPRvej med KOMKOD og VEJ- KOD) CPRvej 008: DISTTXT (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 009: KIRKEKOD (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 009: DISTTXT (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 010: SKOLEKOD (Opslag i CPRvej med KOMKOD og VEJKOD) CPRvej 010: DISTTXT (Opslag i CPRvej med KOMKOD og VEJKOD) 005:UDR_LANDEKOD KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 af 57