Integration SF1590_C - ØiR - Afsend udbetalingsanmodninger til ØiR (Udbetalinger) Integrationsbeskrivelse - version

Transkript

1 Integration SF1590_C - ØiR - Afsend udbetalingsanmodninger til ØiR (Udbetalinger) Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Dato Initialer Version Kommentarer EDM 0.1 Første version MMT [WSDL-SP] Timestamp ændret efter følgende ændringer: Filer som ikke har noget med 1590C er slettet EDM Opdeling i StraksUdbetaling (P13-3) med gennemstilling til KMD Udbetaling samt BatchUdbetaling via SFTP til KMD Udbetaling i G68 format. Hel snitfladebeskrivelsen er skrevet om EDM Opdateret triggerfil i afsnit PMU Tilbageførsel til ren KMD model PSK Note: KMD har udgivet GF415001Q i ny version (1.3). WSDL og integrationsbeskrivelse er opdateret tilsvarende. Referencer Ref Titel Kommentarer [SPref] Integrationsbeskrivelse Relevans [SIKKER- HED] [STS-Sikkerhed] [SFTP] [WSDL-SP] [WSDL-EXT] Bilag 7B Ydelser og servicemål for Serviceplatformen Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Integrationsbeskrivelsen refererer til SF1590_C Teknisk Spec v SF1590_C Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link Integrationsbeskrivelsen refererer til SF1590_C Bilag v SF1590_C Bilag zip som indeholder WSDL/WADL/XSD af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link Indeholder [G68] og [GF415001Q] som er tilpasset P13-3. KOMBIT A/S Halfdansgade København S CVR Side 2 af 34

3 [G68] GF200001Q-version-12_ pdf Beskrivelse af G68 format er placeret i [WSDL-EXT] [GF415001Q] GF415001Q Snitfladebeskrivelser til Straksudbetalinger KMD Udbetaling. Beskriver nuværende snitflader som skal tilpasses de nye fagsystemer af KMD (P13-3). Er placeret i [WSDL-EXT], filnavn: GF415001Q Webservice Straksudbetalinger til KMD Udbetaling - version gældende fra KMD-Udbetaling-Service- Straksudbetalinger-KMD-v pdf. KOMBIT A/S Halfdansgade København S CVR Side 3 af 34

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration Kontekst for integrationsparter Kontekst for KY [!@KY@!] Kontekst for KSD [!@KSD@!] Kontekst for KMD Udbetaling [!@KMDU@!] Specifikation for integrationsparter Specifikation af endpoints for KY, KSD [!@KY@!][!@KSD@!] Specifikation af endpoints for KMD Udbetaling [!@KMDU@!] Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 4 af 34

5 1 Overordnet beskrivelse 1.1 Integrationens formål ØiR Økonomi i Rammearkitekturen indeholder en række snitflader, som benyttes af fagsystemerne til at give en ensartet snitflade mod de bagvedliggende ERP-systemer til håndtering af finans- og debitorposteringer samt udbetalinger. Denne integration dækker udbetalingsanmodninger til KMD Udbetaling. 1.2 Overordnet forretningsflow i integrationen Integrationen understøtter dataoverdragelse af udbetalingsanmodninger fra et fagsystem til KMD Udbetaling. Der er to former for udbetalinger straksleverance (udbetaling fra dag til dag) og batchleverance (2-3 dages gennemløbstid). Straksleverancer sendes direkte til en webservice på KMD Udbetaling også kaldet P13-3 straksudbetaling, hvor der modtages en kvittering tilbage med det samme. Batchleverancer opsamles i fagsystemerne og omdannes til et tilpasset 1 filformat, kaldet G68 filformat, som understøttes af KMD Udbetaling. Filen overføres med SFTP i filformatet G68 til KMD Udbetaling, og overdragelsen sker her uden forretningskvitteringer, da KMD Udbetaling ikke understøtter dette. Jf. figuren nedenfor indgår følgende 2 forretningsflow i integrationen. Straksleverance Batchleverance Udbetalingsflowet starter, når et fagsystem har behov for at udbetale penge. I fagsystemet besluttes det, om det er en straksleverance eller en batchleverance. Straksleverancer afsendes enkeltvis på en gennemstillingsservice på Serviceplatformen til KMD Udbetaling (Kaldet P13-3 snitfladen for straksudbetalinger), som sender en modtagelseskvittering retur til fagsystemet synkront. Dette er vist i nedenstående flow. 1 Formatet er tilpasset til de nye fagsystemer, hvor bl.a. kommunenummer bliver erstattet med CVR-nummer. KOMBIT A/S Halfdansgade København S CVR Side 5 af 34

6 Udbetalingsflow Straksleverance Fagsystem(n) Afsende udbetalingsanmodning ØiR (Serviceplatform) Gennemstil KMD Udbetaling Modtage udbetalingsanmodning Batchleverancer opsamles af fagsystemet i en fil i et tilpasset G68 format og overføres periodisk til Serviceplatformens SFTP server (Use Case 1) [SFTP], hvor de placeres i afsenders udbakke sammen med en trigger-fil. Når Serviceplatformen ser trigger-filen, startes processen, hvor filerne flyttes fra afsenders udbakke til modtager indbakke. Når SFTP-serveren placerer batchleverancefilerne i modtagers indbakke, dannes en transportkvittering i afsenders indbakke. Fagsystemerne har ansvaret for at hente og tjekke denne kvittering, da den kan indeholde fejl og derfor kræver gensendelse af filerne. Fagsystemerne sletter kvitteringsfiler og angiver hermed at disse er modtaget og forstået. Tilsvarende afhenter KMD Udbetaling periodisk batchleverancefilerne fra Serviceplatformens SFTP server. KMD Udbetaling understøtter ikke forretningskvitteringer, hvorfor fejl i udbetalinger skal håndteres manuelt i KMD Udbetaling, som det også sker i dag. Endvidere er daglig afstemning i kommunen på tværs af fagsystem, økonomisystem og KMD Udbetaling nødvendig for at sikre at det er den korrekte og forventede sumudbetaling, der er bestilt i KMD Udbetaling. KMD Udbetaling sletter til sidst de modtagne file, hvilket også er KMD Udbetalings accept på overtagelsen af data-ansvaret. Dette logges i Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 6 af 34

7 Dette er vist i nedenstående flow. Udbetalingsflow Batchleverance ØIR (Serviceplatform) Fagsystem Dan udbetalingsfil og triggerfil Overfør filer Modtag fil i afsenders SFTPfolder Overfør fil til modtagers SFTP-folder Modtag fil i modtagers SFTP-folder Hent SFTP kvittering Modtag kvittering i afsenders SFTP-folder KMD Udbetaling Periodisk Hent og slet filer i SFTPfolder Valider fil Ved fejl opret incident KOMBIT A/S Halfdansgade København S CVR Side 7 af 34

8 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Udbetalingsflow - straksleverance Udbetalingsflow - batchleverance Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. KMD Udbetaling er åben alle årets dage fra kl. 00:00 til 24:00. Aftalt driftstid er fra kl. 08:00 til kl alle arbejdsdage. 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 KMD udbetaling har svartiden ved en belastning på 100 webservicekald pr. minut ikke overskrider 1,75 sekund i 95% af tilfældene ded dette opgavemix af forretningsprocesser: 50% Straksudbetalinger, 35% HentUdbetaling, 10% Kreditorinfo, 5% UdbetalendeEnheder. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. KMD udbetaling har servicemålet min. 98,0 % og reguleres årligt. Kan max. være 99,0 %. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KMD udbetaling i driftstiden 08:00 til 17:00 på arbejdsdage. Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00 - Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. KMD Udbetaling er åben alle årets dage fra kl. 00:00 til 24:00. Aftalt driftstid er fra kl. 08:00 til kl alle arbejdsdage. N/A for SFTP. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. KMD udbetaling har servicemålet min. 98,0 % og reguleres årligt. Kan max. være 99,0 %. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KMD udbetaling i driftstiden 08:00 til 17:00 på arbejdsdage. Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00 - KOMBIT A/S Halfdansgade København S CVR Side 8 af 34

9 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]. KMD udbetaling varsler servicevinduer på kundenet.kmd.dk. Nye releases varsles med mindst 5 dage og nye versioner med mindst 30 dage. Servicevinduer er normalt udenfor driftstid. 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]. KMD udbetaling varsler servicevinduer på kundenet.kmd.dk. Nye releases varsles med mindst 5 dage og nye versioner med mindst 30 dage. Servicevinduer er normalt udenfor driftstid Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til SPTest@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere. 1.4 Teststrategi Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer 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. KOMBIT A/S Halfdansgade København S CVR Side 9 af 34

10 Testdata 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. 1.5 Forudsætninger for produktionssætning af integration Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter Forudsætninger for funktionalitet på Serviceplatformen Forudsætningen for at kunne integrere via SFTP løsningen på Serviceplatformen er at integrationspartnerne skal være oprettet som bruger på Serviceplatformen, og systemet skal være registreret med et certifikat. Simpel SFTP skal vælges for hver af systemerne, og der skal angives SFTP bruger og public nøgle. For yderligere information vedrørende anvendelse, se Vejledning til Serviceplatformens SFTP Service, som er tilgængelig på serviceplatformens informationssider Generelle forsætninger for tilslutning af ny integrationspart: KY og KSD Fagsystemerne skal, for at kunne levere information til KMD Udbetaling, dels registre systemet, men også de SFTP brugere, der skal anvendes i kommunikationen. Tilsvarende skal KMD Udbetaling være oprettet som bruger på Serviceplatformens SFTP-server, og denne bruger skal være kendt af fagsystemet for at kunne opbygge trigger-fil korrekt. Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for 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]. Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. KOMBIT A/S Halfdansgade København S CVR Side 10 af 34

11 1.5.3 Generelle forhold for tilslutning til integrationspart: KMD Udbetaling Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for 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]. KMD Udbetaling Straksudbetaling tilgås med et FOCES certifikat per kommune, som hver er tilknyttet en KMD bruger i KSP-CICS med rettigheder til KMD Udbetaling og adgang til alle operationer i webservicen, som beskrevet i [GF415001Q] kapitel 9 Sikkerhed. Til brug for adgang til batchudbetaling benyttes Serviceplatformens SFTP-server (jf. UC-01). Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. KOMBIT A/S Halfdansgade København S CVR Side 11 af 34

12 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Kommunens datavideregivelse af betalingsordre til KMD Udbetaling via ØiR SF1590C følger lov om offentlige betalinger m.v. jf. lov nr af 27. december 2003, med de ændringer, der følger af 1 i lov nr. 527 af 24. juni 2005, 1 i lov nr. 449 af 22. maj 2006, 5 i lov nr. 346 af 18. april 2007 og lov nr. 503 af 6. juni 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 er at kunne udbetale penge, ofte i form af ydelser til borgere Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart KY har en forventet volumen for snitfladen er estimeret til overførsler per måned. Der foretages typisk masseudbetalinger med stor volumen sidst på måneden for forsørgelsesydelserne. Dertil kan der udbetales dagligt, typisk for enkeltydelser og dag-til-dag udbetalinger. [Afklaring/KDF Fordeling mellem straks- og masseudbetaling] Specifikke forudsætninger for tilslutning af denne integrationspart Ingen identificeret. 2.2 Kontekst for KSD [!@KSD@!] Lovhjemmel og forvaltningsmæssigt formål Kommunens datavideregivelse af betalingsordre til KMD Udbetaling via ØiR SF1590C følger lov om offentlige betalinger m.v. jf. lov nr af 27. december 2003, med de ændringer, der følger af 1 i lov nr. 527 af 24. juni 2005, 1 i lov nr. 449 af 22. maj 2006, 5 i lov nr. 346 af 18. april 2007 og lov nr. 503 af 6. juni 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 er at kunne udbetale penge, ofte i form af ydelser til borgere. KOMBIT A/S Halfdansgade København S CVR Side 12 af 34

13 2.2.2 Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart KSD forventer max overførsler per mdr. Der foretages typisk masseudbetalinger med stor volumen sidst på måneden for forsørgelsesydelserne. Dertil kan der udbetales dagligt, typisk for enkeltydelser og dag-til-dag udbetalinger. [Afklaring/KDF Fordeling mellem straks- og masseudbetaling] Specifikke forsætninger for tilslutning af denne integrationspart Ingen identificeret. 2.3 Kontekst for KMD Udbetaling Lovhjemmel og forvaltningsmæssigt formål Ej relevant Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart TBD Specifikke forsætninger for tilslutning af denne integrationspart Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 13 af 34

14 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY, KSD Integrationen benyttes til at sende udbetalingsanmodninger fra fagsystemer via ØiR (Serviceplatformen) til KMD Udbetaling Overordnet forretningslogik Serviceplatformen udstiller en gennemstillingsservice til håndtering af straksleverancer mod KMD Udbetaling, som fagsystemet kalder på endpoint EP_FS1. KMD Udbetaling Straksudbetaling leverer en kvittering retur til fagsystemet, som fortæller om leverancen lykkedes eller om der var fejl. Serviceplatformen udstiller også en SFTP service, hvor fagsystemerne kan overføre batchleverancer i G68 format til KMD Udbetaling på endpoint EP_FS2. KMD Udbetaling giver ingen kvitteringer på disse leverancer, og fagsystemet får kun en transportkvittering på SFTP server, om at leverancen er overdraget til KMD Udbetaling på SFTP-serveren. Fagsystemet skal kontrollere denne for fejl og efterfølgende slette den, som kvittering for modtagelse. Ved fejl retter fagsystemet fejlen og gensender filerne Oversigt over endpoints ID Navn EP_FS1 StraksUdbetaling Operationer: EP_FS1_OP1: Opret EP_FS12_OP2: Tjek EP_FS1_OP3: GenudskrivBilag EP_FS2 BatchLeverance Beskrivelse af endpoint EP_FS1 - StraksUdbetaling Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version 1.2. KOMBIT A/S Halfdansgade København S CVR Side 14 af 34

15 Teknisk endpoint Da det er en ren gennemstilling til KMD Udbetaling vil Serviceplatformen udstille de samme 3 operationer som KMD Udbetaling: Opret opretter straksudbetaling Tjek kontrollerer straksudbetaling GenudskrivBilag genudskriver bilag som defineret i [WSDL-EXT]. Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL [WSDL-SP]..\wsdl\StraksUdbetalingService.wsdl Endpoint navn Endpoint IP [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Miljø: Test URI til WSDL [WSDL-SP]..\wsdl\StraksUdbetalingService.wsdl Endpoint navn Endpoint IP [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Teknisk retning for udveksling Fagsystemet kalder webservicen på Serviceplatformen Dataretning for udveksling Fagsystemet sender udbetalingsanmodninger til Serviceplatformen og modtager forretningskvitteringer i svaret Service invokation / Triggers Kommunikationen initieres af, at fagsystemerne har nye anmodninger, som skal overføres til KMD Udbetaling. KOMBIT A/S Halfdansgade København S CVR Side 15 af 34

16 Dataspecifikation Dataspecifikationen er beskrevet med KMD Udbetalings GF415001Q Straksudbetalinger tilpasset.wsdl [WSDL-EXT]. I denne tilpassede version er følgende ændret for at tilpasse id er til de nye fagsystemer: DataLeverandoerId ændres fra SHORT til GUID (UUID for fagsystem) AdministrativEnhedsId ændres fra INT til GUID (UUID for den administrative enhed) organisation ( <xs:complextype name="organisation"> <xs:sequence> <xs:element minoccurs="0" name="andenkommunalorganisationsid" type="xs:short"/> <xs:element minoccurs="0" name="andenregionalorganisationsid" type="xs:short"/> <xs:element minoccurs="0" name="ministeriumsid" type="xs:short"/> <xs:element minoccurs="0" name="primaerkommuneid" type="xs:short"/> <xs:element minoccurs="0" name="privatvirksomhedsid" type="xs:short"/> <xs:element minoccurs="0" name="regionsid" type="xs:short"/> <xs:element minoccurs="0" name="selvejendeinstitutionsid" type="xs:short"/> <xs:element minoccurs="0" name="statsinstitutionsid" type="xs:short"/> </xs:sequence> </xs:complextype> ) ændres: PrimaerKommuneId ændres fra SHORT til STRING (urn:oio:cvr:nnnnnnnn) sådan er CVR-nummer repræsenteret i WSDL i forvejen og de øvrige elementer fjernes. Desuden skal der tilpasses med Serviceplatformens standard CallContext, hvor fagsystemet skal udfylde CallersServiceCallIdentifier med transaktionsid for udbetalingen til logning i Serviceplatformen. GUID/UUID er 36 tegn langt og repræsenterer et 128 bit unikt id vist i formatet xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx som f.eks. 9d3e799b-1d25-4c1f f1db9a9c. Dataspecifikationene er detaljeret i [GF415001Q] Sikkerhed Adgangen mellem fagsystem og servicen på Serviceplatformen understøttes af den fælles-kommunale SAML-token-baserede sikkerhed Leverancesikkerhed og fejlhåndtering Servicen er en gennemstillingsservice til KMD Udbetaling. Serviceplatformen sørger på at gennemstille request og response. Ved fejl returer KMD Udbetaling fejlkoder i responset. Det er fagsystemernes ansvar at rette fejl i anmodninger til KMD Udbetaling og sende igen. KOMBIT A/S Halfdansgade København S CVR Side 16 af 34

17 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi 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 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. 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 Beskrivelse af endpoint EP_FS2 - BatchLeverance Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som PUT på Serviceplatformens SFTP-server (jf. Løsningsmodel 1). Der skal altid leveres to filer i afsenders indbakke; en fil med data i et tilpasset G68 format [G68] og en trigger-fil med routing information. Serviceplatformens SFTP-server leverer en transport-kvittering i afsenders indbakke, når filerne er overført til modtagerens udbakke. Fagsystemerne skal KOMBIT A/S Halfdansgade København S CVR Side 17 af 34

18 hente disse kvitteringer for at tjekke om transporten er sket korrekt. Fagsystemerne skal slette kvitteringer for at kvittere for modtagelsen. Serviceplatformen adviserer afsender, hvis der ligger filer i ind- og udbakke Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion SFTP platform: Host IP SFTP bruger: KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] KSD_SFTPSIMPEL Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host IP SFTP bruger: KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Teknisk retning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne Dataretning for udveksling Fagsystemet overfører udbetalingsanmodninger til KMD Udbetaling via SFTP-server på Serviceplatformen Service invokation / Triggers Kommunikation initieres af, at fagsystemet har nyt dataudtræk af udbetalingsanmodninger, der skal overføres til KMD Udbetaling Dataspecifikation Data omfatter en datafil med udbetalingsanmodninger,en triggerfil samt teknisk kvitteringsfil Datafil Specifikation af dataelementer i det endelige dataudtræk er kendt (G68 format) og tilpasses til de nye fagsystemer. G68 filformatet, beskrevet i [G68], og tilpasses med følgende felters indhold for at kunne benyttes til de nye fagsystemer: 01 ADM_ENHEDS_ID ændres fra max. 10 cifre til GUID (UUID for administrativ enhed 128 bit / 32 hex karakterer i 36 tegns format) KOMBIT A/S Halfdansgade København S CVR Side 18 af 34

19 02 ORGANISATIONS_ID ændres fra 4 cifre til urn:oio:cvr:nnnnnnnn (Kommunens CVR-nummer) 05 DATA_LEVERANDØR_ID ændres fra 4 cifre til GUID (UUID for fagsystem 128 bit / 32 hex karakterer i 36 tegns format) samt EBRUGER = ORGANISATIONS_ID = 4 cifre til urn:oio:cvr:nnnnnnnn (Kommunens CVR-nummer). GUID/UUID er 36 tegn langt og repræsenterer et 128 bit unikt id vist i formatet xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx som f.eks. 9d3e799b-1d25-4c1f f1db9a9c. Fagsystemet opretter og navngiver filen. Encoding er [KDF: UTF8]. Filnavn angives ud fra følgende standard: [Brugernavn]_Udbetalinger_[Løbenummer].xml [Brugernavn] [Løbenummer] : Fagsystemets SFTP brugerident, fx KY-SIMPEL-SFTP-1 : Skal sikre unikt filnavn, fx UUID eller sekvensnummer. Fagsystemets ansvar. Der kan ikke samtidig være flere filer med samme filnavn. Det er ikke tilladt at anvende ekstensionen.trigger Triggerfil Fagsystemet danner triggerfilen. Encoding er [UFT8]. Samme filnavn som datafilen. Filtypen er.trigger. Filnavn: [Brugernavn]_Udbetalinger_[Løbenummer].trigger Eksisterende produktionsversion Niveau Feltnavn Kar dinalitet Format Værdisæt / note 1 FileContentDescriptorType 61 1 Complex elementany 1 <InfRef> SF1590_C_IF02 </InfRef> 2 <SenderIt-system> [UUID (FagsystemID)] </SenderIt-system> = SF1590_C_IF02 Udbetaling:AfgivendeIt-system KOMBIT A/S Halfdansgade København S CVR Side 19 af 34

20 Format 3 <SenderAuthority> [urn:oio:cvr:nnnnnnnn] </SenderAuthority> 4 <TransactionId> [UUID] </TransactionId> 5 <SenderTimestamp> [DateTime] </SenderTimestamp> 6 <RecipientAuthority> [urn:oio:cvr:nnnnnnnn] </RecipientAuthority> Værdisæt / note Udbetaling:AfgivendeMyndighed Udbetaling:TransaktionsID Udbetaling:Tidsstempel Niveau Feltnavn Kar dinalitet Udbetaling:BogforingsansvarligMyndighed 1 RoutinginformationFileDescriptorType 1 Complex element - FileName 1 String Navn på den korresponderende datafil. - SizeInBytes 1 Integer Størrelse af datafil - Sender 1 String(250) SFTP-UC1-Bruger gældende for AfgivendeIt-system, [FS-x]. - SendersFileId 1 Udbetalingsanmodning - Recipients 1 String(250) SFTP-UC1-Bruger gældende for [KMD Udbetaling] Revideret version (forventet) Niveau Feltnavn Kar dinalitet Format Værdisæt / note 1 FileContentDescriptorType 1 Complex element 2 - FileName 1 String(255) Navn på den korresponderende datafil. 2 - FileContent 1 String(255) = Udbetalingsanmodning 2 - SizeInBytes 1 Integer Størrelse af datafil KOMBIT A/S Halfdansgade København S CVR Side 20 af 34

21 Niveau Feltnavn Kar dinalitet Format Værdisæt / note 2 - TransactionID 1 UUID Udbetaling:TransaktionsID 2 - Timestamp 1 DateTime Udbetaling:Registreringstidspunkt 2 - Any 0..* N/A Anvendes ikke 1 Routinginformation 1 Complex element 2 - IntRef 1 String(255) = SF1590_C_IF02 Angiver den brugervendte nøgle, som repræsenterer en integration, som dataudvekslingen vedrører 2 - Sender 1 String(250) SFTP-UC1-Bruger gældende for AfgivendeIt-system, [FS-x]. 2 - SenderAuthority 1 String(255) / urn:oio:cvr:nnnnnnnn Udbetaling:AfgivendeMyndighed 2 - SenderIt-system 1 UUID Udbetaling:AfgivendeIt-system 2 - RecipientAuthority 1 String(255) / urn:oio:cvr:nnnnnnnn Udbetaling:AfgivendeMyndighed 2 - Recipient 1 String(250) SFTP-UC1-Bruger gældende for [KMD Udbetaling] Teknisk kvitteringsfil Fagsystemet henter i sin In-mappe på SFTP-servicen en teknisk transportkvittering. Samme filnavn som datafilen. Filtypen er.receipt. Filnavn: [Brugernavn]_Udbetalinger_[Løbenummer].receipt Beskrivelsen findes på [SFTP]. Encoding er [UTF8] Sikkerhed Sikkerheden mellem fagsystemerne og Serviceplatformens SFTP-server er SSH-baseret [SFTP] Leverancesikkerhed og fejlhåndtering Hvis datafil og triggerfil kan korrekt håndteres af SFTP-servicen, vil SFTP-servicen fjerne disse fra fagsystemets out-mappe og danne en teknisk transportkvittering som dokumentation for, at SFTPservicen har overtaget transportansvaret. KOMBIT A/S Halfdansgade København S CVR Side 21 af 34

22 Fagsystemet har ansvar for løbende at kontrollere for modtagelse af teknisk transportkvittering i sin in-mappe. Fagsystemet kvitterer for modtagelse af teknisk transportkvittering ved at slette den fra sin in-mappe. Hvis overtagelsen ikke blev gennemført succesfuldt vil det fremgå af den tekniske transportkvittering. Igen kvitterer fagsystemet for modtagelsen af denne ved at slette den. Fagsystemet har ansvaret for at genfremsende datafil med finansposteringer efter korrektion. Datafil og triggerfil skal have nyt løbenummer. Oprydning af fejlbehæftede datafil og triggerfil sker ved incident håndtering til Serviceplatformens helpdesk. Serviceplatformen vil løbende monitorere fagsystemet in- og out-mapper. Der vil blive rejst en incident (via rapportering) til fagsystemet, hvis der ligger ubehandlede filer i mere end [2 døgn] Servicemål KMD Udbetaling skal løbende hente datafiler fra SFTP-servicen, som minimum skal der afhentes [1 gang i døgnet]. KMD Udbetalings indbakke på SFTP-servicen vil bliver monitoreret af Serviceplatformen. Der vil blive rejst en incident over for KMD Udbetaling, såfremt datafiler ikke afhentes inden for det aftalte tidsrum. KMD Udbetaling skal umiddelbart herefter igangsætte validering af de modtagne udbetalingsanmodninger Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. N/A for SFTP. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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 København S CVR Side 22 af 34

23 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] Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til SPTest@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere Testplan Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.2 Specifikation af endpoints for KMD Udbetaling [!@KMDU@!] Integrationen benyttes til at modtage udbetalingsanmodninger fra fagsystemer gennem Serviceplatformen (ØiR) Overordnet forretningslogik Straksleverancer gennemstiller Serviceplatformen synkront fra fagsystemerne til KMD Udbetaling på endpoint EP_KU1. KMD Udbetaling returnerer synkront forretningskvittering, som gennemstilles til fagsystemet. Batchleverancer afhentes af KMD Udbetaling i en tilpasset G68-formateret fil på Serviceplatformens SFTP-server, i KMD Udbetalings indbakke gennem endpoint EP_KU2, hvor en trigger-fil fortæller, når der er anmodninger til afhentning. KMD Udbetaling henter trigger-fil og G68-formateret fil og sletter efterfølgende begge filer på SFTP-serveren (oprydning), som samtidig er kvittering for at KMD Udbetaling har modtaget filerne. KOMBIT A/S Halfdansgade København S CVR Side 23 af 34

24 3.2.2 Oversigt over endpoints ID Navn EP_KU1 EP_KU2 GF415001Q (tilpasset P13-3) GF200001Q (tilpasset G68 format) Beskrivelse af endpoint EP_KU1 GF415001Q Transportspecifikation Serviceudstiller KMD Udbetaling er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Da det er en ren gennemstilling til KMD Udbetaling vil Serviceplatformen gennemstille de samme 3 operationer som KMD Udbetaling Opret, Tjek og GenudskrivBilag som defineret i [WSDL-EXT]. Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [WSDL-EXT] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-EXT] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] [Opdateres når information er tilgængelig, ikke nødvendig i forhold til udvikling] Teknisk retning for udveksling Serviceplatformen kalder webservicen på KMD Udbetaling. KOMBIT A/S Halfdansgade København S CVR Side 24 af 34

25 Dataretning for udveksling Serviceplatformen sender udbetalingsanmodninger til KMD Udbetaling og modtager forretningskvitteringer i svaret som gennemstilles til fagsystem Service invokation / Triggers Kommunikationen initieres af, at fagsystemerne har nye anmodninger, som skal overføres til KMD Udbetaling Dataspecifikation Dataspecifikationen er på en tilpasset version af KMD Udbetalings GF415001Q, se [WSDL-EXT]. I den tilpassede version er følgende ændret for at tilpasse id er til de nye fagsystemer: DataLeverandoerId ændres fra SHORT til GUID (UUID for fagsystem) AdministrativEnhedsId ændres fra INT til GUID (UUID for den administrative enhed) organisation ( <xs:complextype name="organisation"> <xs:sequence> <xs:element minoccurs="0" name="andenkommunalorganisationsid" type="xs:short"/> <xs:element minoccurs="0" name="andenregionalorganisationsid" type="xs:short"/> <xs:element minoccurs="0" name="ministeriumsid" type="xs:short"/> <xs:element minoccurs="0" name="primaerkommuneid" type="xs:short"/> <xs:element minoccurs="0" name="privatvirksomhedsid" type="xs:short"/> <xs:element minoccurs="0" name="regionsid" type="xs:short"/> <xs:element minoccurs="0" name="selvejendeinstitutionsid" type="xs:short"/> <xs:element minoccurs="0" name="statsinstitutionsid" type="xs:short"/> </xs:sequence> </xs:complextype> ) ændres: PrimaerKommuneId ændres fra SHORT til STRING (urn:oio:cvr:nnnnnnnn) sådan er CVR-nummer repræsenteret i WSDL i forvejen. GUID/UUID er 36 tegn langt og repræsenterer et 128 bit unikt id vist i formatet xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx som f.eks. 9d3e799b-1d25-4c1f f1db9a9c. KOMBIT A/S Halfdansgade København S CVR Side 25 af 34

26 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Udbetaling er baseret på OCES certifikater [STS- Sikkerhed]. KMD Udbetaling Straksudbetaling tilgås med et FOCES certifikat per kommune, som hver er tilknyttet en KMD bruger i KSP-CICS med rettigheder til KMD Udbetaling og adgang til alle operationer i webservicen, som beskrevet i [GF415001Q] kapitel 9 Sikkerhed Leverancesikkerhed og fejlhåndtering Servicen er en gennemstillingsservice til KMD Udbetaling. Serviceplatformen sørger på at gennemstille request og response. Ved fejl returer KMD Udbetaling fejlkoder i respons. Det er fagsystemernes ansvar at rette fejl i anmodninger i KMD Udbetaling og sende igen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi KMD Udbetaling er åben alle årets dage fra kl. 00:00 til 24:00. Aftalt driftstid er fra kl. 08:00 til kl alle arbejdsdage. KMD udbetaling har svartiden ved en belastning på 100 webservicekald pr. minut ikke overskrider 1,75 sekund i 95% af tilfældene ded dette opgavemix af forretningsprocesser: 50% Straksudbetalinger, 35% Hent- Udbetaling, 10% Kreditorinfo, 5% UdbetalendeEnheder. KMD udbetaling har servicemålet min. 98,0 % og reguleres årligt. Kan max. være 99,0 %. KMD udbetaling i driftstiden 08:00 til 17:00 på arbejdsdage. KMD udbetaling varsler servicevinduer på kundenet.kmd.dk. Nye releases varsles med mindst 5 dage og nye versioner med mindst 30 dage. Servicevinduer er normalt udenfor driftstid Beskrivelse af endpoint EP_KU2 GF200001Q Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller. KOMBIT A/S Halfdansgade København S CVR Side 26 af 34

27 Serviceanvender KMD Udbetaling er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som SFTP Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion SFTP platform: Host IP SFTP bruger: KMDUdbetaling [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KMD] KMD_UDBETALING_SIMPELSFTP Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host IP SFTP bruger: KMDUdbetaling [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KMD] KMD_UDBETALING_SIMPELSFTP Teknisk retning for udveksling KMD Udbetaling poller Serviceplatformens SFTP-server Dataretning for udveksling KMD Udbetaling henter udbetalingsanmodninger fra Serviceplatformens SFTP-server Service invokation / Triggers KMD Udbetaling poller periodisk Serviceplatformens SFTP-server for ny anmodninger Dataspecifikation Data- og trigger-fil er defineret i afsnit Der sker ikke ændringer i data- eller triggerfil fra fagsystem til afhentning af KMD Udbetaling. KMD Udbetaling leverer ikke kvitteringer tilbage Sikkerhed Sikkerhed mellem KMD Udbetaling og Serviceplatformens SFTP-server er SSH-baseret, [STS- Sikkerhed]. KOMBIT A/S Halfdansgade København S CVR Side 27 af 34

28 Leverancesikkerhed og fejlhåndtering Servicen er forretningskritisk og har derfor behov for leverancesikkerhed. SFTP understøtter transport-kvitteringer, således at fagsystemerne kan se at filerne er placeret i SFTP-folderen for KMD Udbetaling, men ikke om de er afhentet, og hvis hvis der er fejl i SFTP-processen. KMD Udbetaling skal validerer filen ved modtagelse, og ved fejl oprette en incident. KMD Udbetaling understøtter ikke forretningskvitteringer, og forretningsmæssige fejl skal manuelt rettet i KMD Udbetalings brugergrænseflade Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Værdi Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. KMD Udbetaling er åben alle årets dage fra kl. 00:00 til 24:00. Aftalt driftstid er fra kl. 08:00 til kl alle arbejdsdage. Svartid Tilgængelighed N/A for SFTP. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. KMD udbetaling har servicemålet min. 98,0 % og reguleres årligt. Kan max. være 99,0 %. Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KMD udbetaling i driftstiden 08:00 til 17:00 på arbejdsdage. Servicevinduer 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]. KOMBIT A/S Halfdansgade København S CVR Side 28 af 34

29 KMD udbetaling varsler servicevinduer på kundenet.kmd.dk. Nye releases varsles med mindst 5 dage og nye versioner med mindst 30 dage. Servicevinduer er normalt udenfor driftstid Service Management Incident Management [Afklaring: input KMD] Problem Management [Afklaring: input KMD] Change Management [Afklaring: input KMD] Testplan Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 29 af 34

30 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. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. Serviceplatformen Fagsystem EP_FS1 EP_FS2 IF01 IF02 EP_KU1 EP_KU2 KMD Udbetaling Oversigt over integrationsflows ID Navn IF01 IF02 Udbetaling - Straksleverance Udbetaling - Batchleverance Integrationsflow IF01: Udbetaling - Straksleverance Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 StraksUdbetaling Afsnit EP_KU1 GF415001Q Afsnit KOMBIT A/S Halfdansgade København S CVR Side 30 af 34

31 Integrationstype Dette er gennemstillingsintegration, hvor der synkront kaldes ind på en webservice med et XMLformat på serviceplatformen, som gennemstilles direkte til en webservice på KMD Udbetaling. KMD Udbetaling leverer en kvittering synkront tilbage Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatformen KMD Udbetaling Fagsystemet kalder synkront en webservice på SP som gennemstiller til KMD Udbetaling Kvittering returneres og gennemstilles synkront gennem SP til fagsystem EP_FS1 EP_KU1 Fagsystemet kalder Serviceplatformen på en web-service, EP-FS1, med en straksudbetalingsanmodning. Serviceplatformen gennemstiller til KMD Udbetaling på EP_KU1. KMD Udbetaling returnerer synkront en kvittering som gennemstilles til fagsystemet. EP_KU1 indeholder 3 operationer, som alle gennemstilles gennem SP Datatransformering Transaktionsheader fjernes i SP og benyttes kun til logning i SP Datapersistering N/A Databerigelse N/A Routing N/A Orkestrering Ingen. KOMBIT A/S Halfdansgade København S CVR Side 31 af 34

32 Sikkerhed Sikkerhed mellem fagsystem og serviceplatformen er baseret på token, og mellem Serviceplatform og KMD Udbetaling er baseret på Certifikat. Dette er specificeret use case UC-SEC-06 [Sikkerhed]. KMD Udbetaling Straksudbetaling tilgås med et FOCES certifikat per kommune, som hver er tilknyttet en KMD bruger i KSP-CICS med rettigheder til KMD Udbetaling og adgang til alle operationer i webservicen, som beskrevet i [GF415001Q] kapitel 9 Sikkerhed Logning CallersServiceCallIdentifier logges i SP. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Testdata og testfaciliteter Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Konfiguration Ingen kendte Supplerende information Integrationsflow IF02: Udbetaling - Batchleverance Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS2 BatchUdbetaling Afsnit EP_KU2 GF200001Q Afsnit Integrationstype Dette er en filtransport baseret på Serviceplatformens SFTP-server, hvor der overføres en fil i et tilpasset G68 format fra fagsystemet til SFTP-serveren sammen med en trigger-fil, som videresendes til modtagerens mappe på SFTP-serveren. Efterfølgende hentes datafil og triggerfil af KMD Udbetaling, som derefter sletter disse filer Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 32 af 34

33 Fagsystem Serviceplatformen KMD Udbetaling SFTP-service Trin 1 EP_FS2 Trin 2 Trin 3 Trin 4 EP_KU2 Beskrivelse af hvert trin i integrationsflowet Trin 1 Trin 2 Trin 3 Trin 4 Fagsystemet kalder Serviceplatformens SFTP-server, EP_FS2, for at overføre batchleverancen udbetalingsanmodninger i G68 format sammen med en triggerfil. SFTP-servicen validerer triggerfil og placerer filerne i modtagers SFTP-folder. SFTP-server danner en transportkvittering i afsenders folder. Fagsystemet tjekker transportkvittering. Hvis den siger fejl, skal forberede en genfremsendelse med fejlene rettet. Fagsystemet rydder op på SFTP-server. KMD Udbetaling henter filerne på Serviceplatformens SFTP-server, hvis der ligger trigger-filer. KMD Udbetaling sletter efterfølgende filerne. KMD Udbetaling validerer efterfølgende batchleverancen og opretter et incident, hvis der er fejl Datatransformering N/A Datapersistering N/A Databerigelse N/A. KOMBIT A/S Halfdansgade København S CVR Side 33 af 34