Integration Send sagsoplysninger til Betalingsadministration Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2015-02-25 MHO 0.1 Første version 2015-03-03 MHO 0.2.1 Kommentarer fra internt review indarbejdet 2015-03-27 ehe 0.3 Klar til fagprojekt review 2015-03-27 ehe 0.5 Klar til SP 2015-06-30 MHO 0.5.1 Referencerettelser mm. 2015-06-30 EHE 2.0.0 Teknisk beskrivelse indarbejdet Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS-Sikkerhed] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: https://sharekomm.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://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet [KMD-Dok] Snitfladebeskrivelse for GO000002Q Betalingsadministration Send sagsoplysninger til KMD Opus Debitor KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 20
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... 5 1.4 Teststrategi... 6 1.5 Forudsætninger for produktionssætning af integration... 7 2 Kontekst for integrationsparter... 8 2.1 Kontekst for KY (kontanthjælp)... 8 3 Specifikation for integrationsparter... 9 3.1 Specifikation af endpoints for KY... 9 3.2 Specifikation af endpoints for KMD Opus Debitor... 13 4 Beskrivelse for integrationsplatforme... 18 4.1 Beskrivelse for Serviceplatformen... 18 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 20
Betalingsadministrationssystem Serviceplatformen Fagsystem Integrationsbeskrivelse 1 Overordnet beskrivelse 1.1 Integrationens formål Integrationen benyttes til at sende sagsoplysninger til betalingsadministrationssystemet. Disse oplysninger anvendes til manuel oprettelse af en ny betalingsadministrationsaftale eller til ændring af status på en eksisterende aftale. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet sender filen med sagsoplysninger til Serviceplatformen via SFTP. Serviceplatformen flytter filen til en mappe dedikeret til snitfladen mod betalingsadministrationssystemet, som henter filen på serviceplatformen. Integrationen er en gennemstillingsintegration. Send sagsoplysninger Send fil SFTP Flyt fil til anden mappe på SP Hent fil KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 20
1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Flow 1 Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/KMD: Aftales senere] Svartid [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] [Afklaring/KMD: Aftales senere] Tilgængelighed 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/KMD: Aftales senere] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. [Afklaring/KMD: Aftales senere] 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]. [Afklaring/KMD: Aftales senere] 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/ KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 20
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?] Der varsles om ændringer i datastrukturer og valideringsregler i UDK betalingsadministration 3 måneder før, ændringerne træder i kraft. Opsigelse af snitfladen kan ligeledes foretages med 3 måneders varsel. 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] 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] [Afklaring/KMD: Dette skal afklares, når integrationsmønsteret er afklaret] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD: Dette skal afklares, når integrationsmønsteret er afklaret] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 20
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] [Afklaring/KMD: Aftale vedr. produktionssætning udestår] 1.5 Forudsætninger for produktionssætning af integration 1.5.1 Funktionalitet på Serviceplatformen Serviceplatformen skal implementere en KFS-klient (fra producenten Stonebranch), som kan kommunikere med KFS hos KMD. Der skal oprettes en mappe på Serviceplatformen, som er dedikeret til afsendelse af filer med KFS. 1.5.2 Generelle forhold for tilslutning til integrationspart: KMD Opus Debitor Der skal være indgået en aftale om et integrationstestforløb, og testen skal være godkendt af KMD inden ibrugtagning i produktion. 1.5.3 Generelle forhold for tilslutning til integrationspart: KY Kommunerne skal være tilsluttet som bruger i KMD Opus Debitor. KMD Opus Debitor accepterer kun transaktioner fra kendte dataleverandører. Dette sikres ved, at fagsystemet får tildelt en kode på 4 positioner (leverandørident), som skal indsættes i de transaktioner, det pågældende system leverer. 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]. [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] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 20
2 Kontekst for integrationsparter 2.1 Kontekst for KY (kontanthjælp) 2.1.1 Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en 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. Det forvaltningsmæssige formål er at informere UDK betalingsadministration om mulighed for tilbageholdelse af en betalingsadministrationsaftale omkring børnebidrag. De oplyste sager anvendes af UDK betalingsadministration til at etablere eventuelle fradrag i forbindelse med de enkelte udbetalinger via SF2530. 2.1.2 Kapacitets- og servicekrav Det estimeres, at volumen vil være ca. 200 filer per måned. 2.1.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 8 af 20
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY Integrationen benyttes til at sende filer med sagsoplysninger til betalingsadministrationssystemet via Serviceplatformen. 3.1.1 Overordnet forretningslogik Fagsystemet placerer filer med sagsoplysninger på Serviceplatformens SFTP-server: Fagsystemet etablerer forbindelse til Serviceplatformens SFTP-server og udfører PUT for nye filer. 3.1.2 Oversigt over endpoints ID Navn EP_FS1 SendSagsoplysninger 3.1.3 Beskrivelse af endpoint EP_FS1 - SendSagsoplysninger 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatformen udstiller standard SFTP service på SFTP-server som specificeret i UC-01 i [SFTP]. Der skal sendes en triggerfil sammen med den forretningsmæssige fil. 3.1.3.1.2 Serviceanvender Fagsystemet er serviceanvender og benytter operationen PUT til at uploade filerne. 3.1.3.1.3 Teknologisk understøttelse Snitfladen er implementeret som en SFTP-forbindelse. 3.1.3.1.4 Teknisk endpoint Upload af filer foretages via det tekniske endpoint, EP_FS1. [Afklaring/Systematic: Sparring om hvilke parametre skal indgå i nedenstående tabeller - fx: SFTPendpoint (host, IP), FTP-root-folder, brugernavn/password?] Miljø: Produktion SFTP platform: Host IP SFTP bruger: KSD Serviceplatform [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KY f.eks. KY_SFTPSIMPEL] [Afklaring/KDF oplysninger leveres af Systematic f.eks. SP_SAGSOPLFUB_SFTPSIMPEL] Følgende specificerer endpoint-oplysninger for testmiljø: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 20
Miljø: Test SFTP platform: Host IP SFTP bruger: KSD Serviceplatform [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af KY f.eks. KY_SFTPSIMPEL] [Afklaring/KDF oplysninger leveres af Systematic f.eks. SP_ SAGSOPLFUB_SFTPSIMPEL] [Afklaring Systematic: Det skal angives, hvordan fagsystemet skal udfylde triggerfilen. Afventer endelig specifikation af triggerfil. Foreløbig version af specifikation er modtaget] 3.1.3.1.5 Teknisk retning for udveksling Fagsystemet kalder Serviceplatformens SFTP-server for at uploade filer. 3.1.3.1.6 Dataretning for udveksling Fagsystemet uploader dataudtræk på Serviceplatformens SFTP-server. 3.1.3.1.7 Service invokation / Triggers Data afsendes når fagsystemet, som led i en udbetaling, har modregnet krav fra UDK. 3.1.3.2 Dataspecifikation Data sendes som fil med fast format. Hver indberetning har en fast længde på 86 tegn, og alle transaktioner i filen skal alle have denne længde. Filen kan enten være opbygget i ANSI- eller ASCII-code. I det følgende vises en skematisk oversigt over snitfladens felter samt deres valideringsregler. Feltnr. Validering Længde Feltnavn Beskrivelse 1 X 2 (N) Individtype Snitflade individtype 2 X A 4 (AN) Leverandoerident Identifikation af afsender 3 X 19 (AN) Tidsstempel Afsenderens tidsstempel 4 X A 4 (N) Bruger Kunden / kommunen 5 X 6 (AN) ForPartnerType Forretningspartnertypen 6 X A 25 (N) ForPartner Identifikation af forretningspartner 7 X 4 (N) Sagsoplysning Beskrivelse af sagsoplysningen 8 V 8 (N) Start_dato Startdato for udbetalingen 9 V 8 (N) Slut_dato Slutdato for udbetalingen 10 V 6 (AN) Udbetalingsform Sker udbetalingen forud eller bagud KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 20
For felterne gælder, at de er tildelt forskellige validringsregler af betalingsadministrationssystemet. Følgende typer af valideringsregler indgår: X Skal udfyldes. V Valgfrit. A Afhængige af andet felt N = Numerisk og AN = Alfanumerisk Individtype og Leverandoerident er faste informationer for snitfladen: Individtype = 40 Leverandoerident = [Afklaring/KMD ident udleveres ifm. indgåelse af aftale med KMD] Desuden gælder følgende regler: Feltet alfanumeriske/numeriske forskrift skal følges. Feltets (maksimale) længde skal overholdes. Ved numeriske felter skal der indberette en værdi inden for feltets værdisæt. Obligatoriske felter skal udfyldes. Datofelter skal være på formen: YYYYMMDD, f.eks. 20081230 angiver 30. december 2008 Beløb skal angives i mindste betalingsenhed med højrestillet fortegn, f.eks. 15200+ = 152,00 Numeriske felter skal være udfyldt med foranstillede nuller, f.eks. feltet Bruger som er 4 (N) udfyldes med 0899 hvis kommunenummeret er 899. Hvis et valgfrit numerisk felt ikke ønskes anvendt, skal feltet udfyldes med nul i alle positioner. Alfanumeriske felter skal udfyldes med blanke, hvis feltet ikke ønskes anvendt. Alle felter skal udfyldes. Der henvises til dokumentet Snitfladebeskrivelse for GO000002Q Betalingsadministration Send sagsoplysninger til KMD Opus Debitor [KMD-Dok] afsnit 8 Validering af data for en detaljeret beskrivelse af felterne i snitfladen. Snitfladen er ikke compliant med rammearkitekturen. Fagsystemet sørger selv for mapningen mellem kommunenummeret i felt nummer 4 i snitfladen og kommunens UUID i rammearkitekturen. 3.1.3.3 Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er baseret på Serviceplatformens sikkerhedsmodel for SFTP. 3.1.3.4 Leverancesikkerhed og fejlhåndtering Filen uploades til SFTP-serveren, hver gang et eller flere beløb er modregnet en ydelsesudbetaling. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 20
Der sker ingen validering på Serviceplatformen. Transaktioner, der ikke overholder snitfladebeskrivelsen eller indeholder ugyldige data, vil blive afvist hos betalingsadministrationssystemet. Fejlhåndteringen er manuel. Der sendes ikke tekniske kvitteringer eller fejlmeddelelser. Det skal være muligt for fagsystemet at rette de afviste transaktioner og genfremsende dem til betalingsadministrationssystemet. 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 Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider 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]. 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 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]. 3.1.4 Service Management 3.1.4.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] [Afklaring/KDF og KY når der er taget beslutning om governance i programmet, skal der tilføjes information om processen for kontakt mellem KMD og kommunerne samt håndtering af fejlmeddelelser. Det skal aftales, hvem KMD skal kontakte i tilfælde af fejl. Det forventes, at KY skal håndtere tekniske fejl i leverancen, mens kommunen skal håndtere evt. indholdsmæssige fejl. Dette skal aftales nærmere mellem KDF og KY. ] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 20
[Afklaring/KMD Det skal afklares, hvordan den manueller fejlhåndtering fungerer, og hvad tidshorisonten for information om fejl er] 3.1.4.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.1.4.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] 3.1.5 Testplan 3.1.5.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KY: Integrationstest] 3.1.5.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KY: Produktionssætningstest] 3.2 Specifikation af endpoints for KMD Opus Debitor Integrationen benyttes af Serviceplatformen til at videresende filer med sagsoplysninger til betalingsadministrationssystemet, som varetages af UDK betalingsadministration med løsningen KMD Opus Debitor. 3.2.1 Overordnet forretningslogik Serviceplatformen placerer filer med sagsoplysninger, som modtages via SFTP, i en mappe dedikeret til denne snitflade mod KMD Opus Debitor. KFS flytter filerne til KMD Opus Debitor med fastlagte mellemrum. KFS flytter nye filer fra mappe dedikeret til denne snitflade til KMD Opus Debitor. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 20
3.2.2 Oversigt over endpoints ID Navn EP_KMD1 KMDHentSagsoplysninger 3.2.3 Beskrivelse af endpoint EP_KMD1 - KMDHentSagsoplysninger 3.2.3.1 Transportspecifikation 3.2.3.1.1 Serviceudstiller KMD udstiller KFS-løsning baseret på software fra Stonebranch. KFS Kundeklient skal implementeres på Serviceplatformen. 3.2.3.1.2 Serviceanvender KMD er serviceanvender. 3.2.3.1.3 Teknologisk understøttelse Snitfladen benytter KMD KFS, som er baseret på software fra Stonebranch. 3.2.3.1.4 Teknisk endpoint Flytning af filer foretages via det tekniske endpoint, EP_KMD1. [Afklaring/Systematic og KMD: Sparring om det specifikke indhold i nedenstående tabeller f.eks. mappenavne, kontaktpunkter og endpoint IP] Miljø: Produktion Udgående filer [Afklaring/Systematic: Udfyldes af Systematic, når klienten er implementeret på SP] Udgående filer placeres i mappen: [Mappenavn kan f.eks. følge mønsteret d:\kmdkfs\til_kmd\opus\betalingsadministration03] Endpoint navn [Afklaring/Systematic: Udfyldes af Systematic] Endpoint IP 195.50.39.170 Miljø: Test Test af filer Testfiler sendes til KMD via mail. [Afklaring/KMD: Det skal afklares, hvem filerne skal sendes til] Test af KFS [Afklaring/Systematic: Udfyldes af Systematic, når klienten er implementeret på SP] Udgående filer placeres i mappen: [Mappenavn kan f.eks. følge mønsteret d:\kmdkfs\til_kmd\opustest\betalingsadministration03] Der findes ikke et KFS testmiljø, så KMD laves en mappe, som kun benyttes til test. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 20
Endpoint navn [Afklaring/KMD: Udfyldes af Systematic] Endpoint IP 195.50.39.170 Nedenfor ses en overordnet oversigt over, hvordan KFS fungerer: 3.2.3.1.5 Teknisk retning for udveksling KMD KFS kontakter kundeklienten på Serviceplatformen for at flytte filer. 3.2.3.1.6 Dataretning for udveksling KFS flytter (henter og sletter) filer fra Serviceplatformens til KMD Opus. 3.2.3.1.7 Service invokation / Triggers Data hentes med fast interval. Som udgangspunkt er dette hver halve time. 3.2.3.2 Dataspecifikation Data sendes i filer med fast format. Filerne leveres af fagsystemet. Der henvises til afsnit 3.1.3.2 og dokumentet Snitfladebeskrivelse for GO000002Q Betalingsadministration Send sagsoplysninger til KMD Opus Debitor [KMD-Dok] afsnit 8 Validering af data for en beskrivelse af indholdet i snitfladen. 3.2.3.3 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD er baseret på sikkerheden i KFS. Serviceplatformen tildeler KMD KFS en bruger med et password og sikrer derved, at KFS har fornøden adgang til at arbejde på Serviceplatformen. Al kommunikation mellem KMD og Serviceplatformen foregår i et lukket netværk, og KMD KFS benytter et 3.parts produkt til selve kommunikationen (fra Stonebranch). KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 20
3.2.3.4 Leverancesikkerhed og fejlhåndtering KFS sikrer, at filerne leveres til KMD (Managed File Transfer). Fejlhåndteringen er manuel. Der sendes ikke tekniske kvitteringer eller fejlmeddelelser. Transaktioner, der ikke overholder snitfladebeskrivelsen, vil blive afvist hos KMD Opus Debitor, og fagsystemet vil blive kontaktet af KMD's serviceafdeling. Fagsystemet gensender filerne, hvis det er nødvendigt. Tidshorisont for information om fejl er forventeligt dagen efter dataene er forsøgt kørt ind i KMD Opus Debitor. 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 Flow 1 Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/KMD: Aftales senere] Svartid [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] [Afklaring/KMD: Aftales senere] Tilgængelighed 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/KMD: Aftales senere] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. [Afklaring/KMD: Aftales senere] 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]. [Afklaring/KMD: Aftales senere] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 20
3.2.4 Service Management 3.2.4.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] [Afklaring/KDF og KY når der er taget beslutning om governance i programmet, skal der tilføjes information om processen for kontakt mellem KMD og kommunerne samt håndtering af fejlmeddelelser. Det skal aftales, hvem KMD skal kontakte i tilfælde af fejl. Det forventes, at KY skal håndtere tekniske fejl i leverancen, mens kommunen skal håndtere evt. indholdsmæssige fejl. Dette skal aftales nærmere mellem KDF og KY. ] [Afklaring/KMD Det skal afklares, hvordan den manueller fejlhåndtering fungerer, og hvad tidshorisonten for information om fejl er] 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?] KMD varsler om ændringer i datastrukturer og valideringsregler 3 måneder før, ændringerne træder i kraft. Opsigelse af snitfladen kan ligeledes foretages med 3 måneders varsel. 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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KMD: Integrationstest] 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. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KMD: Produktionssætningstest] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 20
Fagsystemer Integrationsbeskrivelse 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. EP_FS1 Serviceplatformen IF01 Send sagsoplysninger EP_KMD1 Betalingsadministrationssystemet Dataretning 4.1.1 Oversigt over integrationsflows ID Navn IF01 Send sagsoplysninger 4.1.2 Integrationsflow IF01 Send sagsoplysninger 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 SendSagsoplysninger Afsnit 3.1.3 EP_KMD1 KMDHentSagsoplysninger Afsnit 3.2.3 4.1.2.2 Integrationstype Integrationen er en gennemstillingsintegration, hvor filer flyttes fra fagsystemets ind-mappe på SFTP-serveren (evt. vha. triggerfunktionen i SFTP-løsningen) til en mappe dedikeret til snitfladen mod betalingsadministrationssystemet. Der sker ingen validering af filerne på Serviceplatformen. 4.1.2.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 20
Fagsystem Serviceplatform Betalingsadm. Upload fil vha. SFTP Upload triggerfil vha. SFTP Download kvittering/fejlmeddelelse vha. SFTP KMD henter fil vha. KFS EP_KMD1 (FLYT) Sekvens: 1. Fagsystemet etablerer forbindelse til Serviceplatformens SFTP-server 2. Fagsystemet uploader fil med forespørgsel til SFTP-serveren 3. Fagsystemet uploader triggerfil til SFTP-serveren 4. Fagsystemet downloader kvittering/fejlmeddelelse fra SFTP-serveren 5. Serviceplatformen flytter filen til en mappe dedikeret til snitfladen mod betalingsadministrationssystemet 6. KFS flytter (henter og sletter) filen 4.1.2.4 Datatransformering Ingen krav. 4.1.2.5 Datapersistering Ingen krav. 4.1.2.6 Databerigelse Ingen krav. 4.1.2.7 Routing Ingen krav. 4.1.2.8 Orkestrering Ingen krav. 4.1.2.9 Sikkerhed Sikkerheden baseres på to selvstændige trusts: - Sikkerheden mellem fagsystemet og Serviceplatformen er baseret på SFTP som beskrevet i UC-01 i RA STS [SFTP] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 20
- Sikkerheden mellem Serviceplatformen og KMD Opus Debitor er baseret på sikkerheden i KMD KFS. Serviceplatformen skal sikre, at det kun er godkendte kildesystemer inkl. dataejere, som kan anvende servicen. 4.1.2.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. 4.1.2.11 Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] 4.1.2.12 Konfiguration Ingen krav. 4.1.2.13 Supplerende information KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 20