Integration SF1180 Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Integrationsbeskrivelse version 2.1.0

Transkript

1 Integration SF1180 Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Integrationsbeskrivelse version Kommunernes Datafællesskab - KDF

2 Versionshistorik Dato Initialer Version Kommentarer MHO 0.1 Første version EDM Opdateret MQ og BF beskrivelse EDM Opdateret med kommentarer Ehe Klargjort til SP MHO Referencerettelser mm EHE Teknisk beskrivelse godkendt Referencer Ref Titel Kommentarer [SPref] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: [BFref] [Afklaring/KDF indsæt reference dokumentation af servicemål for BF] Endnu ikke udarbejdet Integrationsbeskrivelse Relevans [SIKKER- HED] [STS-Sikkerhed] [VBF] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link [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 [KI_MQ] KMD Indkomst - MQService IndkomstMasseForespoergsel - v1.0.pdf MQ snitfladebeskrivelse til KMD Indkomst, P13-5, Version 1.0, Ny version af dokumentet med ændringer til indhold KOMBIT A/S Halfdansgade København S CVR Side 2 af 58

3 i snitflade kommer i løbet af efteråret. [KMD-Felt] KMD Indkomst Indkomstgrænseflade P13-5 Felt-oversigt [Hjemmel] SKAT - Hjemmelsgrundlag for brug af eindkomst.pdf Hjemmelsgrundlag [WSDL-SP] Integrationsbeskrivelsen refererer til SF1180 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link Ikke udarbejdet endnu. KOMBIT A/S Halfdansgade København S CVR Side 3 af 58

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning Kontekst for integrationsparter Kontekst for SAPA vedr. årsopgørelse [!@SAPA@!] Kontekst for SAPA vedr. forskudsopgørelse [!@SAPA@!] Kontekst for KY vedr. årsopgørelse [!@KY@!] Specifikation for integrationsparter Specifikation af endpoints for SAPA og KY [!@SAPA@!][!@KY@!] Specifikation af endpoints for KMD Indkomst [!@KMD@!] Specifikation af endpoint for SP som afsendende beskedagent [!@Systematic@!] Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 4 af 58

5 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 Integrationen indeholder tre forretningsflow: Vedligeholde personabonnementer Kvittere personabonnementer Afsende ændringer Vedligeholde personabonnementer Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet leverer løbende, når der er ændringer, (jf. driftsaftale med KMD) et request med en samlet liste over de CPR-numre, der skal indgå i personabonnementer for de kommende forsendelser med adviseringer om ændringer i års- og forskudsopgørelser fra KMD Indkomst (der sendes et request for hver kombination af fagsystem, kommune, sagsområde og funktion). Requestet sendes via et synkront kald til en af to services udstillet af Serviceplatformen til modtagelse af personabonnementer for ændringer i henholdsvis årsopgørelser eller forskudsopgørelser. Serviceplatformen transformerer requestet og sender det via MQ-kø (push) til KMD Indkomst. KOMBIT A/S Halfdansgade København S CVR Side 5 af 58

6 KMD Indkomst Serviceplatformen Fagsystem (n) Integrationsbeskrivelse Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Vedligeholde personabonnement Opdater årsopgørelse Afsend personabonnement årsopgørelse Opdater forskudsopgørelse Afsend personabonnement forskudsopgørelse Modtag personabonnement årsopgørelse Modtag personabonnement forskudsopgørelse Transformation til MQ Transformation til MQ MQ Push MQ Push Modtag personabonnement KOMBIT A/S Halfdansgade København S CVR Side 6 af 58

7 1.2.2 Kvittere personabonnementer Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. 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. KMD Indkomst sender en forretningskvittering til Serviceplatformen via MQ. Serviceplatformen transformerer kvitteringen og sender den til fagsystemet gennem Beskedfordeler, hvor fagsystemet abonnerer på disse kvitteringer. Hvis der ikke er fejl, fås kun en enkelt kvittering, mens der ved fejl fås en fejl per person, hvorfor disse opdeles i enkelte beskeder. Ved eventuelle fejl skal dette rettes i fagsystemet og personabonnementet skal gensendes til KMD Indkomst. KOMBIT A/S Halfdansgade København S CVR Side 7 af 58

8 KMD Indkomst Serviceplatformen Beskedfordeler Fagsystem (n) Integrationsbeskrivelse Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Kvittere personabonnement Kvittering Modtag kvittering Fordel kvittering Send kvittering som besked Opdel kvittering per person til besked Hent kvittering Modtaget personabonnement Vedligehold personabonnement Dan kvitteringer Afsend kvitteringer Personabonnement KOMBIT A/S Halfdansgade København S CVR Side 8 af 58

9 1.2.3 Afsende ændringer Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Adviseringen om ændringer i forskuds- og årsopgørelsesdata (og evt. fejlmeddelelser) for det angivne personabonnement gøres løbende tilgængelig via MQ-køen af KMD Indkomst til Serviceplatformen, når ændringerne modtages fra SKAT. KMD kører disse kørsler periodisk, hvilket kan ses på KMD s kundenet, hvor dette er registreret. Serviceplatformen transformerer de enkelte ændringer per person til beskeder på Beskedfordeler Fagsystemet modtager beskeden med ændringer gennem Beskedfordeler. Fagsystemet har opsat et abonnement, som sikrer at disse ændringer modtages korrekt. KOMBIT A/S Halfdansgade København S CVR Side 9 af 58

10 KMD Indkomst Serviceplatformen Beskedfordeler Fagsystem (n) Abonnement på hændelser vedr. årsopgørelse og forskudsopgørelse Afsende ændringer Modtag ændringer Modtag beskeder Fordel beskeder Opdel ændring per person som besked Hent ændringer Afsende ændringer Dan ændringer Udstil returdata Integrationsbeskrivelse Personabonnement KOMBIT A/S Halfdansgade København S CVR Side 10 af 58

11 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Vedligehold personabonnementer Kvitter personabonnement Afsend ændringer Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] Svartid 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 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 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 Svartid for Beskedfordeler er beskrevet i [BFref]. Svartid for Beskedfordeler er beskrevet i [BFref]. Svartid for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Svartid for eksternt system kendes ikke] [Afklaring/KDF: Svartid for eksternt system kendes ikke] [Afklaring/KDF: Svartid for eksternt system kendes ikke] Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. 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 11 af 58

12 Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] Servicevinduer Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: 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: 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 Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer 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. 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. 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. KOMBIT A/S Halfdansgade København S CVR Side 12 af 58

13 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 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 [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationen?] Problem Management [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationen?] Change Management [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationen?] Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] 1.4 Teststrategi 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 København S CVR Side 13 af 58

14 [Afklaring/Programmet: Teststrategi håndteres i programemnelog #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?] Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD Indkomst: Findes der et testmiljø med brugbare testdata?] Test i forbindelse med produktionssætning I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KMD Indkomst: Aftale vedr. produktionssætning udestår] 1.5 Forudsætninger for produktionssætning Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter. Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. KOMBIT A/S Halfdansgade København S CVR Side 14 af 58

15 [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] Forudsætninger for 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 1.5.2). 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. [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] De nødvendige beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så systemet kan sende de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [VBF]. Leverandøren skal være oprettet som tilslutningspart på SF1460_C Generelle forsætninger for tilslutning af ny integrationspart: Fagsystem Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. De nødvendige abonnementer og opsætninger skal være oprettet i Beskedfordeler, så systemet kan modtage de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [STS-Sikkerhed]. Leverandøren skal være oprettet som tilslutningspart på SF1460_A/SF1460_D Generelle forsætninger for tilslutning af ny 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. KOMBIT A/S Halfdansgade København S CVR Side 15 af 58

16 Autoriserer KMD i SKATs revisorordning til at kommunikere med SKAT på kommunens vegne. KMD skal etablere dedikerede MQ-køer til denne forbindelse. KMD udstiller en driftsplan, som angiver tidspunkt for rettidig indberetning af personkredsen samt tidpunkt for afsendelse af leverancen. Driftsplanen kan ses på KMD s kundenet under KMD Indkomst. Det er fagsystemernes eget ansvar at indsende liste med personabonnementer rettidigt ift. driftsplanen. KOMBIT A/S Halfdansgade København S CVR Side 16 af 58

17 2 Kontekst for integrationsparter 2.1 Kontekst for SAPA vedr. årsopgørelse Lovhjemmel og forvaltningsmæssigt formål Lovhjemmel til brug af integrationen og det forvaltningsmæssige formål er dokumenteret i [Hjemmel]. 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 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] [KDF/Afklaring SAPA beder KDF skaffe data fra KMD Indkomst i dag] Hændelser må, når de modtages af beskedfordeleren, ikke være mere end 1 døgn gamle Specifikke forhold for tilslutning af system Ingen identificeret. 2.2 Kontekst for SAPA vedr. forskudsopgørelse [!@SAPA@!] 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 ( I henhold til Dagtilbudsloven er KOMBIT A/S Halfdansgade København S CVR Side 17 af 58

18 Kommunalbestyrelsen forpligtet til at give et økonomisk fripladstilskud under hensyn til forældrenes økonomiske forhold, jf. eksempelvis 43, punkt 2. Data til understøttelse af den lov og pligtmæssige kommunale forretning, er blandt andet underlagt Persondatalovens 6, punkt 5 og 6 ( 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 også kan medføre en ændring i boligstøtten. Det samme gør sig gældende for efterregulere økonomisk fripladstilskud 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] [KDF/Afklaring SAPA beder KDF skaffe data fra KMD Indkomst i dag] Hændelser må, når de modtages af beskedfordeleren, ikke være mere end 1 døgn gamle Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 18 af 58

19 2.3 Kontekst for KY vedr. årsopgørelse Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en 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 Kapacitets- og servicekrav Forventet volumen for snitfladen er estimeret til: Indberettede abonnementer på personkreds ca filer per måned Modtagne hændelsesbeskeder ca per år Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 19 af 58

20 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for SAPA og KY Integration benyttes af ydelsessystemet 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 Overordnet forretningslogik Fagsystemet kalder Serviceplatformen, som udstiller to synkrone services, der understøtter vedligeholdelse af personabonnement for en personkreds (der sendes et request for hver kombination af fagsystem, kommune, sagsområde og funktion) hos KMD Indkomst for henholdsvis årsopgørelser og forskudsopgørelse. Kvittering for personabonnement samt ændringer i års- eller forskudsopgørelser leveres til fagsystemet via Beskedfordeler, hvor fagsystemet manuelt har oprettet disse abonnementer på Beskedfordeler gennem administrationsgrænsefladen. 1. Fagsystemet kalder Serviceplatformen på EP_FS1 for at vedligeholde abonnementer på årsopgørelse eller EP_FS2 for at vedligeholde personabonnementer på forskudsopgørelse. 2. Serviceplatformen returnerer teknisk kvittering for modtagelse af forespørgslen (synkront kald) 3. Fagsystemet vedligeholder eventuelle værdilister for beskedtyperne på Beskedfordeleren gennem EP_BF2. 4. Beskedfordeler leverer ændringer til opgørelser og kvittering fra KMD Indkomst på EP_BF1. KMD udstiller en driftsplan, som angiver tidspunkt for rettidig indberetning af personkredsen samt tidpunkt for afsendelse af leverancen. Driftsplanen kan ses på KMD s kundenet under KMD Indkomst. Det er fagsystemernes eget ansvar at indsende liste med personabonnementer rettidigt ift. driftsplanen Oversigt over endpoints ID Navn EP_FS1 EP_FS2 EP_BF1 EP_BF2 VedligeholdPersonAbonnementAarsopgoerelse VedligeholdPersonAbonnementForskudsopgoerelse ModtagBesked AdministrerVaerdiliste KOMBIT A/S Halfdansgade København S CVR Side 20 af 58

21 3.1.3 Beskrivelse af endpoint EP_FS1 - VedligeholdPersonAbonnementAarsopgoerelse Transportspecifikation Serviceudstiller Serviceplatformen udstiller service VedligeholdPersonAbonnementAarsopgoerelse Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: [Afklaring/Systematic - Systematic skal udarbejde et XSD for beskedens indhold som godkendes af KOMBIT. Specifikationen skal svare til dataspecifikationen for KMD Indkomst, der er beskrevet i [KI_MQ]. Data sendt til servicen skal SP transformere til MQ] Miljø: Produktion URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at vedligeholde personabonnement. KOMBIT A/S Halfdansgade København S CVR Side 21 af 58

22 Dataretning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at vedligeholde personabonnement Service invokation / Triggers Kommunikation initieres af, at fagsystemet udsteder et kald til Serviceplatformen Dataspecifikation Da der er tale om en transformationsintegration svarer dataspecifikationen for servicen til dataspecifikationen for MQ-beskeden udstillet af KMD Indkomst: [Afklaring/Systematic - Systematic skal udarbejde et XSD for beskedens indhold som godkendes af KOMBIT. Specifikationen skal svare til dataspecifikationen for KMD Indkomst, der er beskrevet i [KI_MQ]. Data sendt til servicen skal SP transformere til MQ] Miljø: Produktion Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Miljø: Test Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [KI_MQ] Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit Fagsystemet skal indsætte Anvenders_Journalnummer med et entydigt id, som returneres med kvittering fra KMD Indkomst. Det anbefales af de enkelte fagsystemer sætter prefiks med eget fagsystem i journalnummeret (f.eks. SAP, KY, KSD ), så dette kan benyttes i opsætningen af abonnementet på Beskedfordeler jf. afsnit Fagsystemet skal sikre, at FUNKTION = 92 ved kald til dette endpoint. KOMBIT A/S Halfdansgade København S CVR Side 22 af 58

23 OBS! Hvert kald overskriver tidligere indsendte, ubehandlede kald, så hvert kald bør indeholde den fulde personkreds, der skal tegnes abonnement for. Der sendes et request for hver kombination af fagsystem, myndighed, sagsområde og funktion. Ved annullering af bestående personkreds fremsendes en forespørgsel bestående af kun Header og ingen Advis person Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed] 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. Serviceplatformen sender en fejl gennem Beskedfordeler, hvis besked ikke kan leveres til MQ/KMD Indkomst ved f.eks. time-out. Fagsystemet skal dermed også beslutte, om forespørgsel skal genfremsendes Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi 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] 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. KOMBIT A/S Halfdansgade København S CVR Side 23 af 58

24 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] Beskrivelse af endpoint EP-FS2 - VedligeholdPersonAbonnementForskudsopgoerelse Transportspecifikation Serviceudstiller Serviceplatformen udstiller service VedligeholdPersonAbonnementForskudsopgoerelse Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: [Afklaring/Systematic - Systematic skal udarbejde et XSD for beskedens indhold som godkendes af KOMBIT. Specifikationen skal svare til dataspecifikationen for KMD Indkomst, der er beskrevet i [KI_MQ]. Data sendt til servicen skal SP transformere til MQ] Miljø: Produktion URI til WSDL Endpoint navn [WSDL-SP] [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL Endpoint navn [WSDL-SP] KOMBIT A/S Halfdansgade København S CVR Side 24 af 58

25 [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at vedligeholde personabonnement Dataretning for udveksling Fagsystemet kalder Serviceplatformen med de nødvendige oplysninger for at vedligeholde personabonnement Service invokation / Triggers Kommunikation initieres af, at fagsystemet udsteder et kald til Serviceplatformen Dataspecifikation Da der er tale om en transformationsintegration svarer dataspecifikationen for servicen til dataspecifikationen for MQ-beskeden udstillet af KMD Indkomst: [Afklaring/Systematic - Systematic skal udarbejde et XSD for beskedens indhold som godkendes af KOMBIT. Specifikationen skal svare til dataspecifikationen for KMD Indkomst, der er beskrevet i [KI_MQ]. Data sendt til servicen skal SP transformere til MQ] Miljø: Produktion Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Miljø: Test Inputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Outputdata [Udfyldes af Systematic senere. Schemaer leveres af Systematic] [WSDL-SP]/XSD Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [KI_MQ] KOMBIT A/S Halfdansgade København S CVR Side 25 af 58

26 Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit Fagsystemet skal indsætte Anvenders_Journalnummer med et entydigt id, som returneres med kvittering fra KMD Indkomst. Det anbefales af de enkelte fagsystemer sætter prefiks med eget fagsystem i journalnummeret (f.eks. SAP, KY, KSD ), så dette kan benyttes i opsætningen af abonnementet på Beskedfordeler jf. afsnit Fagsystemet skal sikre, at FUNKTION = [Afklaring/KDF kode skal indsættes, når løsningen er udviklet] ved kald til dette endpoint. OBS! Hvert kald overskriver tidligere indsendte, ubehandlede kald, så hvert kald bør indeholde den fulde personkreds, der skal tegnes abonnement for. Der sendes et request for hver kombination af fagsystem, myndighed, sagsområde og funktion. Ved annullering af bestående personkreds fremsendes en forespørgsel bestående af kun Header og ingen Advis person Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed] 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. Serviceplatformen sender en fejl gennem Beskedfordeler, hvis besked ikke kan leveres til MQ/KMD Indkomst ved f.eks. time-out. Fagsystemet skal dermed også beslutte, om forespørgsel skal genfremsendes Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [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] KOMBIT A/S Halfdansgade København S CVR Side 26 af 58

27 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] Beskrivelse af endpoint EP_BF1 - ModtagBesked Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Beskedfordeler udstiller beskeder fra KMD Indkomst. Endpoint benyttes af fagsystemerne i forbindelse ændringer i oplysninger om forskuds- eller årsopgørelser Abonnementsvilkår Fagsystemerne skal oprette et abonnement på hver af beskedtyperne per myndighed: 1. KMD Indkomst kvittering Forespørgslen er modtaget korrekt eller afvist i KMD Indkomst 2. KMD Indkomst fejl Person i abonnement er fejlet 3. Forskudsopgørelse (kun relevant hvis fagsystemet benytter denne) 4. Årsopgørelse (kun relevant hvis fagsystemet benytter denne) KMD Indkomst kvittering Abonnementet skal sættes op på Beskedtype KMD Indkomst kvittering med et filter på Objektregistrering/ObjektId. Hvis fagsystemet har benyttet prefiks i journalnummeret, så kan der i filteret angives Anvenders_Journalnummer = [indsat prefiks]*. Der er så ikke behov for en værdiliste. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk såfremt der er benyttet prefiks i journalnummeret: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektRegistreringId = [Afklaring/KDF angivelse af prefiks skal indsættes] KOMBIT A/S Halfdansgade København S CVR Side 27 af 58

28 KMD Indkomst fejl Abonnementet skal sættes op på Beskedtype KMD Indkomst fejl med et filter på Objektregistrering/ObjektId. Hvis fagsystemet har benyttet prefiks i journalnummeret, så kan der i filteret angives Anvenders_Journalnummer = [indsat prefiks]*. Der er så ikke behov for en værdiliste. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk såfremt der er benyttet prefiks i journalnummeret: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektRegistreringId = [Afklaring/KDF angivelse af prefiks skal indsættes] Forskudsopgørelse Abonnementet skal sættes op på Beskedtype Forskudsopgørelse med et filter på Objektregistrering/ObjektId. Hvis fagsystemet har benyttet prefiks i journalnummeret, så kan der i filteret angives Anvenders_Journalnummer = [indsat prefiks]*. Der er så ikke behov for en værdiliste, men der kan tilknyttes en person-værdiliste på det RelateretObjekt/ObjektId[0]. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk såfremt der er benyttet prefiks i journalnummeret: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektRegistreringId = [Afklaring/KDF angivelse af prefiks skal indsættes] Årsopgørelse Abonnementet skal sættes op på Beskedtype Årsopgørelse med et filter på Objektregistrering/ObjektId. Hvis fagsystemet har benyttet prefiks i journalnummeret, så kan der i filteret angives Anvenders_Journalnummer = [indsat prefiks]*. Der er så ikke behov for en værdiliste, men der kan tilknyttes en person-værdiliste på det RelateretObjekt/ObjektId[0]. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk såfremt der er benyttet prefiks i journalnummeret: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektRegistreringId = [Afklaring/KDF angivelse af prefiks skal indsættes] Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1460_A] / [SF1460_D] KOMBIT A/S Halfdansgade København S CVR Side 28 af 58

29 Outputdata Se [SF1460_A] / [SF1460_D] Data i beskederne fremsendes i det format som de er modtaget i fra KMD Indkomst som er fast separeret format poster. Beskeddata vil være Base64 encoded. Se afsnit Fejl! Henvisningskilde ikke fundet. for en beskrivelse af indholdet i beskedkuvert og indhold Beskrivelse af endpoint EP_BF2 AdministrerVaerdiliste Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B]. Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnementer. Endpoint kaldes af fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonnement. Hvis abonnementet er sat op på prefiks, som angivet i afsnit , så er det ikke nødvendigt at benytte dette endpoint Værdiliste Som beskrevet i afsnit kan fagsystemerne benytte en værdilistefor de personer, som også abonneres på i KMD Indkomst via EP_FS1 og EP_FS2. Værdilisten skal oprettes med følgende navn: PersonabonnementSF1180 Hvis værdilisten benyttes, skal denne inkluderes i abonnementsudtrykket for de beskedtyper, der abonneres på. [Afklaring/KY&SAPA Det skal afklares, om KY og SAPA skal benytte en generel personliste på tværs af beskedtyper, eller om de vil benytte en specifik liste til denne integration] Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] Testplan 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: KOMBIT A/S Halfdansgade København S CVR Side 29 af 58

30 [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring KY: Integrationstest] [Afklaring SAPA: Integrationstest] 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 [!@KMD@!] Integration benyttes af Serviceplatformen til indberetning af personkreds til advisering om ændringer i en persons års- eller forskudsopgørelse fra SKAT via KMD Indkomst. [Afklaring/KDF: Det er endnu ikke afklaret, hvordan MQ-servicen opsættes, men det forventes, at KMD Indkomst udstiller en MQ-service opdelt i to MQ-køer hhv. ind-kø og ud-kø der begge tilgås fra Serviceplatformen via en MQ-klient. Serviceplatformen afsender personabonnement.request på ud-køen og modtager kvitteringer og advisdata (ændringer i forskuds- eller årsopgørelser) på ind-køen.] Overordnet forretningslogik Serviceplatformen sender personabonnementer til EP_KMD1. Serviceplatformen modtager efterfølgende forretningskvittering fra KMD Indkomst omkring abonnementer på EP_KMD2. Serviceplatformen modtager periodisk (efter driftsplaner i KMD) advisdata på EP_KMD Oversigt over endpoints ID Navn EP_KMD1 EP_KMD2 IndsendPersonabonnementData ModtagKvitteringAdvisData KOMBIT A/S Halfdansgade København S CVR Side 30 af 58

31 3.2.3 Beskrivelse af endpoint EP_KMD1 - IndsendPersonabonnementData Transportspecifikation Serviceudstiller KMD Indkomst udstiller en MQ service med en kø til at modtage data (datakø). Personabonnementer afsendes fra Serviceplatformen via datakøen i en eller flere transaktioner Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Afventer KMD] [Afventer KMD] [Afventer KMD] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [Afventer KMD] [Afventer KMD] [Afventer KMD] Teknisk retning for udveksling Serviceplatformens MQ-klient sender personabonnement til KMD Indkomst via MQ-køen Dataretning for udveksling Serviceplatformen sender personabonnement til KDM Indkomst Service invokation / Triggers Kommunikation initieres når Serviceplatformen modtager en opdateret personabonnement fra et fagsystem. KOMBIT A/S Halfdansgade København S CVR Side 31 af 58

32 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 [KI_MQ] afsnit 8.5 (og 8.2 for MQ pakning) [KI_MQ] afsnit 8.5 (og 8.2 for MQ pakning) Miljø: Test Inputdata Outputdata [KI_MQ] afsnit 8.5 (og 8.2 for MQ pakning) [KI_MQ] afsnit 8.5 (og 8.2 for MQ pakning) Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [KI_MQ] Valideringer fremgår af ovennævnte dokument Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed] 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. KMD håndterer fejl på MQ service og tilhørende køer. Serviceplatformen sender en fejlbesked til fagsystemet via Beskedfordeler (EP_BF3) i tilfælde af fejl på MQ-kald, så fagsystemet kan genfremsende abonnementsdata Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi KOMBIT A/S Halfdansgade København S CVR Side 32 af 58

33 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [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] Beskrivelse af endpoint EP_KMD2 - ModtagKvitteringAdvisData Transportspecifikation 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 Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af KMD, der tilgås via MQ-klient på Serviceplatformen Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Afventer KMD] [Afventer KMD] [Afventer KMD] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [Afventer KMD] [Afventer KMD] [Afventer KMD] KOMBIT A/S Halfdansgade København S CVR Side 33 af 58

34 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 Dataretning for udveksling Serviceplatformens MQ-klient modtager data til forretningskvitteringer og advisdata fra KMD Indkomst via MQ-køen 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 personabonnement eller forretningskvitteringer for personabonnementer 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 [KI_MQ] afsnit 8.5 og [KMD_FELT] [KI_MQ] afsnit 8.5 og [KMD_FELT] Miljø: Test Inputdata Outputdata [KI_MQ] afsnit 8.5 og [KMD_FELT] [KI_MQ] afsnit 8.5 og [KMD_FELT] Der henvises til følgende dokument udstillet af KMD Indkomst for yderligere oplysninger om dataelementer og valideringer: [KI_MQ] og KMD Indkomst Indkomstgrænseflade P13-5 Felt-oversigt [KMD_FELT] Valideringer fremgår af ovennævnte dokument Sikkerhed Sikkerhed mellem Serviceplatformen og KMD Indkomst er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed] Leverancesikkerhed og fejlhåndtering Kvitteringer og advisdata modtages retur Excactly once. KOMBIT A/S Halfdansgade København S CVR Side 34 af 58