Integration Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2015-01-22 PBO 0.1 Første version 2015-03-25 MHO 0.2.1 Opdateret version efter internt review 2015-04-13 EDM 0.2.2 Opdateret med yderligere review kommentarer 2015-04-16 MHO 0.2.3 Gennemskrivning og sammenlægning af afsnit 2015-05-26 MHO 0.3.1 Kommentarer fra KY indarbejdet. Struktur i afsnit om BF ændret til nyt format. 2015-06-04 MHO 2.0.0 Opdatering af afsnit 1.2, volumen og beskedkuvert Referencer Ref. Titel Kommentarer [SPref] [SIKKERHED] Bilag 7B Ydelser og servicemål for Serviceplatformen Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 [STS-Sikkerhed] Integrationsvilkår Bilag 2. Sikkerhed version 1.3 [STS Beskedfordeler] Beskedfordeler kuvert: https://sharekomm.kombit.dk/p024/delte%20dokumenter/u nderbilag%203.a%20beskedkuvert%20version%2 01.3%2018.%20marts%202014.pdf [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeleren [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeleren [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeleren [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeleren [P12-1] [SF1411_A] [SF1411_B] [SF1411_D] [SF1411_E] Integration til KMD Social Pension som specificeret i P12_1_Snitfladebeskrivelse_v008 SF1411_X Integrationsbeskrivelserne for de relaterede integrationer vedr. social pension De fire beskrivelser om social pension er indbyrdes afhængige og skal læses i sammenhæng. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 41
Indholdsfortegnelse 1 Overordnet beskrivelse... 4 1.1 Integrationens formål... 4 1.2 Sammenhæng til andre snitflader... 4 1.3 Overordnet forretningsflow i integrationen... 9 1.4 Servicebetingelser for den samlede integration... 12 1.5 Teststrategi... 13 1.6 Forudsætninger for produktionssætning af integration social pension... 13 2 Kontekst for integrationsparter... 15 2.1 Kontekst for KMD Social Pension Kommunedel [!@KSKP@!]... 15 2.2 Kontekst for Kommunal Pension [!@KP@!]... 15 2.3 Kontekst for Kommunernes Ydelsessystem [!@KY@!]... 16 2.4 Kontekst for KMD Social Pension[!@KS@!]... 17 2.5 Kontekst for UDK Pension [!@UDK@!]... 17 3 Specifikation for integrationsparter... 19 3.1 Specifikation af endpoints for fagsystemerne Kommunal Pension, KY og SP som modtagende beskedagent [!@KP@!][!@KY@!][!@Systematic@!]... 19 3.2 Specifikation af endpoints for UDK Pension og SP som afsendende beskedagent [!@UDK@!][!@Systematic@!]... 20 3.3 Specifikation af endpoints for KMD Social Pension Kommunedel [!@KSKP@!]... 25 3.4 Specifikation af endpoints for KMD Social Pension [!@KS@!]... 29 4 Beskrivelse for integrationsplatforme... 33 4.1 Beskrivelse for Serviceplatformen [!@Systematic@!]... 33 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 41
1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at sende beskeder med ændringer til informationer relateret til social pension for en given person: Tillægsprocent Samliv Formue Brøkpension Afslag på folkepension Oplysninger om udlandsophold over to måneder Beskederne kommer fra pensionssystemerne KMD Social Pension og det kommende UDK Pension. Beskederne vil i en transitionsperiode komme fra begge systemer. Beskederne leveres til fagsystemerne Kommunal Pension, KMD Social Pension Kommunedel samt Kommunernes Ydelsessystem (KY). I forbindelse med monopolbruddet sker der en løbende udskiftning af det nuværende pensionssystem KMD Social Pension. KMD Social Pension består af to dele: KMD Social Pension Kommunedel, som varetager systemunderstøttelsen af de kommunale opgaver, og KMD Social Pension UDK-del, som varetager systemunderstøttelsen af opgaver for UDK. KMD Social Pension erstattes fremadrettet med to nye pensionssystemer, UDK Pension og Kommunal Pension. Ændringer i helbredsprocent er beskrevet i [SF1411_E]. 1.2 Sammenhæng til andre snitflader Dette afsnit giver en introduktion til den samlede løsning for området social pension og sammenhængen mellem integrationerne. Det er en fælles tekst, som går igen i alle fire integrationsbeskrivelser, der omhandler social pension. Følgende integrationsbeskrivelser indgår i gruppen: SF1411_A Hent informationer om social pension [SF1411_A] SF1411_B Hent helbredsprocent [SF1411_B] SF1411_D Besked om informationer om social pension [SF1411_D] SF1411_E Besked om helbredsprocent [SF1411_E] Formålet med gruppen af snitflader er at udveksle informationer om samt ændringer i informationer om social pension (tillægsprocent, helbredsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder). Informationerne udveksles mellem fagsystemer (f.eks. Kommunernes Ydelsessystem herefter KY) og de tre pensionssystemer KMD Social Pension, UDK Pension og Kommunal Pension (andre systemer kan komme til). KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 41
Serviceplatformen samt fag- og pensionssystemernes snitflader til støttesystemet Beskedfordeler (herefter: Beskedfordeler) beskrives i følgende integrationsbeskrivelser: SF1460_A Modtag besked [SF1460_A] SF1460_B Vedligeholde værdiliste i beskedabonnement [SF1460_B] SF1460_C Aflever besked [SF1460_C] SF1460_D Modtag besked via pull [SF1460_D] Målarkitektur Målarkitekturen for den kommende løsning består af pensions- og fagsystemerne UDK Pension, Kommunal Pension og KY, som skal udveksle informationer relateret til social pension. Det er et forretningsmæssigt mål, at snitfladerne mellem systemerne i målarkitekturen understøtter en løbende udfasning af KMD Social Pension. Endvidere er det et forretningsmæssigt mål, at målarkitekturen for integrationerne mellem de kommende systemer bliver løst koblede, således afhængigheder mellem fagsystemer mindskes og udskiftning af systemer bliver mere effektiv fremadrettet. For at sikre løs kobling mellem systemerne, vil målarkitekturen benytte Serviceplatformen som integrationsplatform ved online opslag og det fælleskommunale støttesystem Beskedfordeler som integrationsplatform ved orientering til KY og Kommunal Pension om ændringer i informationer om social pension. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 41
Målarkitekturen for de involverede systemer og deres endpoints for udstillede snitflader er vist på nedenstående figur: Beskedfordeler SF1411_D SF1411_E Opdater værdiliste SF1411_D Modtag besked om tillægsprocent SF1411_E Send besked om helbredsprocent SF1411_D Send besked med informationer om social pension SF1411_E Modtag besked om helbredsprocent SF1411_D Modtag besked om samliv og formue SF1411_D SF1411_E Opdater værdiliste Kommunal Pension UDK Pension KY SF1411_B Udstil helbredsprocent SF1411_A Hent tillægsprocent, samliv og formue SF1411_A Udstil informationer om social pension SF1411_B Hent helbredsprocent SF1411_A Hent samliv og formue Serviceplatformen Figuren viser Serviceplatformen, Beskedfordeler og de involverede fagsystemer med udstillede og anvendte snitflader. UDK Pension udstiller snitflader til Serviceplatformen med informationer om social pension, som indeholder tillægsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder (SF1411_A), og afsender beskeder med ændringer i samme oplysninger via Beskedfordeler (AF1411_D). Kommunal Pension bruger en snitflade udstillet på Serviceplatformen til opslag af tillægsprocent (SF1411_A) og modtager beskeder med ændringer i tillægsprocent via Beskedfordeler (SF1411_D). Kommunal Pension udstiller en snitflade til opslag på helbredsprocent via Serviceplatformen (SF1411_B) og afsender beskeder om ændringer i helbredsprocent via Beskedfordeler (SF1411_E). KY anvender snitflader udstillet på Serviceplatformen til opslag af samliv og formue (SF1411_A) og helbredsprocent (SF1411_B), og modtager beskeder om ændringer til samliv og formue (SF1411_D) og helbredsprocent (SF1411_E) via Beskedfordeler. Kommunal Pension og KY vedligeholder deres abonnementer (herunder værdilister). Autorisation og autentifikation mellem KY, UDK Pension, Kommunal Pension, Beskedfordeler og Serviceplatformen sker ved hjælp af det fælleskommunale støttesystem Adgangsstyring. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 41
Transitionsarkitektur For at kunne understøtte udfasningen af KMD Social Pension er en transitionsfase indført, hvor flere fag- og pensionssystemer samtidigt varetager opgaven med beregning og udveksling af informationer om tillægsprocent, helbredsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder for kommunerne og UDK. Håndteringen af denne kompleksitet er Serviceplatformens ansvar, så UDK Pension, Kommunal Pension og KY, kan anvende målarkitekturen i videst mulige omfang uden at skulle forholde sig til transitionen. I transitionsarkitekturen har Serviceplatformen ansvar for at opslag fra fag- og pensionssystemer foretages imod det korrekte kildesystem samt korrekt transformation af data fra KMD Social Pension til beskeder, der sendes og modtages via Beskedfordeler. Transitionsarkitekturen indeholder KMD Social Pension i stedet for Kommunal Pension, og er vist med endpoints for udstillede snitflader på nedenstående figur: Udstil ændringer med informationer om social pension (SF1411_D) inkl. helbredsprocent (SF1411_E) Udstil informationer om social pension (SF1411_A) inkl. helbredsprocent (SF1411_B) Modtag ændringer med informationer om social pension (SF1411_D) fra UDK Pension og helbredsprocent (SF1411_E) fra Kommunal Pension (ses ikke på tegning). KMD Social Pension (Kommune og UDK del) Send besked med informationer om social pension (SF1411_D) og helbredsprocent (SF1411_E) fra KMD Socialpension Hent besked med informationer om social pension (SF1411_D) fra UDK Pension og helbredsprocent (SF1411_E) fra Kommunal Pension (ses ikke på tegning). Beskedfordeler UDK Pension Send beskeder med informationer om social pension (SF1411_D) Udstil informationer om social pension (SF1411_A) KY Hent Besked om helbredsprocent (SF1411_E) og samliv + formue (SF1411_D) Opdater værdiliste (SF1411_A og _B) Hent helbredsprocent (SF1411_B) og samliv + formue (AF1411_A) Serviceplatformen Figuren viser transitionsarkitekturen i forbindelse med udfasningen af KMD Social Pension, hvor det nye Kommunal Pension fagsystem ikke er introduceret endnu. Sammenlignet med målarkitekturen er det Serviceplatformen, der er ansvarlig for at sende beskeder via Beskedfordeler og hente beskeder fra Beskedfordeler på vegne af KMD Social Pension. Serviceplatformen dirigerer opslag fra KY og UDK Pension til KMD Social Pension, og afleverer ændringer i informationerne til KMD Social Pension. Kommunal Pension og KMD Social Pension Kommunedel vil sameksistere i en transitionsperiode, hvor Kommunal Pension vil modtage tillægsprocent fra UDK Pension eller KMD Social Pension. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 41
Integrationerne [SF1411_A], [SF1411_B], [SF1411_D] og [SF1411_E] skal således ses i sammenhæng med mest muligt genbrug af komponenter på tværs af integrationerne. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 41
1.3 Overordnet forretningsflow i integrationen Følgende forretningsflow indgår i integrationen: IF01 Afsend besked : Pensionssystemet UDK Pension sender oplysninger om ændringer i tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder som beskeder til Beskedfordeler. I transitionsfasen kan oplysningerne også komme fra pensionssystemet KMD Social Pension. Serviceplatformen modtager ændringen fra KMD Social Pension via et kø system og transformerer ændringen til beskeder, som udsendes via Beskedfordeler. IF02 Modtag besked : Fagsystemet modtager beskeder om ændringer i tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder fra Beskedfordeler. I transitionsfasen modtager KMD Social Pension Kommunedel også ændringer i tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder fra UDK Pension via en integration til Beskedfordeler, hvor Serviceplatformen modtager beskeder fra Beskedfordeler og videresender disse til KMD Social Pension Kommunedel. IF03 Opdater værdiliste : 1 Fagsystemet opdaterer værdiliste i abonnement på Beskedfordeler. Beskedfordeler returnerer forretningsmæssig kvittering. Integrationen er i transitionsfasen en orkestreringsintegration med transformation, hvor Serviceplatform agerer som beskedagent. Serviceplatformen indgår ikke i den endelige version af integrationen. 1 I transitionsperioden vil KMD Social Pension Kommunedel (via Serviceplatformen) abonnere på alle beskeder om ændringer i informationer om social pension for de kommunerne, som i transitionsfasen benytter KMD Social Pension. Abonnementet på Beskedfordeler benytter ikke værdiliste på CPR-nummer. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 41
UDK Pension Beskedfordeler Fagsystem(n) Integrationsbeskrivelse Integrationens forretningsflow for IF01 og IF02 i den endelige integration er illustreret på nedenstående diagram: IF01 Afsend besked IF02 Modtag besked Modtag Besked Abonnement Modtag besked Distribuer besked Generer ændring Ændring til information om social pension KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 41
Beskedfordeler Fagsystem KMD Social Pension UDK Pension Serviceplatformen Beskedfordeler KMD Socialpension Kommunedel Fagsystem(n) Integrationsbeskrivelse Integrationens forretningsflow for IF01 og IF02 i transitionsfasen er illustreret på nedenstående diagram: IF01 Afsend besked IF02 Modtag besked Modtag Besked EP_FS1 Er i abonnement Modtag ændring Distribuer besked Modtag besked Abonnement EP_KSKP1 EP_PENS1 EP_FS1 Er i abonnement Generer Besked Modtag Besked Generer ændring EP_KS1 Generer ændring EP_PENS1 Ændring til information om social pension Generer ændring Ændring til information om social pension Integrationens forretningsflow for IF03 er illustreret på nedenstående diagram: IF03 Opdater værdiliste Part ændret Kræver ændring Abonnement oprettet EP_FS2 Opdater værdiliste Opdater værdiliste Kvittering for ændret værdiliste KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 41
1.4 Servicebetingelser for den samlede integration 1.4.1 Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Flow IF01, IF02, IF03 For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og UDK Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og UDK Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og UDK Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og UDK Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og UDK Pension] 1.4.2 Service Management 1.4.2.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] 1.4.2.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] 1.4.2.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] 1.4.3 Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 41
1.5 Teststrategi 1.5.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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.5.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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF undersøg testfaciliteter og testmiljø hos KMD og UDK] 1.5.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF undersøg om KMD og UDK stiller testdata til rådighed] 1.5.2 Test i forbindelse med produktionssætning [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF undersøg om der findes aftale om produktionssætning med KMD og UDK] 1.6 Forudsætninger for produktionssætning af integration social pension 1.6.1 Forudsætninger for funktionalitet på Serviceplatformen For at kunne modtage modtager beskeder på vegne af KMD Social Pension via Beskedfordeler skal de nødvendige abonnementer være oprettet forud for idriftsættelse af integrationen. 1.6.2 Generelle forhold for tilslutning til integrationspart: UDK Pension, Kommunal Pension og KY Integrationerne mellem Serviceplatformen, Beskedfordeler, UDK Pension, Kommunal Pension og KY er tokenbaserede. Løsningerne skal oprettes i den det fælleskommunale støttesystem Adgangsstyring. For at kunne modtage beskeder via Beskedfordeler skal Kommunal Pension og KY oprette de nødvendige abonnementer forud for idriftsættelse af integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 41
1.6.3 Generelle forhold for tilslutning til integrationspart: KMD Social Pension og KMD Social Pension Kommunedel Integrationerne mellem KMD Social Pension og Serviceplatformen er certifikatbaseret. Kommunerne skal have de nødvendige VOCES certifikater, før løsningen tages i brug. Alle certifikater skal gennemgå en godkendelsesprocedure i KMD. KMD meddeles leverandørens certifikat senest tre uger før, grænsefladerne kan tages i brug. [Afklaring/KDF det skal afklares, om KMD s systemer skifter til en tokenbaseret sikkerhedsmodel] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 41
2 Kontekst for integrationsparter 2.1 Kontekst for KMD Social Pension Kommunedel [!@KSKP@!] 2.1.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KDF - Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] 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. Det forvaltningsmæssige formål med integrationen er at beregne helbredsprocent for en persons og for en eventuel samlever. Oplysninger om tillægsprocent indgår i beregningen. 2.1.2 Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca. 20.000 pr. måned, samt årlig genberegning med op til ca. 260.000 beskeder. Antallet for KMD Social Pension Kommunedel vil falde i løbet af transitionsfasen ifm. migreringen til Kommunal Pension. 2.1.3 Specifikke forhold for tilslutning af system Sikkerheden mellem KMD Social Pension og Serviceplatformen er certifikatbaseret, så de nødvendige certifikater skal være klar og implementerede før idriftsættelsen. 2.2 Kontekst for Kommunal Pension [!@KP@!] 2.2.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KDF - Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] 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. Det forvaltningsmæssige formål med integrationen er at beregne helbredsprocent for en persons og for en eventuel samlever. Oplysninger om tillægsprocent indgår i beregningen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 41
2.2.2 Kapacitets- og servicekrav Flowet IF01 har et forventet antal beskeder på ca. 20.000 pr. måned, samt årlig genberegning med op til ca. 260.000 beskeder. Antallet for Kommunal Pension vil stige fra 0 til de angivne antal i løbet af transitionsfasen ifm. migreringen. 2.2.3 Specifikke forhold for tilslutning af system Sikkerheden mellem Kommunal Pension og Beskedfordeler er tokenbaseret, så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelsen. For at kunne modtage beskeder via Beskedfordeler skal Kommunal Pension oprette de nødvendige abonnementer forud for idriftsættelse af integrationen. 2.3 Kontekst for Kommunernes Ydelsessystem [!@KY@!] 2.3.1 Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] 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. Det forvaltningsmæssige formål med integrationen er, at Kommunernes Ydelsessystem modtager besked om ændrede oplysninger om samliv og formue for en person. Oplysningerne kan således indgå i tildelingen af ydelser for Kommunernes Ydelsessystem. 2.3.2 Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca. 20.000 pr. måned, samt årlig genberegning med op til ca. 260.000 beskeder. Antallet afhænger af antallet af oprettede abonnementer. 2.3.3 Specifikke forhold for tilslutning af system Sikkerheden mellem KY og Beskedfordeler er tokenbaseret, så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelsen. For at kunne modtage beskeder via Beskedfordeler skal Kommunal Pension oprette de nødvendige abonnementer forud for idriftsættelse af integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 41
2.4 Kontekst for KMD Social Pension[!@KS@!] 2.4.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KDF - Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] 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. Det forvaltningsmæssige formål med integrationen er at udstille oplysninger om tillægsprocent for en person og for en eventuel samlever, så oplysningerne kan indgå i beregningen af helbredsprocent. 2.4.2 Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca. 20.000 pr. måned, samt årlig genberegning med op til ca. 260.000 beskeder. Antallet for KMD Social Pension vil falde i løbet af transitionsfasen ifm. migreringen til UDK Pension. 2.4.3 Specifikke forhold for tilslutning af system Sikkerheden mellem KMD Social Pension og Serviceplatformen er certifikatbaseret, så de nødvendige certifikater skal være klar og implementerede før idriftsættelsen af løsningen. 2.5 Kontekst for UDK Pension [!@UDK@!] 2.5.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KDF - Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] 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. Det forvaltningsmæssige formål med integrationen er at udstille oplysninger om tillægsprocent for en person og for en eventuel samlever, så oplysningerne kan indgå i beregningen af helbredsprocent. 2.5.2 Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca. 20.000 pr. måned, samt årlig genberegning med op til ca. 260.000 beskeder. Antallet for UDK Pension vil stige fra 0 til de angivne antal i løbet af transitionsfasen ifm. migreringen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 41
2.5.3 Specifikke forhold for tilslutning af system Sikkerheden mellem UDK Pension og Serviceplatformen er tokenbaseret så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelsen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 41
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for fagsystemerne Kommunal Pension, KY og SP som modtagende beskedagent [!@KP@!][!@KY@!][!@Systematic@!] Integrationen benyttes af fagsystemerne og i transitionsperioden af Serviceplatformen (på vegne af KMD Social Pension Kommunedel) til at modtage beskeder med en eller flere ændringer til en persons tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder fra Beskedfordeler. Fagsystemerne benytter også integrationen til at vedligeholde et abonnement på Beskedfordeler. 3.1.1 Overordnet forretningslogik Fagsystemerne og Serviceplatformen modtager beskeder om ændring i en given persons informationer om social pension fra Beskedfordeler: Fagsystemerne / Serviceplatform modtager beskeder (push / pull) via EP_FS1 Fagsystemerne opretter og vedligeholder et abonnement (værdiliste) på Beskedfordeler via EP_FS2 3.1.2 Oversigt over endpoints ID Navn EP_FS1 ModtagBesked EP_FS2 AdministrerVaerdiliste 3.1.3 Beskrivelse af endpoint [EP_FS1] ModtagBesked Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Beskedfordeler udstiller beskeder fra UDK Pension og KMD Social Pension. Endpoint benyttes af fagsystemerne i forbindelse ændringer i oplysninger om social pension. 3.1.3.1 Abonnementsvilkår Fagsystemerne / Serviceplatformen skal oprette abonnement på beskedtypen Social pension hændelse. Fagsystemerne skal desuden oprette abonnement på Relateret Objekt: ObjektType = Person og ObjektID = CPR-nummer' samt vedligeholde værdiliste, som angive i afsnit 3.1.4. [Afklaring/KDF afsnittet skal opdateres ift. generel beskrivelse for opsætning af abonnement] 3.1.3.2 Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Outputdata Dataspecifikationen for indholdet af selve beskedindholdet findes i følgende schema-filer: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 41
Miljø: Produktion og Test Inputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_A] Outputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_A] Se afsnit 3.2.3.1 for en beskrivelse af indholdet i beskedkuvert og indhold. 3.1.4 Beskrivelse af endpoint [EP_FS2] AdministrerVaerdiliste [Systematic Dette endpoint benyttes ikke af Serviceplatformen. Implementering af dette er således ikke en del af opgaven for Systematic.] Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B]. Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnementer. Endpoint kaldes af fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonnement. 3.1.4.1 Værdiliste Fagsystemerne skal vedligeholde værdiliste for de personer, der ønsker at abonnere på. [Afklaring/KDF afsnittet skal opdateres ift. generel beskrivelse for håndtering af værdiliste] 3.1.5 Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] 3.2 Specifikation af endpoints for UDK Pension og SP som afsendende beskedagent [!@UDK@!][!@Systematic@!] Integrationen benyttes af UDK Pension og i transitionsperioden af Serviceplatformen (på vegne af KMD Social Pension) til at sende en eller flere ændringer til en persons tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder til Beskedfordeler. 3.2.1 Overordnet forretningslogik UDK Pension og Serviceplatformen sender ændringen i en given persons informationer om social pension til Beskedfordeler: UDK Pension / Serviceplatform kalder EP_PENS1 Beskedfordeler returnerer et synkront svar til afsender KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 41
3.2.2 Oversigt over endpoints ID Navn EP_PENS1 AfsendBesked 3.2.3 Beskrivelse af endpoint EP_PENS1 AfsendBesked Beskrivelsen af endpoint findes i Aflever besked [SF1460_C]. UDK Pension / Serviceplatformen sender ændringer i informationer om social pension for en given person. Endpoint kaldes ved ændring i informationer om social pension. I transitionsfasen vil Serviceplatformen kalde også endpointet ifm. modtagelse af ændringer sendt fra KMD Social Pension (EP_KS1). 3.2.3.1 Dataspecifikation En besked består af en kuvert og et beskedindhold. 3.2.3.1.1 Beskedkuverten dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Outputdata Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer. Værdier angivet med er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal afsendersystemet selv udfylde. [OBS! Struktur og indhold i beskedkuvert er ikke endeligt fastlagt. Afventer endelig leverance af specifikation for Beskedfordeler samt afklaring på bl.a. nedenstående. Nøgler generelt: Skal der defineres urn for dem eller bruges UUID som beskrevet nedenfor? TilladtModtager og ObjektAnsvarligMyndighed: Skal de angives med UUID eller urn:oio:cvr:xxxxxxx? Relateret Objekt: Skal der tilføjes en ObjektRolle? ObjektId: Er det en sag eller lignende? ObjektType: Hvilken objekttype er det? Er det f.eks. en sag? ObjektHandling: Hvad kaldes ændringen? Er den relateret til en handlingsfacet? OpgaveEmne: Er det rette kategori, eller skal det være Social Pension? ObjektEmne: Skal handlingsfacetten med? Skal den evt. angives i ObjektHandling?] Element Beskrivelse Værdifelt udfyldelse Filtreringsdata KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 41
Beskedtype Beskedtypen Social pension [Afklaring/KDF indsæt UUID for hændelse beskedtypen Social pension hændelse ] BeskedAnsvarligAktør Det it-system, der afsender UUID for it-systemet beskeden TilladtModtager Borgerenes UUID for kommunen bopælskommune RelateretObjekt ObjektId CPR-nummer på borgeren urn:oio:cpr:xxxxxxxxxx x'er erstattes med CPR-nummer (uden ObjektType Objektregistrering ObjektRegistreringId RegistreringsAktoer UUID for det relaterede forretningsobjektet Person Hændelsen, der ligger til grund for beskeden Det it-system, der har genereret hændelsen bindestreg) [Afklaring/KDF indsæt UUID for forretningsobjektet Person ] UUID for hændelsen UUID for it-systemet eller for SP, hvis SP sender eller modtager på vegne af KMD Social Pension Tidspunktet [KDF/Afklaring indsæt format] Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden ObjektAnsvarligMyndighed UDK [KDF/Afklaring indsæt UDK s CVRnummer] ObjektId Sagsnummeret UUID for sagens id ObjektType ObjektHandling OpgaveEmne Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldighedFra Forretningsobjektet Social pension Handlingen Ændring i social pension KLE-nummer for Social pension : Tidspunkt hvor beskeden opstod Klassificeringen Personfølsomt Tidspunk hvor hændelsen opstod UUID for Social pension UUDI for Ændring i social pension urn:oio:kle:[afklaring/kdf indsæt KLEnummer her] Tidspunktet [KDF/Afklaring indsæt format] [Afklaring/KDF indsæt UUID for Personfølsomt ] Tidspunktet [KDF/Afklaring indsæt format] 3.2.3.1.2 Beskedindhold dataspecifikation Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_A] Outputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_A] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 41
Beskeddata består af informationer om social pension for en person. Overskrift Forklaring Kommentar til udarbejdelse af specifikation Personnummer Personens aktive personnummer i CPR registret. Format: urn:oio.cprnr:xxxxxxxxxx Likvidformuestruktur Samlet formue for personen og samlever (hvis relevant) En eller flere Perioder bestående af: Start-dato Slut-dato Likvid formue: Værdisæt, webservice: 0 999.999.999 Værdisæt, MQ: 0,00 999.999.999,99 Er formuen oplyst, Værdisæt: Ej angivet Oplyst Uoplyst [Systematic udarbejder struktur med udgangspunk i http://digitaliser.dk/resource/242 6503] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 41
Samlivsstatus Personlig tillægsprocent Pensionstype Samliv kan have en eller flere Perioder bestående af: Start-dato Slut-dato Samlivsstatus værdisæt: Enlig, forklaring: Erklæret enlig Gift faktisk adskilt Gift faktisk adskilt pga. plejehjem Enke, enkemand Separeret reelt enlig Fraskilt Samlevende før 01.01.2003 Overgangsordning: Gift Gift / registreret partnerskab Samlevende: Samlevende efter 01.01.2003 En eller flere Perioder af: Start-dato Slut-dato Tillægsprocent, Værdisæt: 0-100 % En eller flere Perioder af: Start-dato Slut-dato Pensionstype: Folkepension Opsat folkepension Ny Foertidspension (bevilget efter aar 2003) Gammel Foertidspension [Systematic udarbejder struktur med udgangspunk i http://digitaliser.dk/resource/242 2730] [Systematic udarbejder struktur med udgangspunk i http://digitaliser.dk/resource/242 6507] [Systematic udarbejder struktur med udgangspunk i https://digitaliser.dk/resource/24 22718] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 41
Pensionsstatus En eller flere Perioder af: Start-dato Slut-dato Pensionsstatus: Ja (aktiv/hvilende) Nej [Systematic udarbejder struktur med udgangspunk i https://digitaliser.dk/resource/24 22714] Pensionsbrøk Afslag på folkepension Oplysning om udlandsophold > 2 mdr. Pensionsbrøk (altid 1 forekomst i svaret) StartDate EndDate Pensionsbrøk (både tæller og nævner er nødvendige, f.eks. (26/40)) Pensionsafslag (altid 1 forekomst i svaret) StartDate EndDate Pensionsafslag (ja / nej) Udlandsophold (0-* forekomster i svaret) StartDate EndDate Udlandsopholdsland (landekode i den standard, som OIO anvender) [Systematic udarbejder struktur med udgangspunk i Forklaring] [Systematic udarbejder struktur med udgangspunk i Forklaring] [Systematic udarbejder struktur med udgangspunk i Forklaring] 3.2.4 Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C]. 3.3 Specifikation af endpoints for KMD Social Pension Kommunedel [!@KSKP@!] Integrationen benyttes til at levere ændringer til information om tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder for en given person. [Afklaring/KDF - Dette endpoint er pt ikke bestilt som en del af P12-1.] 3.3.1 Overordnet forretningslogik Serviceplatformen sender ændringer i en given persons informationer om social pension til en modtagerkø hos KMD Social Pension Kommunedel: Serviceplatform uploader ændringer til KMD Social Pension Kommunedel via EP_KSKP1 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 41
KMD returnerer kvittering for modtagelse af ændringerne 3.3.2 Oversigt over endpoints ID Navn EP_KSKP1 ModtagAendringerKMD 3.3.3 Beskrivelse af endpoint EP_KSKP1 - ModtagAendringerKMD 3.3.3.1 Transportspecifikation 3.3.3.1.1 Integrationsmønster Serviceplatformen kalder KMD Social Pension Kommunedel via en MQ kø hos KMD Social Pension Kommunedel. 3.3.3.1.2 Serviceudstiller KMD Social Pension Kommunedel er serviceudstiller. 3.3.3.1.3 Serviceanvender Serviceplatformen er serviceanvender. 3.3.3.1.4 Teknologisk understøttelse Servicen er implementeret ved hjælp af en IBM Websphere MQ. 3.3.3.1.5 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul 3.3.3.1.6 Teknisk retning for udveksling Serviceplatformen uploader en ændring til informationer om social pension for en given person til KMD Social Pension Kommunedel. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 41
3.3.3.1.7 Dataretning for udveksling KMD Social Pension Kommunedel modtager ændring til informationer om social pension for en given person fra Serviceplatformen. 3.3.3.1.8 Service invokation / Triggers Endpoint kaldes når Serviceplatformen modtager en besked med ændringer fra Beskedfordeler. 3.3.3.2 Dataspecifikation 3.3.3.2.1 Dataformat til MQ Dataformat til MQ-køen følger beskrivelse af P12_1_Snitfladebeskrivelse_v008.pdf afsnit 4.3.2 [P12-1]: Dataformat til MQ-køen er som følger: Karakterbaseret MQ-kommunikation, kommasepareret fil med semikolon separator. PERSONNUMMERCHAR(10) TYPECHAR(12) START_DATOCHAR(10) [ÅÅÅÅ-MM-DD] SLUT_DATOCHAR(10) [ÅÅÅÅ-MM-DD] VÆRDICHAR(15) [Tal på tillægsprocent nul med komma og to faste decimaler Ingen fortegn=positiv værdi -Fortegn ='-' = negativ værdi] VAERDI_TXTCHAR(12) [Kan indeholde både store og små bogstaver] Alle felter er trimmede, dvs. foranstillede blanke er fjernet. Der optræder altid flere registreringer for hvert (og samme) personnummer, idet ovennævnte typer (FORMUE, SAMLIV, TILLÆG) altid samles i samme record i samme MQ-message. Da data for typerne (FORMUE, SAMLIV, TILLÆG) endvidere er periodiseret, kan der forekomme flere perioder inden for samme type. I record en gentages Typenavnet for hver periode. VÆRDI for samlivstypen er irrelevant og derfor udfyldes med 0,00. For FORMUE-typen gælder derimod, at VÆRDI er udfyldt og i nogle også VÆRDI_TXT. Når der f.eks. i formuen står nul, skal systemet vide, at formuen er oplyst til nul. Dette angives ved VÆRDI = 0,00 og VÆRDI_TXT = OPLYST. For typerne TILLÆG gælder, at kun VÆRDI anvendes, mens VÆRDI_TXT ikke udfyldes. Da data afsluttes med semikolon (;), og da VÆRDI_TXT ikke er udfyldt (feltet er trimmet til ingenting), men alligevel afsluttes med semikolon, optræder to semikolon efter hinanden (;;). Se P12_1_Snitfladebeskrivelse_v008 [P12-1] for yderligere forklaring af indholdet i MQ-messages. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 41
3.3.3.3 Sikkerhed [Afklaring/KDF - Sikkerhed på MQ skal afklares. Afventer svar fra KMD] 3.3.3.4 Leverancesikkerhed og fejlhåndtering Serviceplatformen skal persistere beskeden indtil data er afleveret til KMD Social Pension Kommunedel. Såfremt MQ er utilgængelig, så skal beskeden forsøges gensendt med mellemrum. 3.3.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.3.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] 3.3.4 Service Management 3.3.4.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.3.4.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.3.4.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.3.5 Testplan 3.3.5.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Integrationstest med KMD] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 41
3.3.5.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Produktionssætningstest med KMD] 3.4 Specifikation af endpoints for KMD Social Pension [!@KS@!] Integrationen anvendes til at udstille information om ændringer til tillægsprocent, samliv, formue, brøkpension, afslag på folkepension eller oplysninger om udlandsophold over to måneder for en given person. OBS! Denne snitflade er identisk med snitfladen mod KMD Social Pension i SF1411_E. 3.4.1 Overordnet forretningslogik KMD Social Pension udstiller ændringer i en given persons informationer om social pension via en MQ modtagerkø: Serviceplatform henter ændringer fra KMD Social Pension via EP_KS1 Serviceplatformen sletter ændringer på modtagerkøen [Afklaring/KDF det skal afklares, om KMD Social Pension sender de tre nye typer: Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder] 3.4.2 Oversigt over endpoints ID EP_KS1 Navn UdstilAendringerKMD 3.4.3 Beskrivelse af endpoint EP_KS1 - UdstilAendringerKMD 3.4.3.1 Transportspecifikation 3.4.3.1.1 Integrationsmønster Der benyttes et asynkront integrationsmønster, hvor KMD Social Pension udstiller ændringer på en IBM Websphere MQ. 3.4.3.1.2 Serviceudstiller KMD Social Pension er serviceudstiller. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 af 41
3.4.3.1.3 Serviceanvender Serviceplatformen er serviceanvender. 3.4.3.1.4 Teknologisk understøttelse Servicen er implementeret som en IBM Websphere MQ. 3.4.3.1.5 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul 3.4.3.1.6 Teknisk retning for udveksling Serviceplatformen overvåger MQ udstillet af KMD Social Pension og henter ændringer. 3.4.3.1.7 Dataretning for udveksling KMD Social Pension udleverer oplysninger om ændringer i informationer om social pension for en given person. 3.4.3.1.8 Service invokation / Triggers Endpoint kaldes af Serviceplatformen. 3.4.3.2 Dataspecifikation Dataformat til MQ-køen følger beskrivelse af P12_1_Snitfladebeskrivelse_v008.pdf afsnit 4.3.2 [P12-1]: Dataformat til MQ-køen er som følger: Karakterbaseret MQ-kommunikation, kommasepareret fil med semikolon separator. PERSONNUMMER, CHAR(10) TYPE, CHAR(12) START_DATO, CHAR(10) [ÅÅÅÅ-MM-DD] SLUT_DATO, CHAR(10) [ÅÅÅÅ-MM-DD] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 af 41
VÆRDI, CHAR(15) [Tal på tillægsprocent nul med komma og to faste decimaler Ingen fortegn=positiv værdi -Fortegn ='-' = negativ værdi] VAERDI_TXT, CHAR(12) [Kan indeholde både store og små bogstaver] Alle felter er trimmede, dvs. foranstillede blanke er fjernet. TYPE kan være FORMUE, SAMLIV, TILLÆG, TILSKUD. Der optræder altid flere registreringer for hvert (og samme) personnummer, idet ovennævnte typer (FORMUE, SAMLIV, TILLÆG og TILSKUD) altid samles i samme record i samme MQ-message. Da data for typerne (FORMUE, SAMLIV, TILLÆG og TILSKUD) endvidere er periodiseret, kan der forekomme flere perioder inden for samme type. I record en gentages Typenavnet for hver periode. VÆRDI for samlivstypen er irrelevant og derfor udfyldes med 0,00. For FORMUE-typen gælder derimod, at VÆRDI er udfyldt og i nogle også VÆRDI_TXT. Når der f.eks. i formuen står nul, skal systemet vide, at formuen er oplyst til nul. Dette angives ved VÆRDI = 0,00 og VÆRDI_TXT = OPLYST. For typerne TILLÆG og TILSKUD gælder, at kun VÆRDI anvendes, mens VÆRDI_TXT ikke udfyldes. Da data afsluttes med semikolon (;), og da VÆRDI_TXT ikke er udfyldt (feltet er trimmet til ingenting), men alligevel afsluttes med semikolon, optræder to semikolon efter hinanden (;;). Se P12_1_Snitfladebeskrivelse_v008 [P12-1] for yderligere forklaring af indholdet i MQ-messages. 3.4.3.3 Sikkerhed [Afklaring/KDF Sikkerhed på MQ skal afklares. Afventer svar fra KMD] Serviceplatformen er anvendersystem. 3.4.3.4 Leverancesikkerhed og fejlhåndtering Fejlhåndtering på MQ håndteres som beskrevet i [P12-1]. 3.4.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.4.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Værdi [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 af 41
Servicevinduer [Afklaring/KDF indsæt servicemål for KMD MQ] 3.4.4 Service Management 3.4.4.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.4.4.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.4.4.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.4.5 Testplan 3.4.5.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Integrationstest med KMD] 3.4.5.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Produktionssætningstest med KMD] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 af 41
4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen [!@Systematic@!] 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 i transitionsfasen. I den endelige version udgår komponenterne KMD Social Pension, KMD Social Pension Kommunedel og Serviceplatformen samt EP_KS1 og EP_KSKP1. Serviceplatformen Fagsystemer (Kommunal Pension og KY) KMD Social Pension EP_KS1 MQ IF01 AMQP EP_PENS1 AMQP EP_FS1 WS EP_FS2 Beskedfordeler KMD Social Pension Kommunedel EP_KSKP1 MQ IF02 AMQP EP_FS1 EP_PENS1 AMQP UDK Pension 4.1.1 Oversigt over integrationsflows ID Navn IF01 Afsend Besked IF02 Modtag Besked KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 33 af 41
4.1.2 Arbejdspakker Som beskrevet i afsnit 1.2, så skifter integrationsparterne i løbet af snitfladens levetid. Derfor skal estimatet af løsningen udarbejdes en arbejdspakke: Arbejdspakke SF1411_D1: Integration mellem Serviceplatform og KMD Social Pension, KMD Social Pension Kommunedel samt Beskedfordeler. Denne del skal kunne fjernes igen, når transitionen er gennemført. 4.1.3 Integrationsflow IF01: Afsend besked 4.1.3.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_PENS1 AfsendBesked 3.2.3 EP_KS1 UdstilAendringKMD 3.4.3 4.1.3.2 Integrationstype Integrationen er en orkestreringsintegration med transformation, hvor Serviceplatform agerer som beskedagent. 4.1.3.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KMD Socialpension UDK Pension Serviceplatformen Beskedfordeler hent ændringer fra kø Transformer Persisteer Besked Fjern ændringer fra kø Persister Besked KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 34 af 41
4.1.3.4 Datatransformering I transitionsfasen skal data, der modtages fra KMD Social Pension via EP_KS1, tranformeres til en besked, der kan sendes via EP_PENS1. Det er kun de data, der indgår i snitfladen udstillet af KMD Social Pension, der skal sendes i beskeden. Serviceplatformen skal udfylde beskedkuverten, og den record, som modtages med formatet specificeret i EP_KS1 (afsnit 3.4.3.2), skal mappes over i en besked som specificeret i beskrivelsen af beskedindhold i EP_PENS1 (afsnit 3.2.3.1.2). Det er kun ændringer, hvor TYPE har værdien TILLÆG, FORMUE eller SAMLIV, der skal behandles i denne integration (ændringer, hvor TYPE har værdien TILSKUD, behandles i [SF1411_E]). OBS! Der kan godt være forskellige typer af ændringer i samme record. Serviceplatformen skal udfylde manglende oplysninger, som angivet i [SP indsæt ] samt indsætte indholdet angivet i i beskedkuvert for snitflade EP_PENS1, som beskrevet i nedenstående tabel: [OBS! Struktur og indhold i beskedkuvert er ikke endeligt fastlagt. Afventer endelig leverance af specifikation for Beskedfordeler samt afklaring på bl.a. nedenstående. Nøgler generelt: Skal der defineres urn for dem eller bruges UUID som beskrevet nedenfor? TilladtModtager og ObjektAnsvarligMyndighed: Skal de angives med UUID eller urn:oio:cvr:xxxxxxx? Relateret Objekt: Skal der tilføjes en ObjektRolle? ObjektId: Er det en sag eller lignende? ObjektType: Hvilken objekttype er det? Er det f.eks. en sag? ObjektHandling: Hvad kaldes ændringen? Er den relateret til en handlingsfacet? OpgaveEmne: Er det rette kategori, eller skal det være Social Pension? ObjektEmne: Skal handlingsfacetten med? Skal den evt. angives i ObjektHandling?] Element Beskrivelse værdifelt SP udfyldelse af værdifelt Filtreringsdata Beskedtype UUID for beskedtypen Social pension hændelse [Afklaring/KDF indsæt UUID for beskedtypen Social pension hændelse ] BeskedAnsvarligAktør UUID for det it-system, der afsender beskeden [Afklaring/KDF indsæt UUID for aktøren Serviceplatformen ] TilladtModtager UUID for borgerenes bopælskommune RelateretObjekt ObjektId ObjektType CPR-nummer på borgeren: urn:oio:cpr:xxxxxxxxxx UUID for det relaterede forretningsobjektet Person [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje kommune id i record] urn:oio:cpr:[sp indsæt PERSONNUMMER fra MQ-record (uden bindestreg)] [Afklaring/KDF indsæt UUID for forretningsobjektet Person ] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 35 af 41
Objektregistrering ObjektRegistreringId UUID for hændelsen, der ligger til grund for beskeden [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record [Afklaring/KDF KMD skal tilføje hændelsesid i record] [Afklaring/KDF indsæt UUID for SP ] RegistreringsAktoer UUID for det it-system, der har genereret hændelsen Registreringstidspunkt Tidspunkt for hændelsens [SP indsæt modtagelsestidspunkt fra MQkø] udsendelse fra kilden [KDF/Afklaring indsæt format] ObjektAnsvarligMyndighed UDK [KDF/Afklaring indsæt UDK s CVRnummer] ObjektId UUID / URN? [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje sagsid i record] ObjektType ObjektHandling OpgaveEmne Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldighedFra UUID for forretningsobjektet [Afklaring/KDF indsæt UUID for Social Social pension??? pension??? ] UUID for handlingen [Afklaring/KDF indsæt UUID for Ændring Ændring i social pension i social pension??? ]??? KLE-nummer for Social pension : urn:oio:kle:nn.nn.nn + handlingsfacet Tidspunkt hvor beskeden opstod [KDF/Afklaring indsæt format] UUID for klassificeringen Personfølsomt Tidspunk hvor hændelsen opstod [KDF/Afklaring indsæt format] urn:oio:kle:[afklaring/kdf indsæt KLEnummer her] [SP indsæt tidspunkt for dannelse af beskeden på SP] [Afklaring/KDF indsæt UUID for Personfølsomt ] [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje tidspunkt for hændelsen i record] Mapningen fra indhold fra MQ-record i snitflade EP_KS1 til beskeddata i snitflade EP_PENS1 følger nedenstående tabel: Element Beskrivelse felt SP udfyldelse af felt Struktur: Personlig tillægsprocent Felt: start-dato Dato for periodens starttidspunkt [SP indsæt START_DATO fra MQ-record] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 36 af 41
[KDF/Afklaring indsæt format] Felt: slut-dato Dato for periodens [SP indsæt SLUT_DATO fra MQ-record] sluttidspunkt [KDF/Afklaring indsæt format] Felt: Værdisæt Den udregnede procentsats [SP indsæt VÆRDI fra MQ-record] Struktur: Likvidformuestruktur Felt: start-dato Dato for periodens [SP indsæt START_DATO fra MQ-record] starttidspunkt [KDF/Afklaring indsæt format] Felt: slut-dato Dato for periodens [SP indsæt SLUT_DATO fra MQ-record] sluttidspunkt [KDF/Afklaring indsæt format] Felt: Likvid formue Beløb på formue [SP indsæt VÆRDI fra MQ-record] Felt: Er formuen oplyst, Statuskode [SP indsæt VAERDI_TXT fra MQ-record] Værdisæt Struktur: Samlivsstatus Felt: start-dato Dato for periodens [SP indsæt START_DATO fra MQ-record] starttidspunkt [KDF/Afklaring indsæt format] Felt: slut-dato Dato for periodens sluttidspunkt [KDF/Afklaring indsæt [SP indsæt SLUT_DATO fra MQ-record] Felt: Samlivsstatus, Værdisæt format] Statuskode [SP indsæt VAERDI_TXT fra MQ-record] [Afklaring/KDF Hvis KMD Social Pension bliver udvidet til også at sende de andre typer af informationer, så skal disse inkluderes i mapningstabellen] 4.1.3.5 Datapersistering Serviceplatformen skal persistere data modtaget via EP_KS1 indtil de er blevet videresendt til Beskedfordeler via EP_PENS1. 4.1.3.6 Databerigelse N/A KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 37 af 41
4.1.3.7 Routing N/A 4.1.3.8 Orkestrering Serviceplatformen skal orkestrere modtagelse af message fra MQ-køen, transformere message, udfylde beskedkuvert og indhold, persistere besked, sende besked til Beskedfordeler, og slette den persisterede besked og data på MQ-køen, når beskeden er bekræftet modtaget af Beskedfordeler. 4.1.3.9 Sikkerhed [Afklaring/KDF afklaring om sikkerhed er i gang. Der antages følgende: I transitionsfasen vil sikkerhedsopsætningen være som beskrevet i UC-SEC-09 [SIKKERHED]. EP_KS1 autentikeres og autoriseres via certifikater. Serviceplatformen skal således tilgå KMD Social Pension med et certifikat, som beskrevet i vedlagte bilag P12_1_Snitfladebeskrivelse_v008.pdf [P12-1].] EP_PENS1 benytter Beskedfordeler som beskrevet i [SF1460_C], og er således udstillet som en fælleskommunal service, hvor Serviceplatformen er anvendersystem i det fælleskommunale støttesystem Adgangsstyring. 4.1.3.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. 4.1.3.11 Testdata og testfaciliter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] 4.1.3.12 Konfiguration Ingen 4.1.3.13 Supplerende information Ingen 4.1.4 Integrationsflow IF02: Modtag besked 4.1.4.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 ModtagBesked 3.1.3 EP_KSK1 ModtagAendringKMD 3.3.3 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 38 af 41
4.1.4.2 Integrationstype Integrationen er en orkestreringsintegration med transformation, hvor Serviceplatform agerer som beskedagent. 4.1.4.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KMD Socialpension Kommunedel Kommunal Pension Serviceplatformen Beskedfordeler Transformer 4.1.4.4 Datatransformering I transitionsfasen skal beskeder, der modtages via EP_FS1, transformeres, så de kan sendes til KMD Social Pension Kommunedel via EP_KSKP1. Det er kun de data, der indgår i snitfladen mod KMD Social Pension Kommunedel, der skal sendes videre. En besked, som modtages med formatet for beskedindhold, som beskrevet i EP_FS1 (afsnit 3.1.3.2), mappes over i en record, som specificeret i EP_KSKP1 (afsnit 3.3.3.2.1). Det er kun ændringer, hvor strukturerne for Personlig tillægsprocent, Likvidformuestruktur og Samlivsstatus er udfyldt, der skal behandles i denne integration. Mapningen fra indhold fra beskedkuvert og beskeddata i snitflade EP_PENS1 til record i snitflade EP_KSKP1 følger nedenstående tabel: Snitflade EP_PENS1 Kuvert: ObjektId Hvis Struktur Personlig tillægsprocent er udfyldt Snitflade EP_KSKP1 Tillægsprocent PERSONNUMMER TYPE = TILLÆG KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 39 af 41
Struktur Personlig tillægsprocent: start-dato START_DATO Struktur Personlig tillægsprocent: slut-dato SLUT_DATO Struktur Personlig tillægsprocent: Værdisæt VÆRDI VAERDI_TXT (feltet er tomt og afsluttes med ; ) Formue Kuvert: ObjektId PERSONNUMMER Hvis Likvidformuestruktur er udfyldt TYPE = FORMUE Struktur Likvidformuestruktur: start-dato START_DATO Struktur Likvidformuestruktur: slut-dato SLUT_DATO Struktur Likvidformuestruktur: Likvidformue, VÆRDI Værdisæt Struktur Likvidformuestruktur: Er formuen VAERDI_TXT oplyst, Værdisæt Samliv Kuvert: ObjektId PERSONNUMMER Hvis Samlivsstatus er udfyldt TYPE = SAMLIV Struktur Samlivsstatus: start-dato START_DATO Struktur Samlivsstatus: slut-dato SLUT_DATO VÆRDI = feltet udfyldes med 0,00 Struktur Samlivsstatus: Samlivsstatus værdisæt VAERDI_TXT 4.1.4.5 Datapersistering Serviceplatformen skal persistere ændringer indtil de er blevet videresendt til EP_KSK1. 4.1.4.6 Databerigelse N/A 4.1.4.7 Routing N/A 4.1.4.8 Orkestrering Serviceplatformen skal orkestrere modtagelse af besked, transformere indhold i beskedindhold til MQmessage, persistere message, uploade message til MQ-kø og slette den persisterede message, når data er bekræftet modtaget på MQ-køen. 4.1.4.9 Sikkerhed [Afklaring/KDF afklaring om sikkerhed er i gang. Der antages følgende: I transitionsfasen vil sikkerhedsopsætningen være som beskrevet i UC-SEC-10 [SIKKERHED]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 40 af 41
EP_KSK1 autentikeres og autoriseres via certifikater. Serviceplatformen skal således tilgå KMD Social Pension Kommunedel med et certifikat, som beskrevet i vedlagte P12_1_Snitfladebeskrivelse_v008.pdf [P12-1].] EP_FS1 benytter Beskedfordeler som beskrevet i [SF1460_A / SF1460_D], og er således udstillet som en fælleskommunal service, hvor Serviceplatformen er anvendersystem i det fælleskommunale støttesystem Adgangsstyring. 4.1.4.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. 4.1.4.11 Testdata og testfaciliter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] 4.1.4.12 Konfiguration Ingen 4.1.4.13 Supplerende information Ingen KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 41 af 41