Integration SF1180 Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Integrationsbeskrivelse - version 0.1 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-12-10 MHO 0.1 Første version Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS- Sikkerhed] [MQ?] 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 [Indsæt reference for dokumentation af MQ] [SF1460_A] Modtag Besked Integrationsbeskrivelse for modtagelse af beskeder fra Beskedfordeler. Endnu ikke udarbejdet [SF1460_C] Aflever Besked Integrationsbeskrivelse for afsendelse af beskeder til Beskedfordeler Endnu ikke udarbejdet. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 44
Indholdsfortegnelse 1 Overordnet beskrivelse... 4 1.1 Integrationens formål... 4 1.2 Overordnet forretningsflow i integrationen... 4 1.3 Servicebetingelser for den samlede integration... 5 1.4 Teststrategi... 7 1.5 Tilslutning af services... 8 2 Kontekst for integrationsparter... 10 2.1 Kontekst for SAPA vedr. årsopgørelse... 10 2.2 Kontekst for SAPA vedr. forskudsopgørelse... 10 2.3 Kontekst for KY vedr. årsopgørelse... 11 3 Specifikation for integrationsparter... 13 3.1 Specifikation af endpoints for SAPA og KY... 13 3.2 Specifikation af endpoints for KMD Indkomst... 22 3.3 Specifikation af endpoints for Beskedfordelser... 33 4 Beskrivelse for integrationsplatforme... 37 4.1 Beskrivelse for Serviceplatformen... 37 4.2 Beskrivelse for Beskedfordeleren... 43 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 44
1 Overordnet beskrivelse 1.1 Integrationens formål Integration har til formål at modtage advisering om ændringer i årsopgørelser og forskudsopgørelser for en given personkreds fra SKAT via KMD Indkomst. Adviseringerne benyttes i fagsystemet til at generere ændringshændelser for personens skatterelaterede indkomst- og omkostningsgrundlag. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet leverer hver måned (jf. driftsaftale med KMD) et request med en liste over de CPR-numre, der skal indgå i personkredsen for den kommende måneds forsendelser med adviseringer om ændringer i års- og forskudsopgørelser fra KMD Indkomst (der sendes et request for hver kombination af kommune, sagsområde og funktion). Requestet sendes via et synkront kald til en af to services udstillet af Serviceplatformen til modtagelse af henholdsvis årsopgørelser eller forskudsopgørelser. Efter modtagelsen persisterer Serviceplatformen journalnummeret fra requestet og angivelse af afsendersystemet. Serviceplatformen transformerer requestet og sender det via MQkø (push) til KMD Indkomst. KMD Indkomst validerer indberetningen af personabonnementer ved modtagelsen og svarer tilbage med kvittering eller fejlmeddelelse via MQ-køen, hvor Serviceplatformen henter dem (pull). Herefter oprettes personabonnementerne. Adviseringen om ændringer i forskuds- og årsopgørelsesdata (og evt. fejlmeddelelser) for den angivne personkreds leveres løbende via MQ-køen, når ændringerne modtages fra SKAT. Efter modtagelsen persisterer Serviceplatformen kvitteringer og advisdata. Disse beriges med journalnummeret, der blev angivet af fagsystemet, og leveres via Beskedfordeleren til fagsystemet. For advisdatas vedkommende sendes der en besked pr. ændret opgørelse. Når fagsystemet har modtage sumkvittering afstemmes denne. Fagsystemet vurderer selv, hvornår abonnement på Beskedfordeleren nedlægges igen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 44
KMD Indkomst Serviceplatformen Beskedfordeler Fagsystem (n) Integrationsbeskrivelse Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse IF01 Indsend personkreds IF02 - Modtag kvittering og advis Opdater årsopgørelse Opdater forskudsopgørelse Kvittering Fejlbeskeder pr. person Modtag advisdata Afsend personkreds årsopgørelse Afsend personkreds forskudsopgørelse Lyt på kø Modtag returdata AMQP Pull Fordel returdata Modtag personkreds årsopgørelse Modtag personkreds forskudsopgørelse Send opdelt data Persister journalnummer Persister journalnummer Opdel advisdata og tilføj journalnummer Transformation til MQ Transformation til MQ Lyt på kø Hent returdata MQ Push MQ Push MQ Pull Modtag personkreds Dan advisdata Udstil returdata Dan kvitteringer 1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Flow 1 Flow 2 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 44
Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/BF driftsaftale] [Afklaring/KMD Indkomst: Aftales senere] 1.3.2 Service Management 1.3.2.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 44
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å integrationen?] 1.3.3 Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] 1.4 Teststrategi 1.4.1 Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.4.1.1 Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD Indkomst: Findes der et testmiljø med brugbare testdata?] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD Indkomst: Findes der et testmiljø med brugbare testdata?] 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. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 44
Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD Indkomst: Aftale vedr. produktionssætning udestår] 1.5 Tilslutning af services 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 Funktionalitet på Serviceplatformen KOMBIT og KMD skal indgå aftale om Serviceplatformens anvendelse af KMD Indkomst. Aftalen giver Serviceplatformen adgang til at repræsentere de kommuner, der lever op til kravene nedenfor (afsnit Fejl! Henvisningskilde ikke fundet.). Serviceplatformen må kun anvende løsningen for de kommuner, KOMBIT har indgået aftale med, og Serviceplatformen må kun kommunikere om personer, der er dækket af de indgåede aftaler. Ved kald til KMD Indkomst skal Serviceplatformen identificere sig med et certifikat, som hos KMD er tilknyttet en pseudo-bruger. Pseudo-brugeren skal være autoriseret til en rolleprofil, som giver adgang til denne løsning. Rolleprofilen tildeles ifm. indgåelse af aftale med KMD herom. Der skal etableres MQ-klient på Serviceplatformen. 1.5.2 Funktionalitet på Beskedfordeleren For at kunne benytte Beskedfordeleren skal konfiguration være foretaget korrekt. Dette omfatter: Opsætning af nødvendige serviceaftaler i Støttesystemet Administrationsmodulet De beskeder, der afsendes, skal være oprettede i Beskedfordeler og skal løbende vedligeholdes Etablering af relevante abonnementer og dueslag i Beskedfordeler, herunder opsætning af dueslag, leverance af beskeder, dvs. enten afhentning eller levering. Fagsystemet skal have oprette service til modtagelse / afhentning af beskeder. 1.5.3 Generelle forhold for tilslutning til integrationspart: KMD For at skaffe adgang til informationen fra KMD Indkomst / SKAT kræves det, at kommunen udfører følgende opgaver, inden fagsystemet kan anvende denne service: Anskaffer licens til brug af KMD Indkomst. Oplyser over for KMD, at Serviceplatformen må agere på kommunens vegne. Herunder hvilke sagsområder og funktioner, Serviceplatformen må få adgang til. Opretter dataoverførelsesaftale med SKAT vedr. brug af årsopgørelser og forskudsopgørelser. Autoriserer KMD i SKATs revisorordning til at kommunikere med SKAT på kommunens vegne. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 44
KMD skal etablere dedikerede MQ-køer til denne forbindelse. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 44
2 Kontekst for integrationsparter 2.1 Kontekst for SAPA vedr. årsopgørelse 2.1.1 Lovhjemmel og forvaltningsmæssigt formål Lovhjemmel til brug af integrationen og det forvaltningsmæssige formål er dokumenteret i vedhæftede reference: SKAT Hjemmelgrundlag for brug af eindkomst. Der henvises også til Persondataloven sammen med helhedsorienteret sagsbehandling. Persondataloven foreskriver, at der skal være et sagligt formål med indhentning af oplysninger. Se formål nedenfor. 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 med at advisere kommunebrugere om en borgers overskydende skat på baggrund af årsopgørelsen er, at overskydende skat er en ekstra indtægt, som skal medtages i beregning af forskellige kommunale ydelser. En sådan ændring kan have stor indflydelse på de ydelser, som borgeren modtager fra kommunen. F.eks. hvis en borger får 6.000,- tilbage i skat, ville det betyde at borgerens månedlige rådighedsbeløb det forgangne år burde have været 500,- større. Derfor burde den folkepension, som borgeren modtog det forgangne år, nedjusteres. 2.1.2 Kapacitets- og servicekrav [Udfyldes med oplysninger om krav til kapacitet og service fx forventninger til antal transaktioner og volumen, oplysninger om spidsbelastninger, særlige krav til oppetid] Hændelser må, når de modtages af beskedfordeleren, ikke være mere end 1 døgn gamle. 2.1.3 Specifikke forhold for tilslutning af system Ingen identificeret. 2.2 Kontekst for SAPA vedr. forskudsopgørelse 2.2.1 Lovhjemmel og forvaltningsmæssigt formål SAPA skal i forbindelse med den kommunale forretning, kunne håndtere adviseringer om ændringer i borgernes skattemæssige forskudsoplysninger. Disse oplysningerne er eksempelvis nødvendige i forhold til den lovmæssige efterregulering af økonomisk fripladstilskud, jf. Dagtilbudsloven (https://www.retsinformation.dk/forms/r0710.aspx?id=164345). I henhold til Dagtilbudsloven er Kommunalbestyrelsen forpligtet til at give et økonomisk fripladstilskud under hensyn til forældrenes økonomiske forhold, jf. eksempelvis 43, punkt 2. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 44
Data til understøttelse af den lov og pligtmæssige kommunale forretning, er blandt andet underlagt Persondatalovens 6, punkt 5 og 6 (https://www.retsinformation.dk/forms/r0710.aspx?id=828), hvor kommunernes sagsbehandlere skal kunne tilgå data som: er nødvendig af hensyn til udførelsen af en opgave i samfundets interesse, er nødvendig af hensyn til udførelsen af en opgave, der henhører under offentlig myndighedsudøvelse, som den dataansvarlige eller en tredjemand, til hvem oplysningerne videregives, har fået pålagt 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 med at advisere kommunebrugere om ændring i en borgers forskudsopgørelse er, at en ændring i forskudsopgørelsen oftest beskriver en forventet kommende ændring i det skatterelaterede indkomst- og omkostningsgrundlag. En sådan ændring kan have stor indflydelse på de ydelser, som borgeren modtager fra kommunen. F.eks. afhænger en borgers boligstøtte det kommende år af den forventede indtægt, hvorfor en ændring i indtægten kan medføre at boligstøtten. Det samme gør sig også gældende for efterregulere økonomisk fripladstilskud. 2.2.2 Kapacitets- og servicekrav [Udfyldes med oplysninger om krav til kapacitet og service fx forventninger til antal transaktioner og volumen, oplysninger om spidsbelastninger, særlige krav til oppetid] Hændelser må, når de modtages af beskedfordeleren, ikke være mere end 1 døgn gamle. 2.2.3 Specifikke forhold for tilslutning af system Ingen identificeret. 2.3 Kontekst for KY vedr. årsopgørelse 2.3.1 Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 44
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 med integrationen er at kunne generere hændelser omkring overskydende skat, da der er behov for at vide, hvornår en persons årsopgørelse ændres. Denne snitflade dækker dette behov. 2.3.2 Kapacitets- og servicekrav Forventet volumen for snitfladen er estimeret til: Indberettede abonnementer på personkreds ca. 100-200 filer per måned Modtagne hændelsesbeskeder ca. 425.000 475.000 per år. 2.3.3 Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 44
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for SAPA og KY Integration benyttes af sygedagpengesystemet og sagsoverblik/partskontakt-løsningen (fagsystemerne) til indberetning af personkreds til advisering om ændringer i en persons årsopgørelse (KY og SAPA) eller forskudsopgørelse (SAPA) fra KMD Indkomst. Adviseringerne benyttes i fagsystemet til at generere hændelser for personens skatterelaterede indkomst- og omkostningsgrundlag. 3.1.1 Overordnet forretningslogik Fagsystemet kalder Serviceplatformen, som udstiller en synkron service, der understøtter oprettelse af personabonnement for en personkreds (der sendes et request for hver kombination af kommune, sagsområde og funktion) hos KMD Indkomst. Adviseringer og kvitteringer leveres til fagsystemet via Beskedfordeleren. 1. Fagsystemet kalder EP_FS1 for årsopgørelse eller EP_FS2 for forskudsopgørelse på Serviceplatformen (synkront kald) 2. Serviceplatformen returnerer teknisk kvittering for modtagelse af forespørgslen (synkront kald) 3. Fagsystemet opretter abonnement for personkredsen på Beskedfordeleren (oprettes manuelt) 4. Beskedfordeleren leverer adviseringer og kvittering fra KMD Indkomst KMD udstiller en driftsplan, som angiver tidspunkt for rettidig indberetning af personkredsen samt tidpunkt for afsendelse af leverancen. Driftsplanen kan ses på KMDs kundenet under KMD Indkomst. Det er fagsystemernes eget ansvar at indsende liste med personabonnementer rettidigt ift. driftsplanen. 3.1.2 Oversigt over endpoints ID Navn EP_FS1 EP_FS2 EP_FS3 IndsendPersonkredsAarsopgoerelse IndsendPersonkredsForskudsopgoerelse BeskedfordelerKvitteringAdvis 3.1.3 Beskrivelse af endpoint EP_FS1 - IndsendPersonkredsAarsopgoerelse 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatformen udstiller service IndsendPersonkredsAarsopgoerelse Operationer: - IndsendPersonkredsAarsopgoerelse Opretter personabonnement KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 44
3.1.3.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.3.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS. 3.1.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL [Udfyldes af Systematic senere] Der udfyldes med WSDL svarende til den MQ-besked, KMD Indkomst skal modtage for [Afklaring KMD: Indsæt servicenavn, når dette kendes] på denne URL: [Afklaring KMD: Skaf teknisk specifikation] Endpoint navn Endpoint IP [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] Miljø: Test URI til WSDL [Udfyldes af Systematic senere] Der udfyldes med WSDL svarende til den MQ-besked, KMD Indkomst skal modtage for [Afklaring KMD: Indsæt servicenavn, når dette kendes] på denne URL: [Afklaring KMD: Skaf teknisk specifikation] Endpoint navn Endpoint IP [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] 3.1.3.1.5 Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at oprette abonnement. 3.1.3.1.6 Dataretning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at oprette abonnement. 3.1.3.1.7 Service invokation / Triggers Kommunikation initieres af, at fagsystemet udsteder et kald til Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 44
3.1.3.2 Dataspecifikation Da der er tale om en transformationsintegration svarer dataspecifikationen for servicen til dataspecifikationen for MQ-beskeden udstillet af KMD Indkomst: Miljø: Produktion Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] Miljø: Test Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes]http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningperson Hent_IType.xsd Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [Afklaring KMD: Indsæt URL til dokumentation, når denne kendes. Henvis evt. til dokumentation for P13-5, der kan vedlægges som bilag] Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit Fejl! Henvisningskilde ikke fundet.. OBS! Hvert kald overskriver tidligere indsendte, ubehandlede kald, så hvert kald bør indeholde den fulde personkreds, der skal tegnes abonnement for i den kommende abonnementsperiode. Der sendes et request for hver kombination af kommune, sagsområde og funktion. 3.1.3.3 Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 44
3.1.3.4 Leverancesikkerhed og fejlhåndtering Da der er tale om en service, hvor der kan kaldes gentagne gange for samme personkreds, vil fagsystemet selv være ansvarlig for at håndterer fejlmeddelelser eller timeout i kaldet. Serviceplatformen sender fejlmeddelelse for fejl i XML-valideringen ved modtagelsen på Serviceplatformen eller ved timeout ved kaldet til MQ-køen på KMD Indkomst. Fagsystemet skal dermed også beslutte, om forespørgsel skal genfremsendes. 3.1.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. 3.1.4 Beskrivelse af endpoint EP-FS2 - IndsendPersonkredsForskudsopgoerelse 3.1.4.1 Transportspecifikation 3.1.4.1.1 Serviceudstiller Serviceplatformen udstiller service IndsendPersonkredsForskudsopgoerelse Operationer: - IndsendPersonkredsForskudsopgoerelse Opretter personabonnement 3.1.4.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.4.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 44
3.1.4.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL [Udfyldes af Systematic senere] Der udfyldes med WSDL svarende til den MQ-besked, KMD Indkomst skal modtage for [Afklaring KMD: Indsæt servicenavn, når dette kendes] på denne URL: [Afklaring KMD: Skaf teknisk specifikation] Endpoint navn Endpoint IP [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] Miljø: Test URI til WSDL [Udfyldes af Systematic senere] Der udfyldes med WSDL svarende til den MQ-besked, KMD Indkomst skal modtage for [Afklaring KMD: Indsæt servicenavn, når dette kendes] på denne URL: [Afklaring KMD: Skaf teknisk specifikation] Endpoint navn Endpoint IP [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] 3.1.4.1.5 Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at oprette abonnement. 3.1.4.1.6 Dataretning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at oprette abonnement. 3.1.4.1.7 Service invokation / Triggers Kommunikation initieres af, at fagsystemet udsteder et kald til Serviceplatformen. 3.1.4.2 Dataspecifikation Da der er tale om en transformationsintegration svarer dataspecifikationen for servicen til dataspecifikationen for MQ-beskeden udstillet af KMD Indkomst: Miljø: Produktion Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 44
Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] Miljø: Test Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes]http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningperson Hent_IType.xsd Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [Afklaring KMD: Indsæt specifikation til MQ-besked, når denne kendes] Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [Afklaring KMD: Indsæt URL til dokumentation, når denne kendes. Henvis evt. til dokumentation for P13-5, der kan vedlægges som bilag] Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit Fejl! Henvisningskilde ikke fundet.. OBS! Hvert kald overskriver tidligere indsendte, ubehandlede kald, så hvert kald bør indeholde den fulde personkreds, der skal tegnes abonnement for i den kommende abonnementsperiode. Der sendes et request for hver kombination af kommune, sagsområde og funktion. 3.1.4.3 Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.1.4.4 Leverancesikkerhed og fejlhåndtering Da der er tale om en service, hvor der kan kaldes gentagne gange for samme personkreds, vil fagsystemet selv være ansvarlig for at håndterer fejlmeddelelser eller timeout i kaldet. Serviceplatformen sender fejlmeddelelse for fejl i XML-valideringen ved modtagelsen på Serviceplatformen eller ved timeout ved kaldet til MQ-køen på KMD Indkomst. Fagsystemet skal dermed også beslutte, om forespørgsel skal genfremsendes. 3.1.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 44
3.1.4.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. 3.1.5 Beskrivelse af endpoint EP_FS3 - BeskedfordelerKvitteringAdvis Denne integration er standardintegrationsmønster for afsendelse af hændelsesbesked fra Beskedfordeler. 3.1.5.1 Transportspecifikation 3.1.5.1.1 Serviceudstiller [Afklaring SAPA: Skal der bruges pull eller push] [Afklaring KY: Skal der bruges pull eller push] 3.1.5.1.2 Serviceanvender [Afklaring SAPA: Skal der bruges pull eller push] [Afklaring KY: Skal der bruges pull eller push] 3.1.5.1.3 Teknologisk understøttelse Fagsystemet skal udstille REST-service, der vil blive specificeret af Beskedfordelerens leverandør. 3.1.5.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL [Afklaring/STS: specifikation kommer efter 18/2-15] Endpoint navn [Afklaring SAPA] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 44
[Afklaring KY] [Afklaring STS] Endpoint IP [Afklaring SAPA] [Afklaring KY] [Afklaring STS] Miljø: Test URI til WSDL [Afklaring/STS: specifikation kommer efter 18/2-15] Endpoint navn [Afklaring SAPA] [Afklaring KY] [Afklaring STS] Endpoint IP [Afklaring SAPA] [Afklaring KY] [Afklaring STS] 3.1.5.1.5 Teknisk retning for udveksling [Afklaring SAPA: Skal der bruges pull eller push] [Afklaring KY: Skal der bruges pull eller push] 3.1.5.1.6 Dataretning for udveksling Beskedfordeler leverer data til fagsystemerne. 3.1.5.1.7 Service invokation / Triggers [Afklaring SAPA: Skal der bruges pull eller push] [Afklaring KY: Skal der bruges pull eller push] 3.1.5.2 Dataspecifikation Dette afsnit beskriver specifikationen for de hændelsesbeskeder der distribueres via beskedfordeleren. Miljø: Produktion Inputdata Outputdata KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 44
Miljø: Test Inputdata http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningpersonhen t_itype.xsd Outputdata 3.1.5.3 Sikkerhed Sikkerhed mellem fagsystemerne og beskedfordeler er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.1.5.4 Leverancesikkerhed og fejlhåndtering [Afklaring/KDF: Hvad gælder for beskedfordeler?] 3.1.5.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.5.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KSD tidsrum] [Afklaring/KSD svartid] [Afklaring/KSD tilgængelighed] [Afklaring/KSD spidsbelastning] [Afklaring/KSD Servicevinduer] 3.1.6 Service Management 3.1.6.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.1.6.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.1.6.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 44
3.1.7 Testplan 3.1.7.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KY: Integrationstest] [Afklaring SAPA: Integrationstest] 3.1.7.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KY: Produktionssætningstest] [Afklaring SAPA: Produktionssætningstest] 3.2 Specifikation af endpoints for KMD Indkomst Integration benyttes af Serviceplatformen til indberetning af personkreds til advisering om ændringer i en persons års- eller forskudsopgørelse fra SKAT via KMD Indkomst. KMD Indkomst udstiller en MQ-service opdelt i to indgående MQ-køer hhv. datakø og statuskø der begge tilgås fra Serviceplatformen via en MQ-klient. Årsagen til opdeling i datakø og statuskø er, at der kan understøttes flere transaktioner i samme forsendelse. Data afsendes på datakøen i en eller flere transaktioner. Efter sidste data er sendt, sendes en commit-besked på statuskøen. KMD Indkomst behandler ikke data sendt til datakøen før denne commit-besked er modtaget. Samme procedure gælder ved modtagelse af advisdata og kvitteringer fra KMD Indkomst via et tilsvarende sæt udgående køer fra KMD Indkomst. Her må Serviceplatformen ikke behandle data før commit-besked er modtaget på statuskøen. 3.2.1 Overordnet forretningslogik [Udfyld med tekst der gennemgår endpoint for endpoint hvilke sammenhænge der findes, hvilken rækkefølge endpoints kaldes og med hvilke formål.] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 44
[Fx Endpoint EP_FS1 kalder ] 3.2.2 Oversigt over endpoints ID Navn EP_KMD1 EP_KMD2 EP_KMD3 EP_KMD4 IndsendPersonkredsData IndsendPersonkredsStatus UdstilKvitteringAdvisData UdstilKvitteringAdvisStatus 3.2.3 Beskrivelse af endpoint EP_KMD1 - IndsendPersonkredsData 3.2.3.1 Transportspecifikation 3.2.3.1.1 Serviceudstiller KMD Indkomst udstiller en MQ service med en kø til at modtage data (datakø). Indberetninger afsendes fra Serviceplatformen via datakøen i en eller flere transaktioner. Når alle data er afsendt i en leverance, sendes en afslutningsbesked på statuskøen (EP_KMD2). 3.2.3.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.2.3.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen. 3.2.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 44
Endpoint IP 3.2.3.1.5 Teknisk retning for udveksling Serviceplatformens MQ-klient sender personkreds til KMD Indkomst via MQ-køen. 3.2.3.1.6 Dataretning for udveksling Serviceplatformen sender personkreds til KDM Indkomst. 3.2.3.1.7 Service invokation / Triggers Kommunikation initieres når Serviceplatformen modtager en opdateret personkreds fra et fagsystem. 3.2.3.2 Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata [Afventer KMD]http://85.81.229.78/services/demo/eIndkomst/view/IndkomstOplysningPerson Hent_IType.xsd Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [Afklaring KMD: Indsæt URL til dokumentation, når denne kendes. Henvis evt. til dokumentation for P13-5, der kan vedlægges som bilag] Valideringer fremgår af ovennævnte dokument. 3.2.3.3 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 44
3.2.3.4 Leverancesikkerhed og fejlhåndtering Indberetninger overføres Exactly once. Dette styres via MQ-transaktion. Såfremt samme indberetning fremsendes to gange på samme HovedindberetningsID, vil de gentagne data blive afvist af KMD med en fejl. Såfremt der opstår en fejl i en af transmissionerne på datakøen, kan der sendes en Annuller besked på statuskøen, og hele transmissionen kan herefter genfremsendes igen. KMD håndterer fejl på MQ service og tilhørende køer. Serviceplatformen håndterer genfremsendelse af indberetninger og tilhørende statusbeskeder til KMD i tilfælde af fejl på MQ-kald [Afklaring/KDF: Er ovenstående korrekt. Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] 3.2.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] 3.2.4 Beskrivelse af endpoint EP_KMD2 - IndsendPersonkredsStatus 3.2.4.1 Transportspecifikation 3.2.4.1.1 Serviceudstiller KMD Indkomst udstiller en MQ service med en kø til at modtage afslutningsbeskeder (statuskø). Indberetninger afsendes fra Serviceplatformen via datakøen (EP_KMD1) i en eller flere transaktioner. Når alle data er afsendt i en leverance, sendes en afslutningsbesked på statuskøen. 3.2.4.1.2 Serviceanvender Serviceplatformen er serviceanvender. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 44
3.2.4.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen. 3.2.4.1.4 Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP 3.2.4.1.5 Teknisk retning for udveksling Serviceplatformen foretager kald til KMD Indkomst MQ-server via MQ-klient. 3.2.4.1.6 Dataretning for udveksling Serviceplatformens MQ-klient afsender afslutningsbeskeder til KMD Indkomst via MQ-køen. 3.2.4.1.7 Service invokation / Triggers Kommunikation initieres af, at Serviceplatformen har afsluttet eller ønsker at annullere afsendelse af data til KMD Indkomst. 3.2.4.2 Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata Outputdata KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 44
Miljø: Test Inputdata Outputdata http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningpersonhen t_itype.xsd Formatet fremsendes som fast format poster. Der skal anvendes Codepage ISO 8859-1, og linje skilletegn skal være LF (Linefeed). 3.2.4.3 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.2.4.4 Leverancesikkerhed og fejlhåndtering Kvitteringer overføres Exactly once. Dette styres via MQ-transaktion. Såfremt samme indberetning fremsendes to gange på samme HovedindberetningsID, vil de gentagne data blive afvist af KMD med en fejl. Såfremt der opstår en fejl i en af transmissionerne på datakøen, kan der sendes en Annuller besked på statuskøen, og hele transmissionen kan herefter genfremsendes igen. KMD håndterer fejl på MQ service og tilhørende køer. Serviceplatformen håndterer genfremsendelse af indberetninger og tilhørende statusbeskeder til KMD i tilfælde af fejl på MQ-kald. [Afklaring/KDF: Er ovenstående korrekt. Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] 3.2.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.4.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Værdi [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 44
Servicevinduer [Afklaring/KMD Indkomst: Aftales senere] 3.2.5 Beskrivelse af endpoint EP_KMD3 - UdstilKvitteringAdvisData 3.2.5.1 Transportspecifikation 3.2.5.1.1 Serviceudstiller KMD Indkomst udstiller en MQ service med en kø til at afsende data (datakø). Data polles af Serviceplatformen via læsning på køen. Forretningskvitteringer og advisdata afsendes af KMD via datakøen i en eller flere transaktioner. Når alle data er afsendt i en leverance, sendes en afslutningsbesked på statuskøen. 3.2.5.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.2.5.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen. 3.2.5.1.4 Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP 3.2.5.1.5 Teknisk retning for udveksling Serviceplatformen foretager kald til KMD Indkomst MQ-server via MQ-klient, som returnerer næste besked på køen når denne er klar. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 44
3.2.5.1.6 Dataretning for udveksling Serviceplatformens MQ-klient modtager data til forretningskvitteringer og advisdata fra KMD Indkomst via MQ-køen. 3.2.5.1.7 Service invokation / Triggers Kommunikation initieres af, at KMD Indkomst har modtaget opdaterede data om ændret års- eller forskudsopgørelse for en person indeholdt i den tidligere indberettede personkreds og har uploadet data og statusmeddelelse på statuskøen (EP_KMD4). 3.2.5.2 Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [Afklaring KMD: Indsæt URL til dokumentation, når denne kendes. Henvis evt. til dokumentation for P13-5, der kan vedlægges som bilag] Valideringer fremgår af ovennævnte dokument. 3.2.5.3 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.2.5.4 Leverancesikkerhed og fejlhåndtering Kvitteringer og advisdata modtages retur Excactly once. Såfremt der opstår en fejl i en af transmissionerne på datakøen, kan KMD sende en Annuller besked på statuskøen (EP_KMD4). Dette skal bevirke at Serviceplatformen ignorerer al information modtaget på samme ID via datakøen. Herefter genfremsender KMD hele transmissionen igen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 af 44
KMD håndterer fejl på MQ service og tilhørende køer. Serviceplatformen (det kaldende fagsystem) håndterer fejl modtaget i indberetningskvitteringen (afviste indberetninger), herunder eventuel genfremsendelse i en ny indberetning. [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] 3.2.5.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.5.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] 3.2.6 Beskrivelse af endpoint EP_KMD4 - UdstilKvitteringAdvisStatus 3.2.6.1 Transportspecifikation 3.2.6.1.1 Serviceudstiller KMD Indkomst udstiller en MQ service med en kø til at modtage afslutningsbeskeder fra KMD (statuskø). Data polles af Serviceplatformen via læsning på køen. Forretningskvitteringer og advisdata afsendes af KMD via datakøen i en eller flere transaktioner. Når alle data er afsendt i en leverance, sender KMD en afslutningsbesked på statuskøen. 3.2.6.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.2.6.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen. 3.2.6.1.4 Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 af 44
Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP 3.2.6.1.5 Teknisk retning for udveksling Serviceplatformen foretager MQget-kald til KMD Indkomst MQ-server via MQ-klient, som returnerer næste besked på køen når denne er klar. 3.2.6.1.6 Dataretning for udveksling Serviceplatformens MQ-klient modtager afslutningsbeskeder til forretningskvitteringer og advisdata fra KMD Indkomst via MQ-køen. 3.2.6.1.7 Service invokation / Triggers Kommunikation initieres af, at KMD Indkomst har afsluttet eller ønsker at annullere afsendelse af data til Serviceplatformen via EP_KMD4. 3.2.6.2 Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 af 44
3.2.6.3 Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed]. 3.2.6.4 Leverancesikkerhed og fejlhåndtering Afslutningsbeskeder overføres Exactly once. Dette styres via MQ-transaktion. Såfremt Serviceplatformen ved en fejl modtager samme information to gange, logges dette som en fejl, men ignoreres i øvrigt. Såfremt der opstår en fejl i en af transmissionerne på datakøen, kan KMD sende en Annuller besked på statuskøen. Dette skal bevirke at Serviceplatformen ignorerer al information modtaget på samme ID via datakøen (EP_KMD3). Herefter genfremsender KMD hele transmissionen igen. KMD håndterer fejl på MQ service og tilhørende køer. [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] 3.2.6.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.2.6.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] [Afklaring/KMD Indkomst: Aftales senere] 3.2.7 Service Management 3.2.7.1 Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.2.7.2 Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 af 44
3.2.7.3 Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer] 3.2.8 Testplan 3.2.8.1 Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KMD: Integrationstest] 3.2.8.2 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KMD: Produktionssætningstest] 3.3 Specifikation af endpoints for Beskedfordelser Integrationen benyttes til at [Udfyld med kortfattet formål fx at indberette indkomstpligtige ydelser udbetalt af kommunen ]. [Udfyld med detaljeret beskrivelse af integration fx Serviceplatformen udstiller service til indberetning af ] 3.3.1 Overordnet forretningslogik [Udfyld med tekst der gennemgår endpoint for endpoint hvilke sammenhænge der findes, hvilken rækkefølge endpoints kaldes og med hvilke formål.] [Fx Endpoint EP_FS1 kalder ] 3.3.2 Oversigt over endpoints ID Navn KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 33 af 44
EP_KMD1 EP_KMD2 EP_KMD3 EP_KMD4 IndsendPersonkredsData IndsendPersonkredsStatus UdstilKvitteringAdvisData UdstilKvitteringAdvisStatus 3.3.3 Beskrivelse af endpoint [(Udfyld endpoint ID)] - [Udfyld endpoint navn] 3.3.3.1 Transportspecifikation 3.3.3.1.1 Serviceudstiller [Udfyldes fx Serviceplatform er serviceudstiller. ] 3.3.3.1.2 Serviceanvender [Udfyldes fx XXX er serviceanvender. ] 3.3.3.1.3 Teknologisk understøttelse [Udfyldes fx Snitfladen er implementeret som en SOAP webservice, version 1.2 ] 3.3.3.1.4 Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP 3.3.3.1.5 Teknisk retning for udveksling [Udfyldes fx XXX foretager upload af data til SFTP-server på Serviceplatformen. ] 3.3.3.1.6 Dataretning for udveksling [Udfyldes fx Serviceplatformens MQ-klient sender indberetningsdata til XXX på MQ-køen ] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 34 af 44
3.3.3.1.7 Service invokation / Triggers [Udfyldes fx Kommunikation initieres af, at XXX har nye data, der skal indberettes til myndighed YYY ] 3.3.3.2 Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningpersonhen t_itype.xsd Outputdata 3.3.3.3 Sikkerhed [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, (https://www.serviceplatformen.dk/administration/help/provider-tech-guide) hvor der også ligger vejledning til udviklere, samt demoprojekter.] 3.3.3.4 Leverancesikkerhed og fejlhåndtering [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 35 af 44