Integration SF0802 Feriekonto batchopslag Integrationsbeskrivelse - version 2.0.0

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer PBO 0.1 Første version ehe 0.5 Klar til afsendelse til SP JJN 0.51 Opdateret med SFTP løsning JJN 0.8 Kapitel opdateret med SFTP JJN 0.9 Referencerettelser mm EHE 2.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: 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 [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet [ATP1] [ATP2] Snitfladebestilling FK KOMBIT Online webservice v10.docx Snitfladebestilling FK KOMBIT Batch v10.docx [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet KOMBIT A/S Halfdansgade København S CVR Side 2 af 38

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Kontekst for ATP [!@IP-ATP@!] Specifikation for integrationsparter Specifikation af endpoints for fagsystemet (n) [!@IP-KY@!] [!@IP-KSD@!] Specifikation af endpoints for ATP [!@IP-ATP@!] Beskrivelse for integrationsplatforme Oversigt over integrationsflows Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 38

4 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med snitfladen er at tilvejebringe oplysninger om udbetalte feriepenge for alle de borgere i Kommunernes Sygedagpengesystem (KSD) eller Kommunernes Ydelsessystem (KY), som modtager en ydelse. Hvis en borger vælger at få udbetalt sine feriepenge, så kan udbetalingen påvirke de tildelte ydelser. ATP leverer oplysninger om ferieafholdelse på vegne af Styrelsen for Arbejdsmarked og Rekruttering (STAR). Snitfladen er en batch snitflade, hvor der modtages en samlet opdateringsfil på alle relevante borgere, som har en sag i KY eller KSD. For at få seneste indkomst og formue-oplysninger inden der udbetales ydelser, så udføres batchoverførslen ved regelmæssigt. 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 asynkron gennemstillingsintegration via FTP server på Serviceplatformen. KY og KSD overfører hver en navngivet batchfil med personnumre og ønsket periode, samt en triggerfil, til Serviceplatformen, som indeholder de data som ATP skal modtage. ATP Feriekonto henter og sletter modtagne filer fra KY og KSD efterfølgende på Serviceplatformen. ATP Feriekonto behandler filerne, og returnerer to batch filer med triggerfiler efter 1 2 dage med oplysninger fra ATP om indestående feriepenge og tidligere udbetalte feriepenge i den ønskede periode til Serviceplatformen. Serviceplatformen udstiller en returfil til KY og en returfil til KSD med tilhørende triggerfiler. KY og KSD sletter filerne på Serviceplatformen efter afhentning af batchfilen. Serviceplatformen skal sikre, at det kun er det pågældende fagsystem, der kan tilgå filen. KOMBIT A/S Halfdansgade København S CVR Side 4 af 38

5 Kildesystem Serviceplatformen Fagsystem(N) Integrationsbeskrivelse Send udtræksgrundlag Hent Udtræksoplysninger Periodisk Generer og afsend personliste fil Periodisk Afhent resultat fil Persister fil Udstil fil Udstil fil Persister fil Periodisk Hent personliste fil Dan udtræk Overfør resultat fil For den angivne periode modtages bl.a. følgende information per udbetaling fra ATP Feriekonto: Dato (for ferie anmodning) Personnummer Første feriedag (i den ønskede ferieperiode) Antal feriedage (i den ønskede ferieperiode)9 Beløb pr. udbetalingsdato (til udbetaling) Aktuelt ferieår på udbetalingen Saldo feriepenge (i aktuelt ferieår på udbetalingen) KOMBIT A/S Halfdansgade København S CVR Side 5 af 38

6 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 ATP 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 altid den 01/ Såfremt kilden til data (Navnet på it-systemet som data kommer fra, Feriekonto/ACF) i perioden ikke er Feriekonto, så vil feltet dispositionsdato være tomt. 1.3 Servicebetingelser for den samlede integration 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 Spidsbelastningsperiode Servicevinduer 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/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]. KOMBIT A/S Halfdansgade København S CVR Side 6 af 38

7 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: 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 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 SAPA.] Test i forbindelse med udvikling [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] Testfaciliteter og testmiljø [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] Testdata [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for.] 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] KOMBIT A/S Halfdansgade København S CVR Side 7 af 38

8 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 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 forhold for tilslutning til integrationspart: KSD, KY KSD og KY skal generere en liste af relevante sagsparter, som ATP skal returnere information om udbetalte feriepenge for. Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP] Forudsætninger for tilslutning til integrationspart: Ekstern system Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. KOMBIT A/S Halfdansgade København S CVR Side 8 af 38

9 2 Kontekst for integrationsparter 2.1 Kontekst for KY 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 feriepenge oplysninger om alle borgere, som modtager en ydelse i KY. Feriepenge saldo samt udbetalte feriepenge har indflydelse på beregningen af borgerens ydelse, hvorfor KY skal have adgang til denne information Kapacitets- og servicekrav KY vil afsende én forespørgsel én gang om ugen svarede til, at der udveksles 2 batchfiler per uge, samt to triggerfiler. Requestfilen vil indeholde ca personnumre, som der skal foretages opslag på Specifikke forhold for tilslutning af system Der er ikke specielle forhold for tilslutning af KY. 2.2 Kontekst for KSD 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. KOMBIT A/S Halfdansgade København S CVR Side 9 af 38

10 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 feriepenge oplysninger om alle borgere som modtager en sygedagpenge i KSD. Feriepenge saldo samt udbetalte feriepenge har indflydelse på beregningen af borgerens ydelse, hvorfor KSD skal have adgang til denne information mindst i udgangen af hver måned. Der udføres derefter løbende kontrol af om borgeren måske er rask nok til at vi kan lukke sagen, såfremt de har afholdt ferien Kapacitets- og servicekrav KSD vil afsende én forespørgsel én gang om ugen svarede til, at der udveksles 2 filer per uge Specifikke forhold for tilslutning af system Der er ikke specielle forhold for tilslutning af KSD. 2.3 Kontekst for ATP [!@IP-ATP@!] 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 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 Kapacitets- og servicekrav Serviceplatformen forventes at foretage max 2 ugentlige batchoverførsler. KOMBIT A/S Halfdansgade København S CVR Side 10 af 38

11 2.3.3 Specifikke forhold for tilslutning af system Ingen 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for fagsystemet (n) [!@IP-KY@!] [!@IP-KSD@!] Formålet med snitfladen er at tilvejebringe oplysninger om udbetalte feriepenge for alle de borgere i Kommunernes Sygedagpengesystem (KSD) eller Kommunernes Ydelsessystem (KY), som modtager en ydelse Overordnet forretningslogik Hver uge uploader Fagsystemet en fil indeholdende CPR numre samt tilhørende triggerfil på de personer og perioder, som der ønskes ferieoplysninger om afholdt ferie på. Filerne uploades til en bestemt mappe per fagsystem på Endpoint EP_FS1. Når triggerfilen er behandlet placeres en kvittering i den tilhørende udmappe med besked om succes eller fejl i overførelsen. Serviceplatformen flytter filerne til henholdsvis to mapper på EP_ATP1. ATP henter filerne på EP_ATP1 og fjerner dem efter afhentning. ATP udfører den ønskede søgning i løbet af en til to arbejdsdage og uploader resultatfilerne på henholdsvis EP_ATP2 Serviceplatformen flytter resultatfilerne samt tilhørende triggerfiler til EP_FS2 Fagsystemerne afhenter resultatfiler og fjerner dem efter afhentning. KOMBIT A/S Halfdansgade København S CVR Side 11 af 38

12 Kildesystem Serviceplatformen Fagsystem(N) Integrationsbeskrivelse Send udtræksgrundlag Hent Udtræksoplysninger Periodisk Generer og afsend personliste fil Periodisk Afhent resultat fil Persister fil Udstil fil Udstil fil Persister fil Periodisk Hent personliste fil Dan udtræk Overfør resultat fil Oversigt over endpoints ID Navn EP_FS1 Endpoint, hvor Fagsystemet(n) kan uploade en requestfil med tilhørende triggerfil. EP_FS2 Endpoint, hvor Fagsystemet(n) afhente en responsefil med tilhørende triggerfil. KOMBIT A/S Halfdansgade København S CVR Side 12 af 38

13 3.1.3 Beskrivelse af endpoint EP_FS Transportspecifikation Integrationsmønster Fagsystemet afsender en requestfil og en triggerfil til Serviceplatformen via Simpel SFTP Dette svarer til Integrationsmønster IMID12. IMID12 Ekstern FTP SP Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender KSD er serviceanvender Teknologisk understøttelse Snitfladen udveksles via SFTP Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion SFTP platform: Host IP SFTP bruger: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [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: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL KOMBIT A/S Halfdansgade København S CVR Side 13 af 38

14 Teknisk retning for udveksling Fagsystemet foretager upload til Serviceplatformen Dataretning for udveksling Fagsystemet sender fil Service invokation / Triggers Filen fra Fagsystemet skal ligge klar på overførselsdagen inden kl Dataspecifikation Data udveksles med fast record struktur, hvor data er i en fast positioneret struktur. Encoding for requestfilen fortages i tegnsættet iso (Latin1). Som record-afslutning (linjeskift) karakter er der valgt CR+LF (Windows). Responsefilen er en almindelig tekst fil i UTF-8 format Requestfil Requestfilen er en batch fil. Batch filen indeholder følgende begreber: En forsendelse består af alle oplysninger eller forespørgsler. En fysisk forsendelse består af en eller flere forespørgsler eller svar. I dette tilfælde data forespørgsler fra flere kommuner eller A-kasse. Et segment/række er en gruppe af sammenhørende dataelementer/felter. Det kan være forespørgslen på et cpr. nr. for en dato periode. Et dataelement/felt er de enkelte informationer, der forespørges på i et segment. Et eksempel være en start dato eller cpr. nr. etc. FAST karakter længde pr. række. Batch filen struktur indeholder følgende begreber: Batch filen skal have følgende data indhold: En Header der beskriver hvor filen kommer fra deres leverings id og deres tidsstemple En Body som indeholder alle rækker af forespørgslerne pr. cpr. nr. i en dato periode. En Tail som er et slut tag med antal rækker i filen. Kommunekode (indentifikationsid) Periode for udbetalingsdato o Start-dato for periode (dato indgår i periode) o Slut-dato for periode (dato indgår i periode) Personer der ønskes FerieKonto oplysninger på o Personnummer (CPR nummer for alle personer, som informationen ønskes for) KOMBIT A/S Halfdansgade København S CVR Side 14 af 38

15 Fejlhåndtering For sen eller manglende leverance medfører at kørslen ikke udføres. Manglende returfil skal behandles af Systematic som en driftsforstyrrelse. Valideringsfejl returneres til KSD og KY, som har ansvaret for håndtere fejlen. Ved modtagelse af data hos ATP håndteres følgende situationer som valideringsfejl: Kommunekode 1. Tilfælde hvor kommunekoden har et forkert format. Kommunekoden skal indeholde 3 bogstavkoder. 2. Tilfælde hvor kommune koden ikke er udfyldt. 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 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 Personnummer vil den tidligst mulige startperiode i forespørgslen være den 1. februar 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. Eksempel: Hvis en kommune spørger den 15. oktober 2012 på ferieoplysninger på et antal personnumre med startdato den 1. august 2011 vil den seneste slutdato således være den 1. april Personnummer 9. Tilfælde hvor Personnummer er modtaget i et forkert format. KOMBIT A/S Halfdansgade København S CVR Side 15 af 38

16 Formatet skal være numerisk 10 positioner (ddmmyyxxxx) Batchfil struktur Requestfilen har følgende struktur HEADER struktur: Felt Antal Type Eks. Beskrivelse karakter ID 2 Tal 01 For Header Identificer hvilke type række det er, i dette tilfælde er det en Header, så koden er 01. DRIFTOPLEV 10 Karakter KMDKOM Driftsleverandør ID. For kommunerne KMDAKA For A-Kasserne LEVEID 6 Tal Leverings id en løbende for hver Drift leverandør DATOSTEM 8 Dato For d. 20/ Dato for dannelse af forsendelsen (DDMMYYYY) STATUS 6 Karakter AFV + 3 ciffer kode eller Tom for ok Bruges hvis hele dokument fejler i validering af format. Sendes til Ekstern partner. BODY struktur Felt Antal Type Eks. Beskrivelse karakter ID 2 Tal 05 For Body Identificer hvilke type række det er, i dette tilfælde er det en Body, så koden er 05. OID 3 Karakter Kommune ID er et 3 cifret tal fra 101 til 999. Eller A-kasse ID ikke afklaret. * A-kasse ID eller Kommune ID ATP har ikke brug for dette felt. Driftsoperatøren kan skille Kommunerne fra hinanden for de forespurgte cpr. nr. CPRNUMMERR 10 Karakter CPR nr. (DDMMYYXXXX) STARTDAT 8 Dato For d. 20/ Start dato for periode forespørgelse (DDMMYYYY) SLUTDATO 8 Dato Periode slut forespørgelse KOMBIT A/S Halfdansgade København S CVR Side 16 af 38

17 For d. 20/ (DDMMYYYY) TAIL struktur: Felt Antal Type Eks. Beskrivelse karakter ID 2 Tal 99 For Tail Identificer hvilke type række det er, i dette tilfælde er det en Tail, så koden er 99. SLUTTE 10 Tal For 345 forespørgelse til ATP eller svar fra ATP STA 3 Karakter Leverandør afleverer 3 blanke. ATP svarer 000 for ok eller fejlstatuskode, hvis der er fejl i tail record For at validere at filen har det antal rækker i body (forespørgsel). Max 1 million rækker (forespørgsler) Bruges hvis tail record format fejler i validering Triggerfil Ved overførelse af en datafil via SFTP skal der udformes en triggerfil, som skal ledsage denne. Triggerfilen kan navngives frit, dog skal den have extension.trigger Der er ikke noget krav til at filnavnet skal være unikt, men i tilfælde af at en triggerfil med samme navn allerede eksistere i den folder, der ønskes at flyttes til, vil flytningen fejle indtil den blokkerede fil er blevet behandlet. Triggerfilen er XML baseret og skal indeholde information om forsendelsen, som vist nedenfor: Element Kardinalitet (Anvendt/ mulig) Forklaring FileContentDescriptorType 1/1 Complex element N/A - (Any) 1/(0..*) Angiver typen af filen, den skal medgives for at sikre, at der kan udveksles flere typer filer, og man umiddelbart kender formatet og indholdet ved at læse triggerfilen Eksempel på værdi <FilType> ATPFeriekontoPersonkre ds </FilType> <SF>0802</SF> Routinginformation 1/1 Complex element N/A - FileName 1/1 Der er ingen krav til navngivning af datafile, men det er dog hensigtsmæssig at den i en ATPFP KOMBIT A/S Halfdansgade København S CVR Side 17 af 38

18 hvis grad er unik af hensyn til sporbarhed. Dog må den ikke have extension.trigger. - SizeInBytes 1/1 Størrelsen af datafil i bytes Sender 1/1 SFTP brugeren f.eks. KY, SAPA, KSD. [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med KY_SFTPSIMPEL ibrugtagning.] - SendersFileId 1/0..* Der er valgfrit for afsendelsessystem om der medgives ID-er, der kan identificere filen. Der bør angives en unik identifikation, som gør filen sportbar. Dette er en string, som ikke er defineret med en begrænsning. [Afklaring/SP: Antal og længde af streng er ikke identificeret] - Recipients 1/(1..*) SFTP brugeren f.eks. Serviceplatform [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] Kunne være en sammensætning af DRIFTOPLEV og LEVEID fra startrecord i filen f.eks. KMDKOM ATP_FERIEKONTO_SFTPSI MPEL Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIKKERHED] Leverancesikkerhed og fejlhåndtering Serviceplatformen vil modtage og flytte filen en gang, hvorefter der kommer en svarfil fra ATP. Såfremt fagsystemet ikke har overført filen i rette tid, så vil filen først bliver hentet af ATP ved næste kørsel. Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er afsendersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: KOMBIT A/S Halfdansgade København S CVR Side 18 af 38

19 Der placeres en datafil uden at der efterfølgende placeres en triggerfil. Der placeres en datafil og en triggerfil med fejl f.eks. forkert xml format eller modtagersystem findes ikke. Afsendersystem modtager en teknisk fejl fra SFTP, og skal selv slette datafilen. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Yderligere har det i en tidligere version af dette dokument været nævnt, at man kan overskrive versioner af den samme fil på SFTP-serveren, så længe den ikke er hentet, dette er ikke korrekt. Forsøger man at overføre en fil, som allerede findes i enten afsender mappe eller modtager mappe, så vil denne blive afvist, indtil filen på SFTP serveren er slettet Fejlhåndtering af data ATP validerer requestfilen efter følgende grundregler (se også afsnit ): Hver række har ingen identifikation på hvad Dataelement/felt hedder. Så rækken indeholder kun data i det bestemte format se tabeller. Værdien af dataelementet SKAL altid indeholde alle de specificeret karakter længde, se tabellerne. Hvis værdien ikke har nogen værdi (NULL) indeholder den det aftalte antal blanke karakter. Hver række har en identifikation om rækken er en Header, Body eller Tail. Hvis det ikke overholdes fejler parseren (Valideringen af filen). Header starter med id en 01, Body er 05 og Tail starter med id en 99. På den måde kan en parser altid finde identificer om rækken er en af de overnævnte typer Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid 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 KOMBIT A/S Halfdansgade København S CVR Side 19 af 38

20 ikke] Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdage Servicevinduer Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer Beskrivelse af endpoint EP_FS Transportspecifikation Integrationsmønster Fagsystemet modtager response og triggerfil fra Serviceplatformen via Simpel SFTP. Dette svarer til Integrationsmønster IMID11. IMID11 Ekstern FTP SP Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen udveksler via SFTP Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion SFTP platform: Host IP SFTP bruger: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL KOMBIT A/S Halfdansgade København S CVR Side 20 af 38

21 Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host IP SFTP bruger: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Teknisk retning for udveksling Fagsystemet foretager download fra Serviceplatformen Dataretning for udveksling Fagsystemet modtager response batchfil Service invokation / Triggers Filen til Fagsystemet vil ligge klar 2-3 arbejdsdage efter upload Dataspecifikation Data udveksles med fast record struktur, hvor data er i en fast positioneret struktur. Responsefilen er en almindelig tekst fil i UTF-8 format Responsefil Løsningen vil levere oplysninger om alle registrerede udbetalinger for en given periode. Personnummer specifik information i batch-filen vil derfor relatere sig til samme periode for alle personnumre, der modtages udbetalingsoplysninger på. Ønskes der information for flere perioder skal disse fremsendes som særskilte forespørgsler. Perioden må ikke strække sig længere tilbage end 20 måneder fra den dato der spørges. Dog tidligst den 1/ Den afsendte batch er grupperet på kommunekode og periode herunder indgår de relevante personnumre. Inden for hver periode vil udbetalingsinformationerne være ordnet efter udbetalingsdato, således at hvis samme Personnummer er registreret med flere udbetalingsdatoer inden for den specifikke periode, vil disse fremgå separat, 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 i DKK (til udbetaling) Aktuelt ferieår på udbetalingen KOMBIT A/S Halfdansgade København S CVR Side 21 af 38

22 Saldo feriepenge (i aktuelt ferieår på udbetalingen) Saldo feriedage (i aktuelt ferieår på udbetalingen) Dispositionsdato / Udbetalingsdato Der er behov for 2 yderligere felter i svardata: Udbetalingsårsag. (Her indgår anmodningstyper. Se bilag under afsnit 4.2) Kilde Status (Fejlkode) Personnummer, Status og Saldo feriepenge oplyses, selv når der ikke findes nogen udbetalingsdato i perioden. Batchen kan derfor godt indeholde flere af de samme kommunekoder men med forskellige perioder. 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å. Fejlhåndtering Svar-filen vil kun indeholde de udbetalingsdatoer, som er registreret på det tidspunkt, hvor filen dannes. Der vil ikke blive taget hensyn til dato for første feriedag eller om udbetalingen er effektueret eller ej. Udbetalingsdatoer hvor udbetalingerne ligger fremme i tid eller hvor ferien allerede er afholdt vil derfor begge indgå i batch-filen. Ved afsendelse af data fra ATP betragtes følgende situationer som fejl: Personnummer 1. Tilfælde hvor der ikke er registreret nogen udbetalingsdatoer i FerieKonto på Personnummer inden for den forespurgte periode. 2. Tilfælde hvor der ikke er foretaget indbetalinger af feriepenge i det/de ferieår, der tilhører den forespurgte periode Batchfil struktur Responsefilen har følgende struktur: Header og tail er samme struktur som requestfilen beskrevet i afsnit BODY struktur Felt Antal Type Eks. Beskrivelse karakter ID 2 Tal 05 For Body Identificer hvilke type række det KOMBIT A/S Halfdansgade København S CVR Side 22 af 38

23 OID 3 Karakter Kommune ID er et 3 cifret tal fra 101 til 999. Eller A-kasse ikke afklaret. * er, i dette tilfælde er det en Body, så koden er 05. A-kasse ID eller Kommune ID ATP har ikke brug for dette felt. Driftsoperatøren kan skille Kommunerne fra hinanden for de forespurgte cpr. nr. CPRNUMMERR 10 Karakter CPR nr. (DDMMYYXXXX) STARTDAT 8 Dato For d. 20/ Start dato for periode forespørgelse (DDMMYYYY) SLUTDATO 8 Dato For d. 20/ STA 3 Tal 999 for OK UDBT 4 Tal 1510 For dagligt ANMDATO 8 Dato For d. 15/ FORSTFDA 8 Dato For d. 1/ FDAGE 4 Tal 0250 For 2 ½ feriedage BELOB 10 Tal For 500,40 kr. Periode slut forespørgelse (DDMMYYYY) Status er et tal som er beskrevet længere nede i dokumentet. Interface videre gives til partner. Udbetalings type. Interface videre gives til partner. Anmodning dato for feriepenge udbetaling. (DDMMYYYY) Første feriedag. (DDMMYYYY) Antal feriedage, der afholdes i ens ferie. Disposition beløb FAAR 4 Tal 2011 Ferieår (YYYY) DISPDATO 8 Dato For d. 15/ Dispositions dato. (DDMMYYYY) INDBETALBEL 10 Tal Indbetalt beløb Saldo For 1500,40 kr. OPTJF 4 Tal 0150 For 1 ½ feriedage Optjent antal feriedage Saldo antal feriedage Triggerfil Ved overførelse af en datafil via SFTP skal der udformes en triggerfil, som skal ledsage denne. Triggerfilen kan navngives frit, dog skal den have extension.trigger Der er ikke noget krav til at filnavnet skal være unikt, men i tilfælde af at en triggerfil med samme navn allerede eksistere i den folder, der ønskes at flyttes til, vil flytningen fejle indtil den blokkerede fil er blevet behandlet. Triggerfilen er XML baseret og skal indeholde information om forsendelsen, som vist nedenfor: KOMBIT A/S Halfdansgade København S CVR Side 23 af 38

24 Element Kardinalitet (Anvendt/ mulig) Forklaring FileContentDescriptorType 1/1 Complex element N/A - (Any) 1/(0..*) Angiver typen af filen, den skal medgives for at sikre, at der kan udveksles flere typer filer, og man umiddelbart kender formatet og indholdet ved at læse triggerfilen Eksempel på værdi <FilType> ATPFeriekontoOplysning er </FilType> <SF>0802</SF> Routinginformation 1/1 Complex element N/A - FileName 1/1 Der er ingen krav til navngivning af datafile, men det er dog hensigtsmæssig at den i en hvis grad er unik af hensyn til sporbarhed. Dog må den ikke have extension.trigger. ATPFP SizeInBytes 1/1 Størrelsen af datafil i bytes Sender 1/1 SFTP brugeren f.eks. KY, SAPA, KSD. [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] KY_SFTPSIMPEL - SendersFileId 1/0..* Der er valgfrit for afsendelsessystem om der medgives ID-er, der kan identificere filen. Der bør angives en unik identifikation, som gør filen sportbar. Dette er en string, som ikke er defineret med en begrænsning. [Afklaring/SP: Antal og længde af streng er ikke identificeret] - Recipients 1/(1..*) SFTP brugeren f.eks. Serviceplatform [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] Kunne være en sammensætning af DRIFTOPLEV og LEVEID fra startrecord i filen f.eks. KMDKOM ATP_FERIEKONTO_SFTPSI MPEL KOMBIT A/S Halfdansgade København S CVR Side 24 af 38

25 Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIKKERHED] Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er modtagersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der findes en datafil uden triggerfil. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Fejlhåndtering af data Responsefilen er opbygget efter følgende grundregler (se også afsnit ): Hver række har ingen identifikation på hvad Dataelement/felt hedder. Så rækken indeholder kun data i det bestemte format se tabeller. Værdien af dataelementet SKAL altid indeholde alle de specificeret karakter længde, se tabellerne. Hvis værdien ikke har nogen værdi (NULL) indeholder den det aftalte antal blanke karakter. Hver række har en identifikation om rækken er en Header, Body eller Tail. Hvis det ikke overholdes fejler parseren (Valideringen af filen). Header starter med id en 01, Body er 05 og Tail starter med id en 99. På den måde kan en passer altid finde identificer om rækken er en af de overnævnte typer Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. KOMBIT A/S Halfdansgade København S CVR Side 25 af 38

26 Svartid Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdage Servicevinduer Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. 3.2 Specifikation af endpoints for ATP [!@IP-ATP@!] Formålet med snitfladen er at tilvejebringe oplysninger om udbetalte feriepenge for alle de borgere i Kommunernes Sygedagpengesystem (KSD) eller Kommunernes Ydelsessystem (KY), som modtager en ydelse Overordnet forretningslogik Hver uge uploader Fagsystemet(n) en requestfil indeholdende CPR numre på de personer og perioder, som der ønskes ferieoplysninger om afholdt ferie på, samt en tilhørende triggerfil. Filerne uploades til EP_FS1. Serviceplatformen flytter filerne til henholdsvis EP_ATP1 ATP henter filerne på EP_ATP1 og fjerner dem efter afhentning. ATP udfører den ønskede søgning i løbet af en til to arbejdsdage og uploader resultat filerne på EP_ATPFSPut med tilhørende trigger filer. Serviceplatformen flytter filerne til EP_FS2. Fagsystemet(n) afhenter resultatfiler og fjerner dem efter afhentning. KOMBIT A/S Halfdansgade København S CVR Side 26 af 38

27 Kildesystem Serviceplatformen Fagsystem(N) Integrationsbeskrivelse Send udtræksgrundlag Hent Udtræksoplysninger Periodisk Generer og afsend personliste fil Periodisk Afhent resultat fil Persister fil Udstil fil Udstil fil Persister fil Periodisk Hent personliste fil Dan udtræk Overfør resultat fil Oversigt over endpoints ID Navn EP_ATP1 ATP kan hente requestfil og triggerfil fra fagsystemet(n) på Serviceplatformen. EP_ATP2 ATP kan uploade en responsefil og triggerfil til Fagsystemet(n). KOMBIT A/S Halfdansgade København S CVR Side 27 af 38

28 3.2.3 Beskrivelse af endpoint EP_ATP Transportspecifikation Integrationsmønster ATP afhenter en requestfil og triggerfil fra Serviceplatformen via Simpel SFTP. Dette svarer til Integrationsmønster IMID11. IMID11 Ekstern FTP SP Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender ATP er serviceanvender Teknologisk understøttelse Snitfladen udveksles via SFTP Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion SFTP platform: Host IP SFTP bruger: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [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: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Teknisk retning for udveksling ATP foretager download fra Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 28 af 38

29 Dataretning for udveksling ATP modtager forespørgsel Service invokation / Triggers ATP afhenter filen torsdag i hver uge kl Dataspecifikation Data udveksles med fast record struktur, hvor data er i en fast positioneret struktur, og triggerfil udveksles i XML jf. afsnit Sikkerhed ATP er anvendersystem af EP_ATP1 og autentikerer via certifikater Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er modtagersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der findes en datafil uden triggerfil. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Fejlhåndtering af data ATP validerer requestfilen efter følgende grundregler (se også afsnit ): Hver række har ingen identifikation på hvad Dataelement/felt hedder. Så rækken indeholder kun data i det bestemte format se tabeller. Værdien af dataelementet SKAL altid indeholde alle de specificeret karakter længde, se tabellerne. Hvis værdien ikke har nogen værdi (NULL) indeholder den det aftalte antal blanke karakter. Hver række har en identifikation om rækken er en Header, Body eller Tail. Hvis det ikke overholdes fejler parseren (Valideringen af filen). Header starter med id en 01, Body er 05 og Tail starter med id en 99. På den måde kan en passer altid finde identificer om rækken er en af de overnævnte typer. KOMBIT A/S Halfdansgade København S CVR Side 29 af 38

30 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 Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Ikke oplyst Service Management Incident Management [Afklaring/ATP: Oplysning skal indhentes] Problem Management [Afklaring/ATP: Oplysning skal indhentes] Change Management [Afklaring/KDF: Det skal præciseres i samarbejdsaftale mellem KOMBIT og ATP, hvordan og med hvilken frist der gives varsel om ændringer.] Testplan Integrationstest [Afklaring/KDF: Det er ikke defineret hvordan dette skal testes.] Produktionssætningstest [Afklaring/KDF: Det er ikke defineret hvordan dette skal testes.] Beskrivelse af endpoint EP_ATP Transportspecifikation Integrationsmønster ATP uploader en response fil og triggerfil til Serviceplatformen via Simpel SFTP Dette svarer til Integrationsmønster IMID12. KOMBIT A/S Halfdansgade København S CVR Side 30 af 38

31 IMID12 Ekstern FTP SP Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender ATP er serviceanvender Teknologisk understøttelse Snitfladen udveksles via SFTP Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion SFTP platform: Host IP SFTP bruger: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [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: ATP KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - ATP_FERIEKONTO_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Teknisk retning for udveksling ATP foretager upload til Serviceplatformen Dataretning for udveksling ATP sender resultatet Service invokation / Triggers ATP afhenter filen torsdag i hver uge kl Dataspecifikation Data udveksles med fast record struktur, hvor data er i en fast positioneret struktur og triggerfil udveksles i XML jf. afsnit KOMBIT A/S Halfdansgade København S CVR Side 31 af 38

32 Sikkerhed ATP er anvendersystem af EP_ATP2 og autentikerer via certifikater Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er afsendersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der placeres en datafil uden at der efterfølgende placeres en triggerfil. Der placeres en datafil og en triggerfil med fejl f.eks. forkert xml format eller modtagersystem findes ikke. Afsendersystem modtager en teknisk fejl fra SFTP, og skal selv slette datafilen. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Fejlhåndtering af data Inden afsendelse af responsefilen validerer ATP requestfilen efter følgende grundregler (se også afsnit ): Hver række har ingen identifikation på hvad Dataelement/felt hedder. Så rækken indeholder kun data i det bestemte format se tabeller. Værdien af dataelementet SKAL altid indeholde alle de specificeret karakter længde, se tabellerne. Hvis værdien ikke har nogen værdi (NULL) indeholder den det aftalte antal blanke karakter. Hver række har en identifikation om rækken er en Header, Body eller Tail. Hvis det ikke overholdes fejler parseren (Valideringen af filen). Header starter med id en 01, Body er 05 og Tail starter med id en 99. På den måde kan en passer altid finde identificer om rækken er en af de overnævnte typer Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Værdi Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Se [SPref] KOMBIT A/S Halfdansgade København S CVR Side 32 af 38