Integration Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-10-24 PBO 0.1 Første version 2015-05-28 ehe 0.5 Løft af version og inkludering af wsdl 2015-05-29 ehe 0.5.1 Opdateret indlejret wsdl jf. opdatering fra ATP d.d. 2015-06-29 JJN 0.6.0 Referencerettelser mm. 2015-06-29 EHE 2.0.0 Teknisk beskrivelse indarbejdet Referencer Ref. Titel Kommentarer [SPref] [SIKKERHED] [STS- Sikkerhed] [WSDL-SP] [WSDL-EXT] [ATP1] [ATP2] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: https://share-komm.kombit.dk/p089/referencedokumenter 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 SF0800 Teknisk Spec 20150701.zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Integrationsbeskrivelsen refererer til SF0800 Bilag 20150701.zip som indeholder WSDL/XSD af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Snitfladebestilling FK KOMBIT Online webservice v10.docx Snitfladebestilling FK KOMBIT Batch v10.docx KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 21
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... 7 2 Kontekst for integrationsparter... 8 2.1 Kontekst for KY) [!@IP-KY@!]... 8 2.2 Kontekst for KSD [!@IP-KSD@!]... 9 2.3 Kontekst for ATP [!@IP-ATP@!]... 9 3 Specifikation for integrationsparter... 11 3.1 Specifikation af endpoints for KY og KSD ) [!@IP- KY@!]) [!@IP-KSD@!]... 11 3.2 Specifikation af endpoints for ATP Feriekonto [!@IP-ATP@!]... 14 4 Beskrivelse for integrationsplatforme... 19 4.1 Beskrivelse for Serviceplatformen... 19 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 21
1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med snitfladen er at tilvejebringe oplysninger om en persons feriepengesaldo samt udbetalte feriepenge. Kommunerne kan herefter fastslå om en persons feriepengesaldo og udbetalte feriepenge har indflydelse på beregningen af borgerens ydelser i Kommunernes Ydelsessystem (KY) og Kommunernes Sygedagpengesystem (KSD). Oplysninger fra ferieafholdelse for alle borgere registreres både i Arbejdsgivernes Centrale Ferieregister og i Feriekonto. Fra 1. maj 2015 returnerer snitfladen informationer om afholdt ferie fra både Arbejdsgivernes Centrale Ferieregister og Feriekonto. Dette bliver muliggjort via Feriepengeinfo projektet i ATP. 1.2 Overordnet forretningsflow i integrationen Integrationen er en synkron gennemstillingsintegration via Serviceplatformen. Fagsystemet kan foretage opslag på et Personnummer og en periode (angivet med to datoer, begge datoer indgår i perioden). Der modtages oplysninger fra ATP om indestående feriepenge og tidligere udbetalte feriepenge. Der indgår et forretningsflow i integrationen som illustreret nedenfor. Forretningsflowet udgør en synkron gennemstillingsintegration uden filtrering på Serviceplatformen. Flowet består af følgende overordnede trin: KSD/KY kalder Serviceplatformen og forespørge på et bestemt Personnummer og en ferieperiode. Serviceplatformen gennemstiller kaldet til ATP Feriekonto. ATP Feriekonto returnerer synkront svaret på forespørgslen. Serviceplatformen returnerer synkront svaret til fagsystemet. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 21
Flow 1 Hent Oplysninger fra Feriekonto for borger Serviceplatformen Fagsystem(n) Hent feriepengeoplysninger Synkron gennemstilling Modtag feriepengeoplysninger Synkron gennemstilling ATP Feriekonto Modtag bestilling Returner svar For den angivne periode modtages bl.a. følgende information per udbetaling: Dato (for ferie anmodning) Personnummer. Første feriedag (i den ønskede ferieperiode) Antal feriedage (i den ønskede ferieperiode) Beløb pr. udbetalingsdato (til udbetaling) Aktuelt ferieår på udbetalingen Saldo feriepenge (i aktuelt ferieår på udbetalingen) Saldo feriedage (i aktuelt ferieår på udbetalingen) Dispositionsdato/udbetalingsdato Udbetalingsårsag Kilde (Navnet på it-systemet som data kommer fra, Feriekonto/ACF) Status (fejlmeddelelser) Personnummer, Ferieår, Saldo feriepenge og Saldo feriedage oplyses, selv når der ikke er fundet nogen udbetalingsdato på personen i FerieKonto i den forespurgte periode. Perioden må ikke stække sig længere tilbage end 20 måneder fra den dato der forespørges på. Tidligst mulige dato er dog den 01/05-2011. Såfremt kilden til data i perioden ikke er Feriekonto, så vil feltet dispositionsdato være tomt. Se endvidere vedlagte beskrivelse Snitfladebestilling FK KOMBIT Online webservice v10.docx (ATP_1). KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 21
1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Denne sammenfatning af servicemål for den samlede integration er særligt baseret på driftsaftale for Serviceplatformen. Dette skyldes at der ikke er oplyst detaljer fra STAR/ATPs side omkring tidsrum for normal drift og tilhørende angivelse svartider eller tilgængelighed. Parameter Flow 1 Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Svartid Tilgængelighed [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] Spidsbelastningsperiode Servicevinduer 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 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. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 21
1.4 Teststrategi Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for. Der kan blive behov for deltage fra KY og KSD.] 1.4.1 Test i forbindelse med udvikling [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] 1.4.1.1 Testfaciliteter og testmiljø [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] 1.4.1.2 Testdata [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] 1.4.2 Test i forbindelse med produktionssætning [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] 1.5 Tilslutning af services Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af 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] Serviceplatformen skal tilslutte sig ATP på vegne af de kommunale myndigheder og understøtte opsætning af autentifikation via certifikater. KY og KSD skal autentificeres og autoriseres på Serviceplatformen ved at benytte det fælleskommunale støttesystem Adgangsstyring. 1.5.1 Funktionalitet på Serviceplatformen [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 21
1.5.2 Generelle forhold for tilslutning til integrationsparter: Fagsystemer 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 integrationsparter: Eksterne system [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] 2 Kontekst for integrationsparter 2.1 Kontekst for KY) [!@IP-KY@!] 2.1.1 Lovhjemmel og forvaltningsmæssigt formål Det er monopolprojektets vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformålet har dog hjemmel i Forvaltningslovens kapitel 8. Derudover gælder det, at ATP afgiver data om borgere i forbindelse med den kommunale sagsbehandling og KY har over for sin leverandør fremsat et mindstekrav om overholdelse af Persondataloven. Endeligt indhenter KY data til brug for afgørelser i forbindelse med den kommunale sagsbehandling. Dette sker altid under hensyntagen til den tavshedspligt som gælder ved videregivelse af oplysninger til en anden forvaltningsmyndighed, jf. Forvaltningsloven 28, Stk. 2, 3). Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelige og dækkene 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. Formålet med snitfladen er at tilvejebringe oplysninger om en Persons feriepenge saldo samt udbetalte feriepenge har indflydelse på beregningen af borgerens ydelse, hvorfor KY skal have adgang til denne information. 2.1.2 Kapacitets- og servicekrav KY forventes at foretage ca. 22.000-25.000 opslag om måneden, primært i forbindelse med oprettelse af nye sager, hvor der foretages opslag på borgerens økonomiske forhold. 2.1.3 Specifikke forhold for tilslutning af system Der er ikke specielle forhold for tilslutning af KY. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 21
2.2 Kontekst for KSD [!@IP-KSD@!] 2.2.1 Lovhjemmel og forvaltningsmæssigt formål Det er monopolprojektets vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformålet har dog hjemmel i Forvaltningslovens kapitel 8. Derudover gælder det, at ATP afgiver data om borgere i forbindelse med den kommunale sagsbehandling og KSD har over for sin leverandør fremsat et mindstekrav om overholdelse af Persondataloven. Endeligt indhenter KSD data til brug for afgørelser i forbindelse med den kommunale sagsbehandling. Dette sker altid under hensyntagen til den tavshedspligt som gælder ved videregivelse af oplysninger til en anden forvaltningsmyndighed, jf. Forvaltningsloven 28, Stk. 2, 3). KSD Løsningen skal, når der beregnes sygedagpenge eller sygedagpengerefusion, sikre, at der ikke bliver udbetalt sygedagpenge samtidigt med at der modtages feriepenge. Til dette formål skal KSD Løsningen have adgang til oplysninger om for hvilken periode eller hvilke dage, den sygemeldte har fået udbetalt feriepenge. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelige og dækkene 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. Formålet med snitfladen er at tilvejebringe oplysninger om en Persons feriepengesaldo samt udbetalte feriepenge har indflydelse på beregningen af borgerens ydelse, hvorfor KSD skal have adgang til denne information. 2.2.2 Kapacitets- og servicekrav KSD forventes at foretage max. 5000 opslag om måneden 2.2.3 Specifikke forhold for tilslutning af system Der er ikke specielle forhold for tilslutning af KSD. 2.3 Kontekst for ATP [!@IP-ATP@!] 2.3.1 Lovhjemmel og forvaltningsmæssigt formål Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelige og dækkene 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 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 21
skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Formålet med snitfladen er at tilvejebringe oplysninger om en Persons feriepengesaldo samt udbetalte feriepenge har indflydelse på beregningen af borgerens ydelse, hvorfor KY og KSD skal have adgang til denne information. 2.3.2 Kapacitets- og servicekrav Serviceplatformen forventes at foretage max. 30.000 opslag om måneden 2.3.3 Specifikke forhold for tilslutning af system Ingen KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 21
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY og KSD ) [!@IP- KY@!]) [!@IP-KSD@!] Formålet med snitfladen er at tilvejebringe oplysninger om udbetalte feriepenge for en konkret borger i et fagsystem, som modtager en ydelse. 3.1.1 Overordnet forretningslogik Fagsystemet kalder ATP online opslag med information om personnummer og den ønskede periode igennem Serviceplatformen. Serviceplatformen gennemstiller opslaget til ATP. ATP udfører søgningen og returnerer svaret. Serviceplatformen gennemstiller svaret til KY eller KSD. Oversigt over endpoints ID EP_FS1 Navn Endpoint til realtidsopslag til KY eller KSD 3.1.2 Beskrivelse af endpoint EP_FS1 Endpoint til realtidsopslag for fagsystemet 3.1.2.1 Transportspecifikation 3.1.2.1.1 Integrationsmønster Fagsystemet kalder en SOAP web service på Serviceplatformen. 3.1.2.1.2 Serviceudstiller Serviceplatformen er serviceudstiller. 3.1.2.1.3 Serviceanvender Fagsystemet er serviceanvender. 3.1.2.1.4 Teknologisk understøttelse Serviceplatformen er en standardiseret synkron web servicet baseret på SOAP 1.2. Servicen er udstillet som service i den fælleskommunale støttesystem Adgangsstyring og autentikerer via SAML 2.0 tokens. 3.1.2.1.5 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] Se filen [Afklaring/SP: Endelig del-uri skal indsættes] https://prod.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 11 af 21
Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] Se filen [Afklaring/SP: Endelig del-uri skal indsættes] https://exttest.serviceplatformen.dk/ [Afklaring/SP: Endelig Url skal indsættes] [Afklaring/SP: Endelig IP skal indsættes] 3.1.2.1.6 Teknisk retning for udveksling Fagsystemet sender forespørgslen og modtager data fra Serviceplatformen 3.1.2.1.7 Dataretning for udveksling Fagsystemet modtager data om afholdt ferie fra Serviceplatformen. 3.1.2.1.8 Service invokation / Triggers Fagsystemet kalder servicen, når der ønskes oplysninger om ferie for en relevant sagspart inden for en given part. 3.1.2.2 Dataspecifikation Følgende data sendes fra fagsystemet: Periode o o Start-dato for periode (dato indgår i periode) Slut-dato for periode (dato indgår i periode) Personen der ønskes information om udbetalingsdatoer på o Personnummer. Ved forespørgslen kan fagsystemet kun angive én periode for udbetalingsdatoer, og der kan kun forespørges på ét Personnummer ad gangen. Perioden må ikke stække sig længere tilbage end 20 måneder fra den dato der spørges. Svardata kan indeholde flere udbetalinger, hvis der er registreret perioder med afholdt ferie inden for den forespurgte periode. Data vil være ordnet efter udbetalingsdato, med følgende informationer pr. udbetalingsdato: Dato (for ferie anmodning) Personnummer Første feriedag (i den ønskede ferieperiode) Antal feriedage (i den ønskede ferieperiode) Beløb pr. udbetalingsdato (til udbetaling) Aktuelt ferieår på udbetalingen Saldo feriepenge (i aktuelt ferieår på udbetalingen) Saldo feriedage (i aktuelt ferieår på udbetalingen) Dispositionsdato/udbetalingsdato Der er behov for 3 yderligere felter i svardata: Udbetalingsårsag KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 21
Kilde Status (fejlmeddelelser) Personnummer, Ferieår, Saldo feriepenge og Saldo feriedage oplyses altid, når der ikke er fundet nogen udbetalingsdato på personen i den forespurgte periode. Det bemærkes, at hvis ferieår overlapper hinanden, så kan der forekomme levering af oplysninger om udbetalinger fra to forskellige ferieår til den periode der spørges på. Se interfacespecifikationer i [WSDL-SP] 3.1.2.3 Sikkerhed Servicen udstilles af Serviceplatformen og udstilles via det fælleskommunale støttesystem Adgangsstyring. Dette svarer til sikkerhedsmønsteret UC-SEC-04. 3.1.2.4 Leverancesikkerhed og fejlhåndtering Serviceplatformen vil returnere fejl til fagsystemet som modtages af ATP. Såfremt der er fatale fejl på forbindelsen ved gennemstilling, så vil der returneres en forbindelsesfejl. Fagsystemet har ansvaret for at gentage forespørgslen. 3.1.2.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.2.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. 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] Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage 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. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 21
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. 3.1.3 Service Management 3.1.3.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.1.3.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.1.3.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.1.4 Testplan 3.1.4.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.1.4.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. 3.2 Specifikation af endpoints for ATP Feriekonto [!@IP-ATP@!] Integrationen benyttes til at tilvejebringe oplysninger om udbetalte feriepenge for en konkret borger i Kommunernes Sygedagpengesystem (KSD) eller Kommunernes Ydelsessystem (KY), som modtager en ydelse. 3.2.1 Overordnet forretningslogik Serviceplatformen sender en forespørgsel på vegne af fagsystemet ATP modtager forespørgslen, udfører søgningen og returnerer 3.2.2 Oversigt over endpoints ID Navn EP_ATP1 Endpoint til realtidsopslag til KY eller KSD, jf. afsnit 3.1 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 21
3.2.3 Beskrivelse af endpoint EP_ATP1 Endpoint til realtidsopslag til ATP Serviceplatformen kalder en web service hos det ATP og modtager svar retur 3.2.3.1 Transportspecifikation 3.2.3.1.1 Integrationsmønster Serviceplatformen gennemstiller synkront til fagsystemet og returnerer svaret. 3.2.3.1.2 Serviceudstiller ATP er serviceudstiller. 3.2.3.1.3 Serviceanvender Serviceplatformen er serviceanvender 3.2.3.1.4 Teknologisk understøttelse Snitfladen er implementeret som en SOAP 1.2 webservice. 3.2.3.1.5 Teknisk endpoint Indehold af wsdl-fil fra atp findes in [WSDL-EXT] Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Afklaring/KDF: Info fra ATP] [Afklaring/KDF: Info fra ATP] [Afklaring/KDF: Info fra ATP] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL [[Afklaring/KDF: Info fra ATP] Endpoint navn [Afklaring/KDF: Info fra ATP] Endpoint IP [Afklaring/KDF: Info fra ATP] 3.2.3.1.6 Teknisk retning for udveksling Serviceplatformen kalder web service udstillet af ATP. 3.2.3.1.7 Dataretning for udveksling ATP leverer data til Serviceplatformen på baggrund af en forespørgsel. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 21
3.2.3.1.8 Service invokation / Triggers Servicen kaldes af Serviceplatformen, når der modtages en forespørgsel fra fagsystemet via EP_FS1. 3.2.3.2 Dataspecifikation Integrationen er en gennemstilling. Dataspecifikationen er derfor som beskrevet i afsnit 3.1.2.2. Se desuden skemaer i indlejrede zip-fil med skemaer under 3.2.3.1.5 Teknisk endpoint. 3.2.3.3 Sikkerhed Serviceplatformen kalder web service udstillet af ATP og autentificerer med OCES certifikater. Dette svarer til sikkerheds use case UC-SEC-06. 3.2.3.4 Leverancesikkerhed og fejlhåndtering Såfremt der er fejl på forbindelsen ved gennemstilling, så vil Serviceplatformen returneres en forbindelsesfejl. Serviceplatformen vil returnere en fejl fra EP_ATP1 til fagsystemet via EP_FS1. Fagsystemet må herefter gentage forespørgslen. På transportniveau anvendes standard HTTP-fejlkoder. På kommunikationsniveau anvendes SOAP fejl- og statuskoder. De konkrete soap faults aftales ved implementering. Ved modtagelse af data betragtes følgende situationer som applikations- / input fejl af ATP: Startdato for perioden 1. Tilfælde hvor der mangler startdato til perioden. 2. Tilfælde hvor startdatoen er udfyldt, men datoformatet ikke er overholdt. 3. Tilfælde hvor startdatoen ligger før den tidligste tilladte startdato, den 01.05.2011 Denne fejlmeddelelse går forud for nr. 4 om de 20 tilladte måneder. 4. Tilfælde hvor startdatoen går længere tilbage end de 20 tilladte måneder. Der regnes 20 måneder tilbage fra den 1. i indeværende måned, uafhængigt af hvilken dag i måneden der spørges. Eksempel: Hvis en kommune spørger den 15. oktober 2013 på ferieoplysninger på et CPR-nr. vil den tidligst mulige startperiode i forespørgslen være den 1. februar 2012. Slutdato for perioden 5. Tilfælde hvor der mangler slutdato til perioden. 6. Tilfælde hvor slutdatoen er udfyldt, men datoformatet ikke er overholdt. 7. Tilfælde hvor startdatoen ligger efter slutdatoen. 8. Tilfælde hvor start- og slutdato udgør en periode der overstiger 20 måneder. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 21
Eksempel: Hvis en kommune spørger den 15. oktober 2012 på ferieoplysninger på et antal CPR-numre med startdato den 1. august 2011 vil den seneste slutdato således være den 1. april 2012. 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 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [KDF, afklares med ATP] [KDF, afklares med ATP] [KDF, afklares med ATP] [KDF, afklares med ATP] [KDF, afklares med ATP] 3.2.4 Service Management 3.2.4.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.2.4.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.2.4.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.2.5 Testplan 3.2.5.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.2.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. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 21
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 21
4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. ATP Feriepengeinfo EP_ATP1 IF01 Serviceplatformen EP_FS1 Fagsystem(n) 4.1.1 Oversigt over integrationsflows ID Navn IF01 Hent feriekontooplysninger for borger 4.1.2 Integrationsflow IF01: Hent feriekontooplysninger for borger 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på Endpoint Dokument-reference EP_FS1 Endpoint til realtidsopslag for fagsystemet Afsnit 3.1.2 EP_ATP1 Endpoint til realtidsopslag til ATP Afsnit 3.2.3 4.1.2.2 Integrationstype Integrationen er en gennemstillingsintegration. 4.1.2.3 Diagram over integrationsflowet Fagsystemet forespørger Serviceplatformen Jf. figuren nedenfor indgår følgende integrationsflows i IF01. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 21
Fagsystemet Serviceplatformen ATP Konverter token til certifkat Returner svar Returner svar 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 Serviceplatformen skal benytte tokens fra det fælleskommunale støttesystem Adgangsstyring for autentificere fagsystemet ved adgang til EP_FS1 Serviceplatformen skal benytte OCES certifikater til autentificere ved adgang til ATP web service (EP_ATP1). 4.1.2.10 Logning Der er ikke særlige krav til logning. 4.1.2.11 Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 21
4.1.2.12 Konfiguration Ingen særlige krav til konfiguration. 4.1.2.13 Supplerende information Ingen KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 21