SF1622 Transitionsdata fra STAR Integrationsbeskrivelse - version 1.0.0

Transkript

1 SF1622 Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer EDM 0.1 Første version EDM 0.2 Opdateret med kommentarer fra internt review AMU 0.9 Klar til review af YR AMU Godkendt af YR til release. Referencer Ref Titel Kommentarer [SPref] [SFTP] [GVF] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: [Afklaring/KDI - Indsæt reference til teknisk dokumentation af SFTP løsning] Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Generelle vilkår og forudsætninger Dokumentationen findes på Serviceplatformen i Ekstern Test, men den er ikke formelt godkendt af KOMBIT endnu. [ROUTING] zip-filen [WSDL-EXT] indeholder en SFTPDynamicRoutingInfo.xsd Schema til brug for dynamisk SFTP-UC1 routing 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 YR Kontekst for STAR KOMBIT A/S Halfdansgade København S CVR Side 2 af 29

3 3 Specifikation for integrationsparter Specifikation af endpoints for YR Specifikation af endpoints for STAR Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 3 af 29

4 1 Overordnet beskrivelse 1.1 Integrationens formål Integrationen har til formål at Ydelsesrefusion (YR) kan modtage data fra STAR i en transitionsfase. I denne fase får Ydelsesrefusionen sit beregningsgrundlag fra distributionskilderne, men disse har ikke kendskab til reguleringer fra før transitionsfasen. STAR vil i denne periode levere reguleringer til beregningsgrundlaget fra før transitionsfasen. Transitionsfasen er på 6 måneder hvor ydelsesrefusion vil modtage et månedligt udtræk fra den midlertidige løsning i STAR. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. STAR laver et udtræk fra den midlertidige løsning i STAR, som skal leveres til YR i en transitionsfase samlet for alle myndigheder. STAR overfører leverance (forretningsdatafil med tilhørende triggerfil) til Serviceplatformen Serviceplatformen validerer triggerfil og sikrer, at der findes en modtager til leverance. STAR modtager teknisk kvittering for ansvarsoverdragelse. Det er fagsystems ansvar selv at hente filen Hvis triggerfil er OK: Serviceplatformen genererer metadatafil på baggrund af triggerfil og overfører leverance (forretningsdatafil og metadatafil) til IN-mappe for YR YR henter herefter leverance (forretningsdatafil og metadatafil). Det er YRs ansvar at hente filen. Integrationsflow 1: SF1622_V1_IF01 Modtag transitionsdata fra STAR KOMBIT A/S Halfdansgade København S CVR Side 4 af 29

5 SF5502_V1_IF01 Modtag transitionsdata fra STAR Serviceplatformen STAR Overfør leverance (data- og triggerfil) EP_STAR01 Valider, kvittér og opbevar filer (SFTP-service) Fordel til SFTPbruger: YR EP_STAR01 Hent og slet teknisk kvittering Opbevar filer (SFTP-service) EP_YR1 YR Hent og slet leverance (data- og metadatafil) 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum SF1622_V1_IF01 Overfør transitionsdata fra STAR Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. KOMBIT A/S Halfdansgade København S CVR Side 5 af 29

6 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 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] 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 Incident Management Problem Management Change Management KOMBIT A/S Halfdansgade København S CVR Side 6 af 29

7 1.3.3 Lifecycle Management 1.4 Teststrategi Test i forbindelse med udvikling [Afklaring/YR] Testfaciliteter og testmiljø Serviceplatformens SFTP-service er tilgængelig i eksternt testmiljø. Se [SPref] for detaljer. Derudover: [Afklaring/YR] Testdata [Afklaring/YR] 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 Tilslutning af services For at kunne anvende snitflade er der en række vilkår og forudsætninger, som skal være opfyldt af en integrationspart, der skal tilsluttes. Ved integrationspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætning, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter der skal udføreres som forudsætning for tilslutning af en integrationspart er beskrevet for hver enkelt tilslutningspart i kapitel Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen af et anvendersystem inden for KOMBITs rammearkitektur. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge af den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssig kan udføres i. KOMBIT A/S Halfdansgade København S CVR Side 7 af 29

8 Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse. Kildesystem: Alle aktiviteter i forhold til serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune i forhold til kildesystemet. Anvendersystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter, som skal udføres. Er der aktiviteter, som medfører konfiguration på Serviceplatformen, vil dette ske i forbindelse med leverandørens oprettelse af serviceaftalen for kommunen Særlige vilkår Der skal være indgået en aftale om et integrationstestforløb, og testen skal være godkendt af modtagersystem inden ibrugtagning i produktion. KOMBIT A/S Halfdansgade København S CVR Side 8 af 29

9 2 Kontekst for integrationsparter 2.1 Kontekst for YR Lovhjemmel og forvaltningsmæssigt formål Ydelsesrefusion udspringer af lov 994 Lov om kommunernes finansiering af visse offentlige ydelser udbetalt af kommunerne, Udbetaling Danmark og arbejdsløshedskasserne. 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 Kapacitets- og servicekrav YR henter månedligt dataudtræk med transitionsdata fra STARs midlertidige løsning. Størrelsen på filen kendes ikke, men det forventes at den er mindre end 50 Mb Specifikke forhold for tilslutning af system Dette afsnit beskriver de opgaver, som skal gennemføres i relation til snitfladen. I det følgende er anvendersystem = YR. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS101 TS102 Indgåelse af Databehandleraftale (Dataoverdragelsesaftale) Verifikation af SFTP bruger for simpel SFTP (SFTP- UC1 ) er oprettet Aftale STAR/YR YR YR Fase 1 Samme som TS202 Leverandør af YR Verifikation Serviceplatformen Leverandør af YR Fase 2.2 TS101 - YR skal indgå en databehandleraftale (dataoverdragelsesaftale) med STAR vedrørende udveksling af data i denne snitflade. TS102 - Leverandør af anvendersystem skal verificere, at der er oprettet en simpel SFTPbruger (SFTP ) på serviceplatformen til brug for overførelsen. Se TBA08 i [GVF]. KOMBIT A/S Halfdansgade København S CVR Side 9 af 29

10 2.2 Kontekst for STAR Lovhjemmel og forvaltningsmæssigt formål Ydelsesrefusion udspringer af lov 994 Lov om kommunernes finansiering af visse offentlige ydelser udbetalt af kommunerne, Udbetaling Danmark og arbejdsløshedskasserne. 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 Kapacitets- og servicekrav STAR overfører månedligt dataudtræk med transitionsdata fra STARs midlertidige løsning. Størrelsen på filen kendes ikke, men det forventes at den er mindre end 50 Mb Specifikke forhold for tilslutning af system Dette afsnit beskriver de opgaver, som skal gennemføres i relation til snitfladen. I det følgende er anvendersystem = STAR. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS201 TS202 TS203 Aftale STAR/YR YR YR Fase 1 Samme som TS102 Indgåelse af Databehandleraftale (Dataoverdragelsesaftale) Verifikation af SFTP bruger for simpel SFTP (SFTP- UC1 ) er oprettet Verificer at SFTP for Anvendersystem anvender korrekte parametre for triggerfil Verifikation Verifikation Serviceplatformen Leverandør af STARløsning Leverandør af STARløsning Leverandør af STAR-løsning Leverandør af STARløsning Leverandør af STAR-løsning Fase 2.2 Fase 2.2 TS201 - STAR skal indgå en databehandleraftale (dataoverdragelsesaftale) med YR vedrørende udveksling af data i denne snitflade. KOMBIT A/S Halfdansgade København S CVR Side 10 af 29

11 TS202 - Leverandør af anvendersystem skal verificere, at der er oprettet en simpel SFTPbruger (SFTP ) på serviceplatformen til brug for overførelsen. Se TBA08 i [GVF]. TS203 - Anvendersystem skal verificere, at alle parametre for overførelsen via SFTP er korrekte i triggerfilen: SenderIt-system (UUID for system som defineret i STS Organisation) SenderAuthority (CVR nr.) RecipientAuthority (CVR nr.) Se evt. afsnit 3 i integrationsbeskrivelsen for de resterende parametre. KOMBIT A/S Halfdansgade København S CVR Side 11 af 29

12 3 Specifikation for integrationsparter Integrationen anvendes af hhv. YR og STAR at overfører transitionsdata fra STAR via Serviceplatformens SFTP-server (jf. [SFTP]). Integrationen bør opdeles i to delprocesser: STAR overfører datafil (og triggerfil) til STARs OUT-mappe på serviceplatformens SFTPserver (jf. [SFTP]). Der skal altid leveres to filer; en fil med forretningsdata og en fil med routing information (triggerfil). Efterfølgende hentes og slettes en teknisk kvitteringsfil. YR kan derefter tilgå datafil (og en tilhørende metadatafil) i modtagersystemets egen INmappe (indbakke) på serviceplatformens SFTP-server (jf. [SFTP]). STAR skal efterfølgende slette både datafil og metadatafil. Første gang leveres et fuldt load til initialiseringen af ydelsesrefusion systemet de efterfølgende leverancer vil være et delta med de ændringer som er sket siden forgående leverance 3.1 Specifikation af endpoints for YR Integrationen benyttes af YR til at hente data fra STAR i transitionsfasen via Serviceplatformens SFTP-servicen Overordnet forretningslogik YR etablerer forbindelse til Serviceplatformens SFTP-server. YR henter leverance (forretningsdatafil + metadatafil) på Serviceplatformens SFTP-server i sin INmappe. Operationen GET anvendes. YR sletter efterfølgende datafil og metadatafil. DELETE anvendes Oversigt over endpoints ID Navn EP_YR1 HentSTARTransitionsdata Beskrivelse af endpoint EP_YR1 HentSTARTransitionsdata Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender YR er serviceanvender Teknologisk understøttelse Snitfladen er implementeret med SFTP- kommandoer på Serviceplatformens SFTP-server (jf. [SFTP]) Teknisk endpoint Hentning af filer foretages via det tekniske endpoint EP_YR1. KOMBIT A/S Halfdansgade København S CVR Side 12 af 29

13 Miljø: Produktion SFTP platform: Host Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. IP Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. IP Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit Teknisk retning for udveksling YR kalder SFTP-server på Serviceplatformen for at hente (og slette) filer Dataretning for udveksling YR henter dataudtræk til via SFTP-server på Serviceplatformen Service invokation / Triggers Kommunikation initieres af timer hos YR. Skal/bør koordineres med STARs dannelse af dataudtræk Dataspecifikation Forretningsdatafil Se afsnit Fejl! Henvisningskilde ikke fundet Metadatafil Metadatafilen svarer til den triggerfil, der er afleveret af STAR jf. afsnit Fejl! Henvisningskilde ikke fundet., Dog er recipient erstattet med SFTP-UC1 -Bruger tilhørende til systemet STAR. Se [SFTP] for yderligere oplysninger om metadatafilen Sikkerhed Sikkerhed mellem modtagersystem og Serviceplatformen er baseret på Serviceplatformens sikkerhedsmodel (SSH) for SFTP. Se [SFTP] Leverancesikkerhed og fejlhåndtering Leverance (forretningsdatafil og metadatafil) kan hentes fra SFTP-serveren hver gang YR har foretaget en overførsel. For yderligere information om Leverancesikkerhed og fejlhåndtering, se afsnit Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade København S CVR Side 13 af 29

14 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 [SPref]. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [SPref] [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Tilgængelighed Spidsbelastningsperiode Servicevinduer Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref] Service Management Incident Management Problem Management Change Management Lifecycle Management KOMBIT A/S Halfdansgade København S CVR Side 14 af 29

15 3.1.6 Teststrategi Test i forbindelse med udvikling Testfaciliteter og testmiljø Testdata Test i forbindelse med produktionssætning 3.2 Specifikation af endpoints for STAR Integrationen benyttes af STAR til at overfører data til YR i transitionsfasen via Serviceplatformens SFTP-servicen Overordnet forretningslogik STAR danner leverance (forretningsdatafil og triggerfil). STAR etablerer forbindelse til Serviceplatformens SFTP-server. STAR placerer leverance (forretningsdatafil + triggerfil) på Serviceplatformens SFTP-server i systemets OUT-mappe. Operationen PUT anvendes. STAR henter og sletter teknisk kvitteringsfil i IN-mappen. GET og DELETE anvendes. STAR skal reagere, hvis der er fejl i kvittering Oversigt over endpoints ID Navn EP_STAR1 OverførSTARTransitionsdata Beskrivelse af endpoint EP_STAR1 OverførSTARTransitionsdata Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender STAR er serviceanvender. KOMBIT A/S Halfdansgade København S CVR Side 15 af 29

16 Teknologisk understøttelse Snitfladen er implementeret med SFTP- kommandoer på Serviceplatformens SFTP-server (jf. [SFTP]) Teknisk endpoint Overførsel af filer foretages via det tekniske endpoint EP_STAR1. Miljø: Produktion SFTP platform: Host Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. IP Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit 2.1. IP Oplysning leveres af Serviceplatformen ved oprettelse af bruger. Se afsnit Teknisk retning for udveksling STAR kalder SFTP-server på Serviceplatformen for at hente (og slette) filer Dataretning for udveksling STAR henter dataudtræk til via SFTP-server på Serviceplatformen Service invokation / Triggers Kommunikation initieres af timer hos STAR Dataspecifikation Forretningsdatafil Filformatet er CSV. Feltnavn Type Beskrivelse 1 Gtaeller Number Genoptjningstæller 2 Jobindsatslabel String(100) 3 Kommune String (3) Kommunekode 4 Kommune_navn String(35) Navnet på kommunen 5 Sats Number 6 Type Number KOMBIT A/S Halfdansgade København S CVR Side 16 af 29

17 7 Ytaeller Number Ydelsestæller 8 Befordring Number Befordringsbeløb 9 Beloeb number Bruttoudgift 10 Bevleddato Date visitationsdato 11 fleksbidrag Number 12 Id Number 13 Konbeloeb Number 14 Konplangrp String 15 Konsldato Date Slut dato 16 Konstdato Date Start dato 17 Korr_befordring Number Korrektion befordring 18 Korr_beloeb Number 19 Korr_fleksbidrag Number 20 Korr_medfinansiering Number 21 Korr_refusion Number 22 Korrektion String(1) 23 Maaned String(8) 24 Manuel String(6) 25 Medfinasiering Number 26 Medfinansieringsats Number 27 Periode Date 28 Refusion Number Refusionsbeløb 29 Refusionssats Number 30 Ugedato date År og uge 31 Ydtype String(3) ydelsestype KOMBIT A/S Halfdansgade København S CVR Side 17 af 29

18 Filnavn bør fx angives ud fra følgende standard: [Brugernavn]_STARTransitionsdata_[Løbenummer].txt [Brugernavn]: Fagsystemets SFTP-brugerident, YR-SIMPEL-SFTP-1 [Løbenummer: Skal sikre unikt filnavn, fx UUID eller sekvensnummer. Det er dog op til den enkelte integrationspart, at afgøre præcis hvad datafilen skal hedde. Der kan ikke samtidig være flere filer med samme filnavn. Det er ikke tilladt at anvende ekstensionen.trigger Triggerfil Ved overførelse af en datafil via SFTP skal anvendersystemet danne en triggerfil, som skal ledsage datafilen. Encoding er [UFT8] uden BOM. Filnavnet skal være det samme som for datafilen + extension. Filtypen er.trigger. Filnavn:[Titel datafil].[extension].trigger <any>-feltet i FileContentDescriptor skal erstattes af element <SFTPDynamicRoutingInfo> som er defineret i [ROUTING] Triggerfilen er XML-baseret og skal indeholde information om forsendelsen, som vist nedenfor: Feltnavn Niveau Kardinalitet Format Værdisæt / note 1 FileContentDescriptor 7 SFTPDynamicRoutingInfo 1 <InfRef> SF1622_V1_IF01 </InfRef> 2 <SenderIt-system> [UUID (FagsystemID)] </SenderIt-system> 3 <SenderAuthority> [urn:oio:cvr-nr:nnnnnnnn] </SenderAuthority> 4 <TransactionId> [UUID] </TransactionId> 5 <SenderTimestamp> [DateTime] </SenderTimestamp> SF1622_V1_IF01 Defineret i STS Organisation som et it-systeminstans. Defineret i STS Organisation som en myndighed. For STAR anvendes anvendes relevant myndigheds CVR-nummer. TransaktionsID Tidsstempel KOMBIT A/S Halfdansgade København S CVR Side 18 af 29

19 Feltnavn Niveau Kardinalitet Format Værdisæt / note 6 <RecipientIt-system> </RecipientIt-system> Udfyldes ikke 7 <RecipientAuthority> [urn:oio:cvr-nr:nnnnnnnn] </RecipientAuthority> CVR-nummer for modtagende myndighed for YR. Defineret i STS Organisation som en myndighed. 1 FileDescriptor 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 afsendersystemet. - SendersFileId 1 String(250) Afgøres af YR og/eller STAR. - Recipients 1 String(250) Se [SFTP] for yderligere oplysninger om triggerfilen. Formål er at modtagende myndighed (STAR) kan identificere filtypen. Et muligt forslag kan være: Ydelsesrefusion Beregning Teknisk kvitteringfil STAR henter i sin IN-mappe (indbakke) på SFTP-servicen en teknisk transportkvittering. Kvitteringen har samme filnavn som datafilen + extension. Filtypen er.sftpreceipt. Filnavn:[Titel datafil].[extension].sftpreceipt Se [SFTP] for yderligere oplysninger om den tekniske kvittering. Encoding er [UTF8] uden BOM. Det vil fremgå af kvitteringsfilen, hvis leverance ikke kan afleveres til modtager (YR) Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er baseret på Serviceplatformens sikkerhedsmodel (SSH) for SFTP. Se [SFTP] Leverancesikkerhed og fejlhåndtering Leverance (forretningsdatafil og triggerdatafil) uploades til SFTP-serveren én gang om måneden. KOMBIT A/S Halfdansgade København S CVR Side 19 af 29

20 YR aftaler en manuel proces med STAR for godkendelse af leverance. Der sker ingen validering på Serviceplatformen. Transaktioner, der ikke overholder snitfladebeskrivelsen eller indeholder ugyldige data, vil YR kontakte STAR support. Fejlhåndteringen er manuel. Der sendes ikke forretningsmæssige kvitteringer eller fejlmeddelelser. Hvis datafil og triggerfil kan håndteres korrekt af SFTP-servicen, vil SFTP-servicen fjerne disse fra STARs OUT-mappe og danne en teknisk transportkvittering som dokumentation for, at SFTP-servicen har overtaget transportansvaret. STAR har ansvar for løbende at kontrollere for modtagelse af teknisk transportkvittering i sin INmappe. STAR kvitterer for modtagelse af teknisk transportkvittering ved at slette den fra sin INmappe. Hvis overtagelsen ikke blev gennemført succesfuldt vil det fremgå af den tekniske transportkvittering. Igen kvitterer STAR for modtagelsen af denne ved at slette den. STAR 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. YR har selv ansvar for at hente og slette leverance (forretningsdatafil og metadatafil). YR kvitterer for modtagelse af leverance ved at slette den fra sin IN-mappe. Serviceplatformen vil løbende monitorere anvendersystemernes IN- og OUT-mapper. Der vil blive rejst et incident (via rapportering) til anvendersystemet, hvis der ligger ubehandlede filer i mere end [2 døgn]. Se endvidere [SFTP] for yderligere information om brug af SFTP-serveren Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed 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]. KOMBIT A/S Halfdansgade København S CVR Side 20 af 29

21 Spidsbelastningsperiode Servicevinduer 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] Service Management Incident Management Problem Management Change Management Lifecycle Management Teststrategi Test i forbindelse med udvikling Testfaciliteter og testmiljø Testdata Test i forbindelse med produktionssætning KOMBIT A/S Halfdansgade København S CVR Side 21 af 29

22 KOMBIT A/S Halfdansgade København S CVR Side 22 af 29

23 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 2. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. YR EP_YR1 Serviceplatformen IF01 Modtag transitionsdata fra STAR EP_STAR1 STAR Dataretning Oversigt over integrationsflows ID Navn IF01 Modtag transitionsdata fra STAR Integrationsflow IF01: Modtag transitionsdata fra STAR Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_YR1 HentSTARTransitionsdata Afsnit EP_STAR1 OverførSTARTransitionsdata Afsnit Integrationstype Simpel SFTP transport jf. SFTP UC 1, hvor der foretages routing baseret på tabelopslag. KOMBIT A/S Halfdansgade København S CVR Side 23 af 29

24 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. STAR Serviceplatformen YR SFTP-service Trin 1 EP_STAR1 Trin 2 Routing Trin 3 Trin 5 Trin 4 Trin 6 EP_YR1 Trin 7 Beskrivelse af hvert trin i integrationsflowet: Trin 1 STAR placerer triggerfil og korresponderende datafil i sin OUT-mappe på Serviceplatformens SFTP-service EP_FS1 Triggerfilen vil pege på Serviceplatformen som recipient. Trin 2 SFTP-servicen læser og validerer triggerfilen, samt vælger recipient ud fra data angivet i triggerfilens <FileContentDescriptorType> struktur. En række med Triggerfilens elementer <IntRef>, <SenderAuthority> og <SenderItsystem> og <RecipientAuthority> skal findes i konfigurationstabellen. Recipienten, SFTP-UC1 -Bruger repræsenterende YR, findes ved opslag i konfigurationstabellen, afsnit Fejl! Henvisningskilde ikke fundet., ud fra angivelse af RecipientAuthority. Såfremt der ikke findes en sådan bruger afsluttes integrationsflowet med afgivelse af negativ teknisk kvitteringsfil til STARs IN-mappe. Trin 3 SFTP-servicen substituerer recipienten i triggerfilen til SFTP-UC1 -bruger repræsenterende YR. KOMBIT A/S Halfdansgade København S CVR Side 24 af 29

25 Trin 4 SFTP-servicen flytter standardmæssigt datafil og metadatafil til mappen for recipienten. SFTP-servicen danner positiv eller negativ teknisk kvitteringsfil, og placerer denne fil i STARs IN-mappe. Trin 5 STAR henter teknisk kvitteringsfil til brug for egen kontrol og eventuel fejlhåndtering. STAR fjerner filen efter afhentning, som accept på håndtering af evt. fejl. Trin 6 Trin 7 YR vil, uafhængigt af resultatet af trin 5, løbende polle på egen IN-mappe for at hente metadatafil og datafil. YR sletter datafil og metadatafil, som bekræftelse på, at betalingsadministrationssystemet har overtaget ansvaret for disse Datafil Datafilen ændres ikke og er som angivet i Fejl! Henvisningskilde ikke fundet Triggerfil Triggerfilen ændres ikke og er beskrevet i afsnit Fejl! Henvisningskilde ikke fundet.. Encoding er [UFT8] uden BOM Metadatafil Samme filnavn som datafilen. Filtypen er.metadata. Metadatafilen er standardmæssigt for SFTP-service baseret på Triggerfilen i , dog er <Recipient> erstattet med Modtagerens SFTP-UC1 -bruger jf. Trin 3 ovenfor. Encoding er [UFT8] uden BOM Teknisk kvitteringsfil Samme filnavn som datafilen. Filtypen er.sftpreceipt. Encoding er [UFT8] uden BOM.. [SP/SSE: Der skal her tilføjes fejlkoder, som dækker fejl ifm. routing og overskridelse af maksimal datafilstørrelse. De skal efterfølgende opdateres under EP_FS1]. Beskrivelsen findes her [SFTP] Datatransformering Ikke relevant Datapersistering Triggerfil og datafil persisteres på SFTP-serveren indtil de succesfuldt er afhentet af STAR. KOMBIT A/S Halfdansgade København S CVR Side 25 af 29

26 Databerigelse Ikke relevant Routing Der foretages en simpel routing baseret på en konfigurationstabel mellem YR og en SFTP-UC1 - Bruger repræsenterende dennes konkrete system Routinglogik [Afklaring/KDI] dette afsnit er en generel beskrivelse af routingfunktionaliteten i SFTP-UC1, som også findes i andre integrationsbeskrivlser, f.eks. for ØiR. Dvs. afsnittet er ikke tilpasset denne integration. Afsnittet skal fjernes, når der foreligger officiel dokumentation for denne SFTP-service] Følgende tabeller etableres på Serviceplatformen indtil Serviceaftale for SFTP kan etableres i STS-Sikkerhed. Tabellerne og logik beskrevet nedenfor vil senere blive udvidet med det der kræves for at beskedfordeleren kan tages i anvendelse. Tabellen InfTable konfigureres med den enkelte snitflades-flows MeddelelsesRelation InfTable indeholdende følgende felter: Kolonne Type Beskrivelse InfRef String Snitfladens navn. InfRef bruges i FileContentDescriptorType strukturen i Triggerfil InfType String MeddelelsesRelation Værdien Request eller Response Tabellen RoutingTable konfigureres med relationer mellem afsender (sender) og modtager (recipient) i forhold til snitfladen og bruges til at afgøre hvilken SFTP-UC1 -bruger der skal routes til. Konfigurationsregel: For hver snitflade, der registreres til at udveksle information mellem én myndigheds fagsystem og ØIR, skal der konfigureres to rækker - snitflade-flow med meddelelsesrelation Request og et snitflade-flow med meddelelsesrelation Response. Kolonne Type Beskrivelse InfRef String Snitfladens navn. InfRef bruges i FileContentDescriptorType strukturen i Triggerfil SenderAuthority Urn Afsender Myndighed. Navnet bruges i FileContentDescriptorType strukturen i Triggerfil SenderIt-system UUID Afsender IT-system. Navnet bruges i FileContentDescriptorType strukturen i Triggerfil recipientauthority Urn Modtager Myndighed. Navnet bruges i FileContentDescriptorType strukturen i Triggerfil RecipientIt-system UUID Modtager IT-system. Navnet bruges i FileContentDescriptorType strukturen i Triggerfil KOMBIT A/S Halfdansgade København S CVR Side 26 af 29

27 FTP-User String SFTP-UC1 -bruger der skal benyttes i den givne kontekst Routing foretages vha. følgende logik: Først opslag i InfTabel for at finde InfType baseret på <InfRef> i Triggerfilens <FileContentDescriptorType>: Select InfType from InfTable where InfRef=<InfRef> Der fejlmeldes teknisk fejl hvis der ikke findes en række. Herefter slås SFTP-UC1 bruger op I RoutingTabel baseret på tags i Triggerfilens <FileContentDescriptorType> og med forskellig logik baseret på InfType fundet i opslag ovenfor: Hvis Inftype = Request udføres følgende opslag Select FTP-User from RoutingTable where (InfRef = <InfRef> AND SenderAuthority = <SenderAuthority> AND SenderITSystem = <SenderITSystem> AND RecipientAuthority=<RecipientAuthority>) Hvis Inftype = Response udføres følgende opslag Select FTP-User from RoutingTable where (InfRef = <InfRef> AND SenderAuthority = <SenderAuthority> AND SenderITSystem = <SenderITSystem> AND RecipientSystem=<RecipientSystem>) Der fejlmeldes teknisk fejl hvis der ikke findes en række Eksempel på udfyldelse af tabeller involveret i routing InfTable: InfRef InfType SF1590_B_IF02-03 Request SF1590_B_IF04 Response KOMBIT A/S Halfdansgade København S CVR Side 27 af 29

28 RoutingTable: InfRef SenderAuthority SenderIt-system RecipientAuthority RecipientIt-System FTP-User SF1590_B_IF02-03 Århus KY Århus EG EG-user SF1590_B_IF04 Århus EG Århus KY KY-user SF1590_B_IF02-03 Århus KSD Århus EG EG-user SF1590_B_IF04 Århus EG Århus KSD KSD-user SF1590_B_IF02-03 Århus TEK Århus KMD KMD-user SF1590_B_IF04 Århus KMD Århus TEK TEK-user SF1590_B_IF02-03 UDK UDK Århus EG EG-user SF1590_B_IF04 Århus EG UDK UDK UDK-user Orkestrering Ikke aktuelt Sikkerhed Sikkerhed mellem systemerne og Serviceplatformens SFTP-server er SSH-baseret [SFTP] Logning Standard logning på Serviceplatformen skal suppleres med logning mellem den tekniske kvitteringsfils fejlkoder i sammenhæng med den negative transportkvittering sendt i svaret til fagsystemet. Endvidere skal grundlag for og valg af routing, dvs. ændring af recipient, logges Testdata og testfaciliteter Konfiguration Validering: Konfigurationstabel, som angiver maksimal størrelse i bytes på datasæt til modtagersystem. Det må forventes, at denne grænseværdi løbende trimmes ift. belastning på serviceplatformen. Routing: Opsætningstabel med angivelse af sammenhæng mellem RecipientAuthority og SFTP-UC1 -Bruger. Samme bruger kan anvendes af flere RecipientAuthority ifm. ASP-drift. Til brug for sikkerhed: Overgangsløsning hvis dobbelt myndighedsgodkendelse ikke understøttes af STS Sikkerhed. Tabel med angivelse tilladte kombinationer mellem SenderAuthority og RecipientAuthority. Der skal foreligge en papirbaseret aftale parterne i mellem, som grundlag for denne registrering. KOMBIT A/S Halfdansgade København S CVR Side 28 af 29

29 Supplerende information Serviceplatformen skal etablere aktiv overvågning af hver af fagsystemernes In-mapper for at sikre rettidighed afhentning trigger og datafil (jf. slette-bekræft-model). Serviceplatformen skal etablere aktiv overvågning af fagsystemernes In-mapper for at sikre rettidighed afhentning teknisk kvitteringsfil (jf. slette-bekræft-model). Der skal opsættes tærskelværdier for eskalering af manglende afhentning, herunder orientering af fagsystemerne Generelle forhold for tilslutning til integrationspart: Serviceplatformen Dette kapitel lister de forudsætninger, som skal være opfyldt for at Serviceplatformen kan udstille den pågældende snitflade. [Afklaring/SSE: Der mangler samlet proces for, hvordan postkonfiguration skal leveres og oprettes på Serviceplatformen. Herunder, hvordan skal integrationsparter (både anvender/udstiller) indgå i denne proces]. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP01 Opret post konfiguration Konfiguration Serviceplatformen Serviceplatformen SSE Fase 1 TSP01 - Serviceplatformen skal implementere et post-konfig trin til oprettelse af en serviceaftale og rutningsparameter. Følgende parametre registreres. [Afklaring/KDI dette afsnit skal opdateres, når der foreligger endelig beslutning vedr. placering af ansvar for udførsel af aktiviteten] Ydelsesrefusion Beregning o SF1622_V1_IF01 STAR o Afsendermyndighed/kommunes CVR-nr. o Afgivne systeminstans (UUID for systeminstans) YR o Modtagermyndigheds CVR-nr. o Modtagende systeminstans (UUID for systeminstans) Den anvendte SFTP-bruger er givet ud fra det IT-system, der er angivet for afsender- og bogførings-system. KOMBIT A/S Halfdansgade København S CVR Side 29 af 29