Integration SF1590_A - ØiR - Afsend økonomipostering til ØiR (Finans) Integrationsbeskrivelse - version 2.1.0 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2015-06-30 edm 0.1 Første version 2015-07-01 ehe 2.0.0 Teknisk specifikation indarbejdet 2015-08-30 MMT 2.1.0 Følgende afsnit har fået ændret tekst så den afspejler at det er antallet af posteringer der bestemmer mønstret: 3.1.1. 3.2.1. 4.1.2.2. 4.1.2.3. - Reference [WSDL-SP] er ændret, da der er kommet opdateret wsdl. Følgende ændringer er indeholdt: Filer som ikke har noget med 1590A er slettet. OIRFinansbilagTypes.xsd: AlternativeDimensioner slettet. Referencer Ref Titel Kommentarer [SPref] PrimæreDimensioner.Kommunenummer erstattet af PrimæreDimensioner.CVR-nummer. [SIKKER- HED] [STS-Sikkerhed] Bilag 7B Ydelser og servicemål for Serviceplatformen Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 Integrationsvilkår Bilag 2. Sikkerhed version 1.3 [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeleren [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeleren [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeleren [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeleren [WSDL-SP] Integrationsbeskrivelsen refererer til SF1590 Teknisk Spec 20150812 A.zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 10
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... 8 1.4 Teststrategi... 8 1.5 Forudsætninger for produktionssætning af integration... 9 2 Kontekst for integrationsparter... 10 2.1 Kontekst for KY, KSD [!@KY@!][!@KSD@!]... 10 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 10
1 Overordnet beskrivelse 1.1 Integrationens formål ØiR Økonomi i Rammearkitekturen indeholder en række snitflader, som benyttes af fagsystemerne til at give en ensartet snitflade mod de bagvedliggende ERP-systemer til håndtering af finans- og debitorposteringer samt udbetalinger. Denne integration dækker finanspostering. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Finansposteringsflow (synkront og asynkront) Forretningskvitteringsflow (asynkront) Finansposteringsflowet starter, når et fagsystem har behov for at postere i finans i ERP-systemet. Fagsystemet afsender op til 100 posteringer af gangen. ØiR modtager posteringerne og bestemmer på antallet af posteringer om de skal gennemstilles til ERP-systemet på webservice (synkront) eller leveres som fil gennem FTP (asynkront). Enkelte posteringer bliver gennemstillet synkront til ERP læsningen og batches med to eller flere posteringer leveres på SFTP. Hvis asynkront vil ØiR danne en XML-fil med tilhørende triggerfil til Serviceplatformens SFTP-server og overføre filerne til denne. Triggerfilen viser modtageren og overføre filerne til modtagers udboks. Her afhenter ERP-systemet filerne til efterfølgende postering. Hvis synkront gennemstiller ØiR direkte til ERP-systemets webservice og afleverer posteringen. ERP-systemet posterer direkte, mens der dannes en forretningskvittering for posteringen, som returneres i webservice-kaldet. ØiR gennemstiller forretningskvitteringen i svaret til fagsystemet. Dette er vist i nedenstående flow. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 10
ERP-system SFTP (Serviceplatformen) ØiR (Serviceplatform) Fagsystem(n) Integrationsbeskrivelse Finansposteringsflow Synkront (webservice) og asynkront (FTP) Afsende finansposteringer Modtag forretningskvitteringer Modtage finansposteringer Modtage forretningskvitteringer Ja FTP? Dan fil og trigger Serviceaftale/ Sikkerhed Overføre fil og trigger Nej Overføre fil og trigger Afhent finansposteringer Modtage finansposteringer Poster og dan kvitteringer Afsend forretningskvitteringer Når posteringerne er afleveret asynkront, vil ERP-systemet, når det har hentet posteringerne på SFTP-serveren, postere og danne forretningskvitteringer. Forretningskvitteringerne placeres i en KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 10
XML-fil sammen med en triggerfil, som efterfølgende overføres til SFTP-serveren. Triggerfilen viser modtageren, ØiR, som henter filerne fra SFTP serveren. ØiR sender en kvittering af gangen til BeskedFordeler, hvorefter fagsystemet vil se dem i dueslaget og hente dem. Nedenstående figur viser dette flow. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 10
ERP-system SFTP (Serviceplatformen) ØiR (Serviceplatform) BeskedFordeler Fagsystem(n) Integrationsbeskrivelse Kvitteringsflow Asynkront (FTP) Modtag besked Modtage besked Distribuer besked til dueslag Udstil besked Opdel fil i beskeder Serviceaftale/ Sikkerhed Afhent fil og trigger Overføre fil og trigger Dan kvitteringsfil og trigger Overfør fil og trigger KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 10
1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Finansposteringsflow Kvitteringsflow Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.3.2 Service Management 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?] 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: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 10
[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] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 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] 1.5 Forudsætninger for produktionssætning af integration Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter. 1.5.1 Forudsætninger for funktionalitet på Serviceplatformen Det er en forudsætning for integrationen, at de nødvendige abonnementer er oprettet på Beskedfordeler. De konkrete informationer om abonnementerne er angivet i specifikationerne af de relevante endpoints i afsnit 3. 1.5.2 Generelle forsætninger for tilslutning af ny integrationspart Det er en forudsætning for den asynkrone integration, at de nødvendige abonnementer er oprettet på Beskedfordeler. De konkrete informationer om abonnementerne er angivet i specifikationerne af de relevante endpoints i afsnit 3. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 10
2 Kontekst for integrationsparter 2.1 Kontekst for KY, KSD [!@KY@!][!@KSD@!] 2.1.1 Lovhjemmel og forvaltningsmæssigt formål Kommunens datavideregivelse af finanspostering til kommunens ERP-/Finansløsning via ØiR SF1590A følger lov om kommunens styrelse - kommunens økonomiske forvaltning, jf. jf. lovbekendtgørelse nr. 971 af 25. juli 2013, med de ændringer, der følger af 9 i lov nr. 639 af 12. juni 2013 og 1 i lov nr. 1470 af 17. december 2013. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål er at [ ] [Udfyldes med en kortfattet beskrivelse af de forvaltningsmæssige formål med anvendelse af servicen.] 2.1.2 Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Forventet volumen til snitfladen er 3.500 overførsler om måneden 2.1.3 Specifikke forsætninger for tilslutning af denne integrationspart Ingen identificeret. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 10