Integration Integrationsbeskrivelse - version 2.2.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-12-04 PBO 0.1 Første version 2015-04-10 MMT 0.2 Klar til internt review 2015-05-05 EHE 0.5 Klar til SP 2015-06-29 MHO 0.6 Referencerettelser mm. 2015-06-29 EHE 2.1 Teknisk beskrivelse godkendt 2015-08-18 EHE 2.2.0 Reference til WSDL indarbejdet Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS- Sikkerhed] [WSDL-SP] Note vedrørende servicemål for Serviceplatformen Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://sharekomm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Integrationsbeskrivelsen refererer til SF2600 Teknisk Spec 20150818.zip som indeholder WSDL på serviceplatformen, og 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 27
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... 6 1.4 Teststrategi... 7 1.5 Tilslutning af services... 8 2 Kontekst for integrationsparter... 10 2.1 Kontekst for UDK Pension [!@UDK Pension@!]... 10 2.2 Kontekst for KY [!@KY@!]... 10 3 Specifikation for integrationsparter... 11 3.1 Specifikation af endpoints for KY [!@KY@!]... 11 3.2 Specifikation af endpoints for UDK [!@UDK@!]... 18 4 Beskrivelse for integrationsplatforme... 24 4.1 Beskrivelse for Serviceplatformen [!@Systematic@!]... 24 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 27
1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at overføre oplysninger om pensionsudbetalinger som Udbetaling Danmark (UDK) udbetaler til kommunerne, i det tilfælde, at kommunen administrerer hele eller dele af pensionen for pensionisten. De oplysninger, som overføres via snitfladen, specificerer på personniveau, hvilket beløb, der er overført fra UDK til kommunen i en given udbetalingsperiode. Selve pengeoverførslen sker som en sumoverførsel til kommunens pengeinstitut. Kommunen har behov for, at disse oplysninger på personniveau bliver registreret i Kommunernes Ydelsessystem (KY) på den enkelte administrationssag, så kommunen kan varetage opgaven med at administrere pensionistens økonomi. Denne integration foregår mellem Udbetaling Danmarks nye pensionssystem og KY. Integrationen omfatter ikke en integration imellem KMD Socialpension og KY 1.2 Overordnet forretningsflow i integrationen UDK udbetaler i dag pension direkte til kommunen for de pensionister som kommunen administrerer helt eller delvist. Arbejdsgangen i mellem KMD Socialpension og systemerne KY eller KMD Aktiv er manuel. Denne integration skal automatisere arbejdsgangen ved at understøtte at udbetalingen fra UDK Pension bliver synlig i KY. Det kan illustreres i følgende: Overførslen foretages pr. kommune for hver udbetalingsperiode, hvor UDK har overført beløbet til kommunens pengeinstitut. I figuren nedenfor indgår følgende forretningsflow i integrationen. KY udstiller en synkron service som kan modtage pensionsudbetalingsbeskeder og som kvitterer for modtagelsen. UDK Pension kalder snitfladen via gennemstilling på serviceplatformen. Der kaldes med en pensionsudbetalingsbesked for hver udbetalingsperiode for hver kommune, hvor UDK har overført beløbet til kommunens pengeinstitut. KY kvitterer for modtagelsen med et synkront svar. UDK Pension udstiller en service via Serviceplatformen som kan modtage forretningskvitteringer fra KY. KY behandler hver pensionsudbetalingsbesked asynkront og sender en forretningskvittering per pensionsudbetalingsbesked med status på behandlingen til UDK Pension. UDK Pension skal understøtte at pensionsudbetalingsbesked afsendes efter at least once princippet. Det vil sige at UDK Pension skal understøtte at pensionsudbetalingsbeskeder gensendes, såfremt der ikke modtages en kvittering. KY skal understøtte modtagelse af pensionsudbetalingsbesked Idempotent efter at least once princippet. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 27
S e r v i c e p la t f o r m en K Y Integrationsbeskrivelse SF 2600 IF01 Afsende batchbesked IF 02 Kvitter for Batchbesked Modtag og persister besked Behandling af besked Forretningskvittering Gennemstilling Gennemstilling U DK P e n s i o n Afsend batchbesked Batch Besked Modtag kvittering Udbetaling foretaget KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 27
1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Flow 1 Flow 2 Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Afklaring/KDF: Åbningstid for fagsystem kendes ikke] Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/KDF: Svartid for fagsystem kendes ikke] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. [Afklaring/KDF: Tilgængelighed for fagsystem kendes ikke] Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. [Afklaring/KDF: Spidsbelastningsperioder for fagsystem kendes ikke] 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 [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/KDF: Svartid for eksternt system kendes ikke] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] 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 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 27
Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. [Afklaring/KDF: Servicevinduer for fagsystem kendes ikke] Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 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 datafaellesskab@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.3.2.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] 1.3.2.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] 1.3.2.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 1.3.3 Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] 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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 27
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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.4.2 Test i forbindelse med produktionssætning I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.5 Tilslutning af services Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter. Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af it-systemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS- Sikkerhed]. [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] 1.5.1 Funktionalitet på Serviceplatformen Ingen identificeret. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 27
1.5.2 Generelle forhold for tilslutning til integrationspart: UDK Pension Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. 1.5.3 Generelle forhold for tilslutning til integrationspart: KY Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 27
2 Kontekst for integrationsparter 2.1 Kontekst for UDK Pension [!@UDK Pension@!] 2.1.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KY: Lovhjemmel mangler] 2.1.2 Kapacitets- og servicekrav Forventet afsendelse er 98 pensionsudbetalingsbeskeder per måned (svarende til en gang per udbetaling). Hver besked indeholder alle CPR numre for en given kommune. Tilsvarende vil der komme 98 kvitteringsbeskeder. 2.1.3 Specifikke forhold for tilslutning af system 2.2 Kontekst for KY [!@KY@!] 2.2.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KY: Lovhjemmel mangler] 2.2.2 Kapacitets- og servicekrav Forventet afsendelse er 98 batch beskeder per måned (svarende til en gang per udbetaling). Hver besked indeholder alle CPR numre for en given kommune. Tilsvarende vil der komme 98 kvitteringsbeskeder. 2.2.3 Specifikke forhold for tilslutning af system KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 27
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY [!@KY@!] Integrationen benyttes til at modtage pensionsudbetalingsbeskeder til kommunen, hvor kommunen administrerer hele eller dele af pensionen for pensionisten. Serviceplatformen udstiller en service som gennemstiller en leverance fra UDK til KY og gennemstiller en forretningsmæssige kvittering afsendt af KY til UDK. 3.1.1 Overordnet forretningslogik Serviceplatformen gennemstiller pensionsudbetalingsbesked fra UDK til KY via EP_FS1. Efter endt forretningsbehandling sender KY forretningskvittering til serviceplatformen via EP_FS2, som gennemstiller til UDK. 3.1.2 Oversigt over endpoints ID Navn EP_FS1 EP_FS2 PensionUdbetalingOplysningModtag PensionUdbetalingKvitteringSend 3.1.3 Beskrivelse af endpoint EP_FS1 - PensionUdbetalingOplysningModtag 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller KY er serviceudstiller. 3.1.3.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.1.3.1.3 Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version 1.2. 3.1.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. [Udføres/Systematic Systematic skal levere WSDL, som skal implementeres i service hos KY] Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Afklaring KY WSDL skal dannes på baggrund af [WSDL-SP]] [Afklaring/KY KDF Information skal indhentes fra KY] [Afklaring/KY KDF Information skal indhentes fra KY] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 27
Miljø: Test URI til WSDL Endpoint navn Endpoint IP [Afklaring KY WSDL skal dannes på baggrund af [WSDL-SP]] [Afklaring/KY KDF Information skal indhentes fra KY] [Afklaring/KY KDF Information skal indhentes fra KY] 3.1.3.1.5 Teknisk retning for udveksling Serviceplatformen kalder KY. 3.1.3.1.6 Dataretning for udveksling Serviceplatformen sender data til KY. 3.1.3.1.7 Service invokation / Triggers Servicen har modtaget batch fil fra UDK. 3.1.3.2 Dataspecifikation Servicen indeholder følgende felter, alle felter er mandatory. STRUKTU Element navn TYPE BESKRIVELSE Værditype R INPUT Header BeskedID Tekst Unik identifikation af beskeden. Benyttes til at identificere genfremsendelse af tidligere besked Afgøres af afsender Skal være unik for hver besked KommuneID URN/ UUID Kommunereference til støttesystemet Organisation Valid reference til myndighed i Organisation. AntalPoster Heltal u/ fortegn Angiver antal poster i beskeden. >0 Skal passe med antal detail poster i beskeden SumAfBeboeb Komma Angiver sum af beløb for alle poster i Decimalt beskeden i kr. med to decimaler al >0 Skal passe med sammetælling af alle beløb på poster BetalingsID Tekst Unik identifikation af betalingen. Afgøres af afsender Benyttes til at identificere betalingen på kommunens pengeinstitutkonto. INPUT Poster -PostID Tekst Identifikation af posteringen. Benyttes til fejlsøgning Valideres ikke KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 27
PartType Tekst Den type part der refereres til. Kun Person understøttes Skal være Person PartID Tekst Personnummer (CPR) angivet som 10 cifre uden bindestreg Gyldigt CPR-nr Beloeb Komma Udbetalt nettobeløb i kr. med to Decimalt decimaler (ingen al efterreguleringsbeløb) Skal svare til det der er indeholdt i overførsel til kommunens konto DatoFra Dato Dato for udbetaling (startperiode) Valid dato YYYYMMDD DatoTil Dato Dato for udbetaling (slutperiode) Valid dato YYYYMMDD PostTekst Tekst Beskrivende tekst for posteringen Miljø: Produktion Inputdata Outputdata [WSDL-SP] / XSD [WSDL-SP] / XSD Miljø: Test Inputdata Outputdata [WSDL-SP] / XSD [WSDL-SP] / XSD 3.1.3.3 Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.1.3.4 Leverancesikkerhed og fejlhåndtering KY skal understøtte modtagelse af beskeder Idempotent efter atleast once princippet. KY validerer ved modtagelsen, at alle felter er udfyldt med valide værdier, og at summen af Beloeb svarer til SumAfBeloeb, og at antal detailposter i beskeden svarer til AntalPoster. Der udføres ikke validering af, om de enkelte personer har en administrationsaftale i løsningen. Dette håndteres internt i løsningen og eventuelle fejl håndteres manuelt. Hvis valideringen fejler, sendes fejkode retur (ReturKode<>0), og hele beskeden ignoreres af modtageren. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 27
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 Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KDF: Åbningstid for fagsystem kendes ikke] [Afklaring/KDF: Svartid for fagsystem kendes ikke] [Afklaring/KDF: Tilgængelighed for fagsystem kendes ikke] [Afklaring/KDF: Spidsbelastningsperioder for fagsystem kendes ikke] [Afklaring/KDF: Servicevinduer for fagsystem kendes ikke] 3.1.4 Beskrivelse af endpoint EP_FS2 - PensionUdbetalingKvitteringSend 3.1.4.1 Transportspecifikation 3.1.4.1.1 Serviceudstiller Serviceplatform er serviceudstiller. 3.1.4.1.2 Serviceanvender KY er serviceanvender 3.1.4.1.3 Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version 1.2 3.1.4.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. [Systematic leverer WSDL-filer.] Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [WSDL-EXT] https://prod.serviceplatformen.dk/ [Afklaring/SP: Endelig Url skal indsættes] [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-EXT] https://exttest.serviceplatformen.dk/ [Afklaring/SP: Endelig Url skal indsættes] [Afklaring/SP: Endelig IP skal indsættes] 3.1.4.1.5 Teknisk retning for udveksling KY kalder serviceplatformen. 3.1.4.1.6 Dataretning for udveksling KY sender data til serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 27
3.1.4.1.7 Service invokation / Triggers Kommunikationen initieres af KY når KY har modtaget og verificeret 3.1.4.2 Dataspecifikation Servicen indeholder følgende felter, alle felter er mandatory. RETUR BeskedID Tekst Unik identifikation af beskeden. Benyttes til at identificere genfremsendelse af tidligere besked KommuneID UUID Kommunereference til støttesystemet Organisation AntalPoster Heltal u/ fortegn Angiver antal poster i beskeden. Kopieret fra INPUT Kopieret fra INPUT Kan anvendes til support Kopieret fra INPUT Kan anvendes til support SumAfBeboeb Komma Angiver sum af beløb for alle poster i Decimalt beskeden i kr. med to decimaler al Kopieret fra INPUT Kan anvendes til support BetalingsID Tekst Unik identifikation af betalingen. Kopieret fra INPUT Kan Benyttes til at identificere betalingen anvendes til support på kommunens pengeinstitutkonto. ReturKode Heltal m/ fortegn Kode der angiver valideringsstatus 0:OK, 1:Modtaget tidligere <0:Fejl ReturTekst Tekst Tekst der forklarer koden ovenfor Da der er tale om en gennemstillingsintegration svarer dataspecifikationen for servicen til dataspecifikationen i schema-filerne udstillet af UDK. Miljø: Produktion Inputdata Outputdata [WSDL-EXT] / XSD [WSDL-EXT] / XSD Miljø: Test Inputdata Outputdata [WSDL-EXT] / XSD [WSDL-EXT] / XSD KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 27
3.1.4.3 Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.1.4.4 Leverancesikkerhed og fejlhåndtering Der sendes en forretningskvittering for hver modtaget pensionsudbetalingsbesked. 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 Værdi Tidsrum Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Svartid Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] [SPref]. Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdag [SPref]. Servicevinduer Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. 3.1.5 Service Management 3.1.5.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.1.5.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.1.5.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 27
3.1.6 Testplan 3.1.6.1 Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.1.6.2 Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 27
3.2 Specifikation af endpoints for UDK [!@UDK@!] Integrationen benyttes til at sende pensionsudbetalingsbeskeder til kommunen, hvor kommunen administrerer hele eller dele af pensionen for pensionisten. Serviceplatformen udstiller en service som gennemstiller en leverance fra UDK til KY og gennemstiller en forretningsmæssig kvittering fra KY til UDK. 3.2.1 Overordnet forretningslogik UDK sender pensionsudbetalingsbeskeder til serviceplatformen som gennemstiller til fagsystem via EP_UDK1 UDK modtager via EP_UDK2 forretningskvittering som serviceplatformen har videre stillet fra fagsystemet. 3.2.2 Oversigt over endpoints ID EP_UDK1 EP_UDK2 Navn PensionUdbetalingOplysningSend PensionUdbetalingKvitteringModtag 3.2.3 Beskrivelse af endpoint EP_UDK1 - PensionUdbetalingOplysningSend 3.2.3.1 Transportspecifikation 3.2.3.1.1 Serviceudstiller Serviceplatformen er serviceudstiller. 3.2.3.1.2 Serviceanvender UDK er serviceanvender. 3.2.3.1.3 Teknologisk understøttelse Snitfladen implementeres som en SOAP webservice, version 1.2. 3.2.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Systematic skal levere WSDL, endpoint og IP. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] https://prod.serviceplatformen.dk/ [Afklaring/SP: Endelig Url skal indsættes] [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] https://exttest.serviceplatformen.dk/ [Afklaring/SP: Endelig Url skal indsættes] [Afklaring/SP: Endelig IP skal indsættes] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 27
3.2.3.1.5 Teknisk retning for udveksling UDK foretager kald af serviceplatformen. 3.2.3.1.6 Dataretning for udveksling UDK sender data til serviceplatformen. 3.2.3.1.7 Service invokation / Triggers Kommunikationen initieres af at UDK har indbetalt pension til kommunerne. 3.2.3.2 Dataspecifikation Servicen indeholder følgende felter, alle felter er mandatory. STRUKTU Element navn TYPE BESKRIVELSE Værditype R INPUT Header BeskedID Tekst Unik identifikation af beskeden. Benyttes til at identificere genfremsendelse af tidligere besked Afgøres af afsender Skal være unik for hver besked KommuneID URN/ UUID Kommunereference til støttesystemet Organisation Valid reference til myndighed i Organisation. AntalPoster Heltal u/ fortegn Angiver antal poster i beskeden. >0 Skal passe med antal detail poster i beskeden SumAfBeboeb Komma Angiver sum af beløb for alle poster i Decimalt beskeden i kr. med to decimaler al >0 Skal passe med sammetælling af alle beløb på poster BetalingsID Tekst Unik identifikation af betalingen. Afgøres af afsender Benyttes til at identificere betalingen på kommunens pengeinstitutkonto. INPUT Poster -PostID Tekst Identifikation af posteringen. Benyttes til fejlsøgning PartType Tekst Den type part der refereres til. Kun Person understøttes Valideres ikke Skal være Person PartID Tekst Personnummer (CPR) angivet som 10 cifre uden bindestreg Gyldigt CPR-nr KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 27
Beloeb Komma Udbetalt nettobeløb i kr. med to Decimalt decimaler (ingen al efterreguleringsbeløb) Skal svare til det der er indeholdt i overførsel til kommunens konto DatoFra Dato Dato for udbetaling (startperiode) Valid dato YYYYMMDD DatoTil Dato Dato for udbetaling (slutperiode) Valid dato YYYYMMDD PostTekst Tekst Beskrivende tekst for posteringen Miljø: Produktion Inputdata Outputdata [WSDL-SP] / XSD [WSDL-SP] / XSD Miljø: Test Inputdata Outputdata [WSDL-SP] / XSD [WSDL-SP] / XSD 3.2.3.3 Sikkerhed Sikkerheden mellem UDK og serviceplatformen er tokenbaseret, som defineret i RA STS [STS- Sikkerhed]. 3.2.3.4 Leverancesikkerhed og fejlhåndtering UDK Pension skal understøtte at beskeder afsendes efter at least once princippet. Det vil sige at UDK Pension skal understøtte at beskeder gensendes, såfremt der ikke modtages en kvittering. 3.2.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.3.5.1 Aftalt driftstid Parameter Værdi Tidsrum Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Svartid Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] [SPref]. Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdag [SPref]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 27
Servicevinduer Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. 3.2.4 Beskrivelse af endpoint EP_UDK2 - PensionUdbetalingKvitteringModtag 3.2.4.1 Transportspecifikation 3.2.4.1.1 Serviceudstiller UDK er er serviceudstiller. 3.2.4.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.2.4.1.3 Teknologisk understøttelse Snitfladen er implementeres som en SOAP webservice, version 1.2 3.2.4.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. UDK leverer WSDL, endpoint og IP. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Afklaring UDK WSDL skal dannes på baggrund af [WSDL-EXT]] [Afklaring/UDK KDF Information skal indhentes fra UDK] [Afklaring/UDK KDF Information skal indhentes fra UDK] Miljø: Test URI til WSDL Endpoint navn Endpoint IP Afklaring UDK WSDL skal dannes på baggrund af [WSDL-EXT]] [Afklaring/UDK KDF Information skal indhentes fra UDK] [Afklaring/UDK KDF Information skal indhentes fra UDK] 3.2.4.1.5 Teknisk retning for udveksling Serviceplatformen kalder UDK. 3.2.4.1.6 Dataretning for udveksling Serviceplatformen sender data til UDK. 3.2.4.1.7 Service invokation / Triggers Kommunikationen initieres når serviceplatformen har modtaget forretningsmæssig kvittering fra KY. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 27
3.2.4.2 Dataspecifikation Servicen indeholder følgende felter, alle felter er mandatory. RETUR BeskedID Tekst Unik identifikation af beskeden. Benyttes til at identificere genfremsendelse af tidligere besked KommuneID UUID Kommunereference til støttesystemet Organisation AntalPoster Heltal u/ fortegn Angiver antal poster i beskeden. Kopieret fra INPUT Kopieret fra INPUT Kan anvendes til support Kopieret fra INPUT Kan anvendes til support SumAfBeboeb Komma Angiver sum af beløb for alle poster i Decimalt beskeden i kr. med to decimaler al Kopieret fra INPUT Kan anvendes til support BetalingsID Tekst Unik identifikation af betalingen. Kopieret fra INPUT Kan Benyttes til at identificere betalingen anvendes til support på kommunens pengeinstitutkonto. ReturKode Heltal m/ fortegn Kode der angiver valideringsstatus 0:OK, 1:Modtaget tidligere <0:Fejl ReturTekst Tekst Tekst der forklarer koden ovenfor Miljø: Produktion Inputdata Outputdata [WSDL-EXT] / XSD [WSDL-EXT] / XSD Miljø: Test Inputdata Outputdata 3.2.4.3 Sikkerhed [WSDL-EXT] / XSD [WSDL-EXT] / XSD Sikkerheden mellem UDK og serviceplatformen er tokenbaseret, som defineret i RA STS [STS- Sikkerhed]. 3.2.4.4 Leverancesikkerhed og fejlhåndtering Der modtages mindst en kvittering for hver sendt besked. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 27
3.2.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.4.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] [Afklaring/KDF: Svartid for eksternt system kendes ikke] [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 3.2.5 Service Management 3.2.5.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.2.5.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.2.5.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.2.6 Testplan 3.2.6.1 Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.2.6.2 Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 27
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 0. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. EP_FS1 Serviceplatformen IF01 Afsende batchbesked EP_UDK1 KY EP_FS2 Dataretning IF02 Kvitter for batchbesked EP_UDK2 UDK Dataretning 4.1.1 Oversigt over integrationsflows ID Navn IF01 IF02 Afsend batchbesked Kvitter for batchbesked 4.1.2 Integrationsflow IF01: Afsend batchbesked 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_UDK1 PensionUdbetalingOplysningSend Afsnit 3.2.3 EP_FS1 PensionUdbetalingOplysningModtag Afsnit 3.1.3 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 27
4.1.2.2 Integrationstype Integrationen er en gennemstillingsintegration. 4.1.2.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. UDK Serviceplatform Fagsystem Synkront kald der sender oplysning om udbetalt pension fra UDK SP viderestiller kald til Fagsystemet Fagsystemet returnerer teknisk kvittering SP viderestiller kvittering til UDK EP_UDK1 EP_FS1 4.1.2.4 Datatransformering N/A 4.1.2.5 Datapersistering N/A 4.1.2.6 Databerigelse N/A 4.1.2.7 Routing N/A 4.1.2.8 Orkestrering N/A 4.1.2.9 Sikkerhed Sikkerheden er baseret på rammearkitektturens sikkerhed, som beskrevet i UC-SEC-04 [SIKKERHED] 4.1.2.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 27
4.1.2.11 Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] 4.1.2.12 Konfiguration N/A 4.1.2.13 Supplerende information Systematic skal levere WSDL-fil for KY for endpoint EP_FS1 og EP_FS2. 4.1.3 Integrationsflow IF02: Kvitter for batchbesked 4.1.3.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS2 PensionUdbetalingKvitteringSend Afsnit 3.1.4 EP_UDK2 PensionUdbetalingKvitteringModtag Afsnit 3.2.4 4.1.3.2 Integrationstype Integrationen er en gennemstillingsintegration. 4.1.3.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. UDK Serviceplatform Fagsystem Synkront kald der sender kvitteringsbesked fra fagsystemet SP viderestiller kvitteringsbesked til UDK UDK returnerer teknisk kvittering SP viderestiller kvittering til UDK EP_UDK2 EP_FS2 4.1.3.4 Datatransformering N/A KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 27
4.1.3.5 Datapersistering N/A 4.1.3.6 Databerigelse N/A 4.1.3.7 Routing N/A 4.1.3.8 Orkestrering N/A 4.1.3.9 Sikkerhed Sikkerheden er baseret på rammearkitektturens sikkerhed, som beskrevet i UC-SEC-04 [SIKKERHED] 4.1.3.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. 4.1.3.11 Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] 4.1.3.12 Konfiguration N/A 4.1.3.13 Supplerende information KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 27