Integration SF0770_E - Abonnement på hændelser vedr. eindkomst Integrationsbeskrivelse - version 2.1.0

Integration SF0770_E - Abonnement på hændelser vedr. eindkomst Integrationsbeskrivelse - version 2.1.0 Kommunernes Datafællesskab - KDF

Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-04-30 JJN 0.1 Første version 2014-04-30 JJN 0.1.1 Efter review hos serviceplatfomen. 2015-05-07 JSE 0.5.0 Sendt til integrationsplatform 2015-05-26 JJN 0.5.1 Rettet i forhold til review-kommentarer fra KY 2015-06-01 JJN 0.5.2 Kommentarer i forbindelse med review er slette og reference fejl rettet. 2015-06-19 JJN 0.5.3 Kapitel 1: Beskrivelse af håndtering af hændelse i forhold til 770_A er tilføjet 2015-07-01 EHE 1.0.0 Første version leveret til fagprojekter, BF udestår. 2015-08-31 EDM 2.0.1 I kapitel 1 er der indsat en kommentar vedrørende forventninger til og håndtering af historiske data i eindkomst. Generelle ændringer omkring Beskedfordeler. Afsnit 1.5 Forudsætninger, afsnit 3.1.4 ModtageBesked, afsnit 3.2 Serviceplatformen som Beskedagent og 4.1.3 tilføje AfsendBesked i integrationsflow 2. Interne referencer opdateret. 2015-09-30 ehe 2.1.0 Opdateret reference til [WSDL-SP], da den fil der blev peget på, manglede at blive uploaded. Referencer Ref Titel Kommentarer [Lovhjemmel SKAT] [SPref] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: https://share-komm.kombit.dk/p089/referencedokumenter [BFref] [Afklaring/KDF indsæt reference dokumentation af servicemål for BF] Endnu ikke udarbejdet [SIKKERHED] https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/skat%20-%20hjemmelsgrundlag%20for%20brug%20af%20eindkomst.pdf [STS-Sikkerhed] [SFTP] [VBF] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx https://www.serviceplatformen.dk/administration/help/provider-tech-guide USM0005 Vejledning til Serviceplatformens SFTP Service.pdf Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Vejledning med xsd. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 33

[SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeler [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeler [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeler [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeler [WSDL-SP] [WSDL-EXT] Integrationsbeskrivelsen refererer til SF0770_E Teknisk Spec 20150930.zip som indeholder WSDL/WADL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Integrationsbeskrivelsen refererer til SF0770_E Bilag 20150701.zip som indeholder WSDL/WADL/XSD af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Indholdsfortegnelse 1 Overordnet beskrivelse... 5 1.1 Integrationens formål... 5 1.2 Overordnet forretningsflow i integrationen... 5 1.3 Servicebetingelser for den samlede integration... 6 1.4 Teststrategi... 9 1.5 Forudsætninger for produktionssætning... 10 2 Kontekst for integrationsparter... 12 2.1 Kontekst for KY... 12 2.2 Kontekst for KSD... 12 2.3 Kontekst for SAPA... 13 3 Specifikation for integrationsparter... 14 3.1 Specifikation af endpoints for KY+KSD+SAPA... 14 3.2 Specifikation af endpoints for Serviceplatformen som afsendende beskedagent... 19 3.3 Specifikation af endpoints for SKAT eindkomst... 21 4 Beskrivelse for integrationsplatforme... 29 4.1 Beskrivelse for Serviceplatformen... 29 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 33

KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 33

1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at fagsystemerne får tilsendt ændringer i indkomstoplysninger fra SKAT på en ønsket personkreds. Dette sker ved at vedligeholde et personkredsabonnement hos SKAT. Indberetningerne benyttes i fagsystemet til at generere ændringshændelser for personens indkomstforhold. Der er vigtigt at fagsystemerne, der benytter denne integration er opmærksomme på at abonnementsdata kun indeholder data op til det tidspunkt de er hentet, og at der efterfølgende kan være registreret indkomstdata, som først vil komme i den efterfølgende kørsel af abonnementsdata. Såfremt fagsystemerne ønsker at benytte realtidsoplysninger, skal der fortages en forespørgsel med snitfade SF0770_A - SKAT Indkomst - Opslag personoplysninger. Den kopi af data, som fagsystemerne har dannet på baggrund af hændelse og opslag i eindkomstoplysninger, skal altid kontrolleres i forhold til om samme indberetning er modtaget tidligere (dupletter). Opbygningen af en lokal kopi af data for en borger, bør altid ske ved at abonnementet oprettes først og derefter fortages en forespørgsel med SF0770_A - SKAT Indkomst - Opslag personoplysninger. Yderlige skal man være opmærksom på at indkomsthændelser kun leveres en gang i døgnet, og at der kan være indkomster, der er indberette i tidsrummet (op til et døgn) siden sidste leverance af hændelser. EIndkomst indeholder indkomstdata tilbage til 2008. Det må dog forventes at de historiske indkomstdata hvert år forskydes med et år. Der kan modtages indkomstændringer, som er relateret til tidligere skatteår, såfremt der kommer nye registrering til dette skatteår. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende komponenter i integrationen. SKAT eindkomst udstiller services for vedligehold abonnement, samt MQ-kø til at returnere indkomstindberetningerne Serviceplatformen sikrer gennemstilling af service til vedligeholdelse af abonnement hos SKAT. Serviceplatformen modtager forsendelser af indkomstoplysninger fra SKAT og opdeler oplysninger per person og kalder beskedfordeleren, der distribuerer beskederne til fagsystemerne. Der skal oprettes et abonnement på beskedtypen i beskedfordelerens administrationsmodulet per fagsystem, men personkredsen skal ikke vedligeholdes i beskedfordeler. Fagsystemer vedligeholder personabonnement for et eller flere fagområder, og modtager SKAT indkomstindberetninger gennem beskedfordeler for disse abonnementer. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 33

Kildesystem Serviceplatformen Beskedfordeler Anvendersystem (n) Integrationsbeskrivelse SKAT indkomstberegninger periodiske abonnementsudtræk IF01 - Ajourfør abonnement IF02 - Bestil data Ny sag Ajourfør eksternt abonnement Behandl svar på Abonnement ajourført Modtag indkomstdata Push Distribuer indkomstdata Modtag indkomstdata Gennemstil forespørgsel Gennemstil svar Send indkomstdata Formater indkomstdata Lyt på kø Hent indkomstdata Ajourfør abonnement Daglig Dan indkomstdata Udstil indkomstdata 1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål For Serviceplatformen gælder på punkterne tidsrum, svartid, tilgængelighed og servicevindue de generelle betingelser fra driftsaftale for Serviceplatformen. Se [SPref]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 33

Parameter Flow 1 Flow 2 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. SKAT vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. 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 SKAT vil ikke forpligtige sig til at oplyse svartider. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. SKAT vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. SKAT har oplyst, at der er en generel spidsbelastning af eindkomst-systemer den 25. 26. i hver måned samt sidst på 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]. SKAT vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. 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]. SKAT vil ikke forpligtige sig til at oplyse svartider. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. SKAT vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. SKAT har oplyst, at der er en generel spidsbelastning af eindkomst-systemer KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 33

Servicevinduer måneden, og at belastningen er højest i dagtimerne mellem kl. 6.00 og 18.00 Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. SKAT oplyse at information om servicevinduer, kan findes på følgende link http://www.skat.dk/skat.aspx?oid=9710 &vid=0 og at der via denne side kan abonneres på et RSS feed. den 25. 26. i hver måned samt sidst på måneden, og at belastningen er højest i dagtimerne mellem kl. 6.00 og 18.00 Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. SKAT oplyse at information om servicevinduer, kan findes på følgende link http://www.skat.dk/skat.aspx?oid=971 0&vId=0 og at der via denne side kan abonneres på et RSS feed. Man kan generelt finde information om driftssituationen på SKATs driftlog for eindkomst og Letløn på link http://www.skat.dk/skat.aspx?oid=9710&vid=0. 1.3.2 Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: https://share-komm.kombit.dk/p089/ Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 33

1.3.2.1 Incident Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 1.3.2.2 Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 1.3.2.3 Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 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 unit tests. Den udstillede service hos SKAT kører allerede både i SKATs produktionsmiljø og testmiljø, og der udføres derfor ikke test af dette. [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for. Der kan blive behov for deltage fra KY, KSD og SAPA.] 1.4.1.1 Testfaciliteter og testmiljø SKAT udstiller et eksternt testmiljø, som kan benyttes i test af Serviceplatformens træk på kildedata. Man kan i test benytte det samme certifikat, som er blevet leveret i SF1570 R75 Opslag kontroloplysninger. [Afklaring/KDF: Den endelig løsning om MQ klient løsning er endnu ikke bekræftet, og derfor ikke etableret. Den kan derfor ikke beskrives] 1.4.1.2 Testdata Det er ikke samme testmiljø, som benyttes til indberetning af indkomst og udtræk af indkomst, og man kan derfor ikke opbygge en test, hvor man udtrækker de indberetninger af indkomst, som man måtte have foretaget. SKAT har et værktøj, som kan genererer Indkomstdata til test af udtræk af indkomstdata. Værktøjet understøtter ikke alle indkomsttyper, og det vil derfor være nødvendigt efterfølgende at manipulere testdata, så det bliver dækkende. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 33

SKAT stille testdata til rådighed, men KOMBIT kan også selv beslutte en personkreds, som de ønsker at teste på. [Indhold afventer generel afklaring af test] 1.4.2 Test i forbindelse med produktionssætning [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for. Det kan fx være behov for beskrive verifikation af 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 1.5 Forudsætninger for produktionssætning 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]. [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] 1.5.1 Funktionalitet på Serviceplatformen 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 beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så beskedagent 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. Yderligere skal der etableres MQ-Klient løsning på Serviceplatformen til kommunikation med SKAT. 1.5.2 Forudsætninger for tilslutning til integrationspart: SKAT KOMBITs certifikat skal anvendes til at autorisere kommunikationen med udgangspunkt i Fejl! Henvisningskilde ikke fundet.. Dette kræver at der for hver kommune for hvert fagsystem har KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 33

indgået en aftale om overførelse af indkomstoplysninger, hvilket er gjort i forbindelse med aftale omkring monopolbrud. Et fagsystem kan dække et eller flere fagområder. De enkelte fagområder skal være understøttet af relevant lovgivning for overførelse af indkomstoplysninger. Hvert fagområde vil få tilknyttet en adgangsformålstypekode, som dokumenterer det lovgrundlag, som et system anvender for et abonnement. Kommunen skal efter aftaleindgåelse ind på SKAT TastSelv Erhverv, og autoriserer KOMBIT som revisor for det SE-nummer, som er oprette til formålet. Dette oprettes som en Kigo opgave Abonnementer oprettes via en SOAP service. Overførelse af indkomstoplysninger foregår via MQ, og der skal derfor implementeres en MQ-klient på Serviceplatformen, der kommunikerer med en MQ-manager/kø på SKATs side. Der etableres en VPN tunnel, for at sikre fortrolighed i kommunikationen. 1.5.3 Forudsætninger for tilslutning til integrationspart: Fagsystemet Det er fagsystemernes ansvar at medsende den korrekte adgangsformålstypekode i forbindelse med oprettelse af et abonnement på en person hos SKAT, da Adgangsformålstypekode ikke indgår, som en del af KOMBITS sikkerhedsmodel. Der er en 1:1 forhold mellem lovhjemmel og adgangsformålstypekode. SKAT benytter disse til at fortage datafiltring, så der kun modtages data i følge den pågældende lovhjemmel. For hvert fagsystem skal der indgås aftale med SKAT omkring hvilke data der skal udstilles for en for en adgangsformålstypekode. For KY og KSD er der lagt op til at der kun skal anvendes én adgangsformålstypekode, mens der for SAPA skal anvendes flere. 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 og SF1460_B. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 33

2 Kontekst for integrationsparter 2.1 Kontekst for KY 2.1.1 Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Se SKATs Notat af 29 marts 2011 - eindkomst felter til opgaver på områderne social, beskæf-tigelse og familieydelser afsnit 14. [Lovhjemmel SKAT]. 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 indhold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål er at modtage advisering hvis en kontanthjælpsmodtager ændrer indkomst, med henblik på kontrol, og for at vurdere konsekvenser for de modtagne ydelser. 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] Løsningen modtage udtræk med indkomstoplysninger for samtlige kontanthjælpsmodtagere (ca. 400.000 pr. måned). KY vil tegne/afmelde 70.000 abonnementer om måneden. Antallet af abonnementsbestillinger/afbestillinger svarer til antal aktive sager startet og stoppet i perioden. 2.1.3 Specifikke forhold for tilslutning af system SE 1.5.2 Forudsætninger for tilslutning til integrationspart: SKAT 2.2 Kontekst for KSD 2.2.1 Lovhjemmel og forvaltningsmæssigt formål Dagpenge ved sygdom: Hjemmelsgrundlaget for dataindsamling ses i Retssikkerhedsloven 11a stk 3, jf. stk 1+2 og 11c Lov om ansvaret for og styringen af den aktive beskæftigelsesindsats 68, 68a og 68b Lov om sygedagpenge Det forvaltningsmæssige formål er at modtage advisering hvis en sygedagpengemodtager ændrer indkomst, med henblik på kontrol, og for at vurdere konsekvenserne for de modtagne ydelser. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 33

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. 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] Antallet af abonnementsbestillinger/ afbestillinger svarer til antal aktive sager startet og stoppet i perioden. Der beregnes hver måned sygedagpenge til ca. 75.000 løbende sager, så udtrækket vil blive af den størrelsesorden. KSD vil tegne/afmelde 65.000 abonnementer pr. måned på advis om indkomst. 2.2.3 Specifikke forhold for tilslutning af system SE 1.5.2 Forudsætninger for tilslutning til integrationspart: SKAT 2.3 Kontekst for SAPA 2.3.1 Lovhjemmel og forvaltningsmæssigt formål 2.3.2 Kapacitets- og servicekrav SAPA har forsøgt at beregne antallet indkomstadviser, der generes i kommunerne ud fra en vurdering af fagområderne Økonomiske fripladstilskud og Kontanthjælp (se vedhæftede). Tallet er mellem 20.000 30.000 pr. måned pr. fagområde. Selvom det naturligvis er forbundet med en stor usikkerhed, vil tallet således samlet for nedenstående fagområder (minus UDK fagområder: Dagpenge ved barsel, Boligstøtte, Social pension, Børnetilskud, Børnebidrag, Fleks-ydelse) blive: 180.000 270.000 indkomstadviser pr. måned I bedste fald laves der 1 kald til SKAT pr. advis, i værste fald 2-3. 2.3.3 Specifikke forhold for tilslutning af system SE 1.5.2 Forudsætninger for tilslutning til integrationspart: SKAT KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 33

3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY+KSD+SAPA Integrationen benyttes til at abonnere på indkomsthændelser for en personkredse. Fagsystemet vedligeholder løbende en liste over personer, der ønskes indkomsthændelser for. Såfremt et fagsystem har behov for indkomsthændelser fra forskellig fagområde, skal der vedligeholdes et abonnement og personkreds per fagområde. I denne sammenhæng eksisterer der et hjemmelsgrundlag for hver fagområde til at hente indkomstoplysninger for en person. Fagområder er identificeret ved en formålstypekoder, der skal medgives i kaldet for vedligeholdelse af abonnementet. SKAT leverer dagligt et asynkront udtræk med indkomstregistreringer per abonnement (per adgangsformålstypekode) per kommune til serviceplatformen. Udtrækket indeholder alle de registreringer, der er registret hos SKAT siden sidste udtræk. Serviceplatformen opdeler udtrækket for et abonnement i beskeder per CPR-nummer og indberetter og sender dem via Beskedfordeleren til fagsystemerne. Beskederne vil kunne indeholde en eller flere indkomstoplysning for samme indberetter af indkomst. Er der flere indberetter af indkomst vil fagsystemerne kunne modtage flere beskeder for hvert CPR-nr. Fagsystemerne vil kunne modtage sammen indkomstbeskeder, hvis der er oprettet flere abonnementer på samme person. Der er ikke behov for, at Fagsystemerne opretter værdiliste i beskedfordeleren, da der allerede er oprettet en sådan hos SKAT. Fagsystemerne vil kunne identificere besked ud fra beskedtypen, CPR-nr. og abonnementstype. [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.] 3.1.1 Overordnet forretningslogik Fagsystemet kalder synkron gennemstillingsservice (EP_FS1) på Serviceplatformen til at vedligeholde abonnement på en personkreds hos SKAT (EP_SK1). Serviceplatformen vil modtage et udtræk af indkomstoplysninger for hvert abonnement fra skat (EP_SK2/ EP_SK2). Udtrækket opdeles i beskeder efter CPR-nr, og oprettes som beskeder til beskedfordele (EP_SK2). 3.1.2 Oversigt over endpoints ID Navn EP_FS1 IndkomstOplysningerVedligholdAbonnement KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 33

EP_FS2 ModtagBesked (Indkomstindberetninger) 3.1.3 Beskrivelse af endpoint EP_FS1 Vedligehold indkomst abonnement 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatform udstiller servicen IndkomstAbonnementVedligehold Operationer: - OpdaterAbonnement Modtager besked om en eller flere personer, der skal have oprettet/ ændret/ slettet abonnement på indkomstoplysninger 3.1.3.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.3.1.3 Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice. 3.1.3.1.4 Teknisk endpoint Miljø: Produktion URI til WSDL [Udfyldes af Systematic senere] Da der er tale om en gennemstillingsintegration udfyldes der med WSDL svarende til den SKAT udstiller for IndkomstOplysningPersonAbonnementAjourfør på denne URL: http://85.81.229.78/services/prod/eindkomst/wsdl/indkomstoplysningpersonabonnementajourfoer.wsdl Endpoint navn Endpoint IP [Udfyldes af Systematic senere] [Udfyldes af Systematic senere] 3.1.3.1.5 Teknisk retning for udveksling Fagsystemet sender abonnementsoplysninger til Serviceplatformen ved kald af service udstillet af Serviceplatformen. 3.1.3.1.6 Dataretning for udveksling Abonnementsoplysninger sendes fra Fagsystemet til Serviceplatformen. 3.1.3.1.7 Service invokation / Triggers Kommunikation initieres af, at Fagsystemet ønsker fremtidige indkomsthændelser omkring en eller flere personer, eller et tidligere abonnement på en person skal ophøre. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 33

3.1.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.] Vil svare til de abonnementsoplysninger der sendes til SKAT i henhold til IndkomstOplysningPersonAbonnementAjourfoer_IType.xsd. Elementet AbonnentVirksomhed skal indeholde Abonnenten SE-nummer. Der vil være et SE-nr per kommune og fagsystem (3 fagsystemer * 98 kommuner). Elementerne AbonnentTypeKode, AbonnementTypeKode og AdgangFormaalTypeKode skal aftales for hver abonnement. Eksempler på værdier for elementerne er vist nedenfor, og det kan forventes at fremtidige værdier vil ligne: AbonnentTypeKode 8396 AbonnementTypeKode 6251 AdgangFormaalTypeKode 638 Elementet AbonnentAdgangOmfangTypeTekst skal indeholde værdien IndkomstOplysningKlassiskAbonnentHent I Elementet kontekst:hovedoplysninger skal TransaktionIdentifikator udfyldes med Kald id som anvendes ved logning i serviceplatformen. Ligeledes udfyldes TransaktionTid med det tidsstemple, som i logning anvendes for Tidspunkt. Disse oplysning returneres i svaret. Se nedenstående link for yderligere information: https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/oiohovedoplysninger.pdf Man kan ikke i samme operation både have opret og nedlæg abonnement. Felterne Startdato og slutdata kan kun udfyldes med dags dato, hvorfor de er implicitte. 3.1.3.3 Sikkerhed Servicen indgår i en integration med SKAT og opfylder Sikkerhedsmodel UC-SEC-06 [SIKKER- HED]. 3.1.3.4 Leverancesikkerhed og fejlhåndtering Snitflader er At least once Fejl på abonnementsservice håndteres af Fagsystemet. [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] 3.1.3.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 16 af 33

3.1.3.5.1 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. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. 3.1.4 Beskrivelse af endpoint EP_FS2 ModtagBesked Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Fagsystemet beslutter selv, om der benyttes push eller pull. Beskedfordeler udstiller beskeder fra SKAT. Endpoint benyttes af fagsystemerne i forbindelse med modtagelse af indkomstindberetninger. 3.1.4.1 Abonnementsvilkår Fagsystemet skal oprette abonnement på beskedtypen SKATPersonIndkomstOplysninger. Fagsystemerne skal desuden oprette abonnement på Relateret Objekt: ObjektType = SE-nr og ObjektID = urn:oio:se-nr:nnnnnnnn' hvor dette SE-nr afspejler fagsystemet for denne myndighed. ObjektTypen SE-nr har UUID [indsæt UUID]. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[0].ObjektType = <UUID for SEnr> ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt 0].ObjektId = urn:oio:se-nr:<se-nr for myndighed/fagsystem> )) KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 33

Der er ingen værdiliste der skal opdateres, da dette sker via det abonnement der er oprettet hos SKAT. 3.1.4.2 Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1460_D] Outputdata Se [SF1460_D] Dataspecifikationen for indholdet af selve beskedindholdet findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Base64 encoded (af SKAT fast format record). Outputdata Se afsnit 3.2.3.1 for en beskrivelse af indholdet i beskedkuvert og indhold. 3.1.5 Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. 3.1.5.1 Incident Management [Afklaring KY/KSD: ] 3.1.5.2 Problem Management [Afklaring KY/KSD: ] 3.1.5.3 Change Management [Afklaring KY/KSD: ] 3.1.6 Testplan 3.1.6.1 Integrationstest [Afklaring KY/KSD: ] 3.1.6.2 Produktionssætningstest [Afklaring KY/KSD: ] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 33

3.2 Specifikation af endpoints for Serviceplatformen som afsendende beskedagent Integrationen benyttes af Serviceplatformen til at sende Indkomstindberetninger fra SKAT til Beskedfordeler. 3.2.1 Overordnet forretningslogik Serviceplatformen sender Indkomstindberetninger til Beskedfordeler: Serviceplatformen kalder EP_SP1 Beskedfordeler returnerer et synkront svar til afsender 3.2.2 Oversigt over endpoints ID Navn EP_SP1 AfsendBesked 3.2.3 Beskrivelse af endpoint EP_SP1 AfsendBesked Beskrivelsen af endpoint findes i Aflever besked [SF1460_C]. Serviceplatformen sender Indkomstindberetninger. Endpoint kaldes ved ændring i indberetninger. 3.2.3.1 Dataspecifikation En besked består af en kuvert og et beskedindhold. 3.2.3.1.1 Beskedkuverten dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1460_C] Outputdata Se [SF1460_C] Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer. Værdier angivet med er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal afsendersystemet selv udfylde. [De fleste Id er er baseret på UUID dog med undtagelse af: KLE - urn:oio:kle:nn.nn.nn CPR - urn:oio.cpr:nnnnnnnnnn CVR - urn:oio:cvr:nnnnnnnn SE-nr - urn:oio:se-nr:nnnnnnnn KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 33

PNR urn:oio:pnr:nnnnnnnnnn Fuldtnavn - urn:oio:fuldtnavn:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Adresse - urn:oio:adresse:kkk;vvv;nnn;xx;xx;nn da disse ikke repræsenteret af et UUID og derfor skal benytte urn.] Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype SKATPersonIndkomst- Oplysninger [Afklaring/KDF: UUID for beskedtypen SKATPersonIndkomstOplysninger ] BeskedAnsvarligAktør It-system, SKAT eindkomst [Afklaring/KDF: UUID for SKAT eindkomst] TilladtModtager Den kommune, der har abonnementet. urn:oio.cvr:nnnnnnnnnn Mappes gennem sikkerhedstoken fra SEnummer til CVR-nr. Se nedenfor. RelateretObjekt[0] ObjektId SE-nr på en kommune urn:oio.se-nr:nnnnnnnn fra Abonnements SE-nr. ObjektType Forretningsobjektet SE-nr [Afklaring/KDF: UUID for forretningsobjektet SE-nr] Objektregistrering ObjektRegistreringId id for hændelsen, der ligger til grund for beskeden [Afklaring/KDF: UUID for hændelsen hvor kommer den fra eller skal den udelades] RegistreringsAktoer Serviceplatformen [Afklaring/KDF: UUID for Serviceplatformen] Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden Tidspunktet modtaget på serviceplatformen i DateTime format. ObjektAnsvarligMyndighed Den kommune, der har abonnementet. ObjektId ObjektType N/A Forretningsobjektet Indkomstoplysning urn:oio.cvr-nr:nnnnnnnnnn Mappes gennem sikkerhedstoken fra SEnummer til CVR-nr. Se nedenfor. [Afklaring/KDF: Indsæt UUID for Indkomstoplysning ] ObjektHandling OpgaveEmne Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldighedFra Handlingen Ny indberetning N/A Tidspunkt hvor beskeden opstod Klassificeringen Personfølsomt Tidspunkt hvor hændelsen opstod [Afklaring/KDF: Indsæt UUID for Ny indberetning ] Afsendelsestidspunktet fra serviceplatform i DateTime format [Afklaring/KDF: Indsæt UUID for Personfølsomt ] Tidspunktet modtaget på serviceplatformen i DateTime Format Sikkerhedstoken vil indeholde en liste af CVR-numre med relaterede SE-nr. I hver eskattekort modtages SE-nr for indberetter af ansættelsesforholde (Arbejdsgivers se-nr) i element <xs:element name="senr">. Herved er det muligt at mappe fra SE-nr til CVR-nr og udfylde TilladtModtager og ObjektAnsvarligMyndighed. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 33

Abonnements SE nr. og AdgangsFormålstypekode kan direkte udledes af felterne i blanket 0 ( headerinformation ) i udtrækket fra SKAT. CPR-nr. kan udledes af felt i blanket 1. For yderligere oplysninger se http://share-it.kombit.dk/p089/ledelsesprodukter/notat Støttesystemer - integrationsmodel.docx] 3.2.3.1.2 Beskedindhold dataspecifikation Datastrukturen i SKATs udtræk vil være opbygger hierarkisk i den rækkefølge blanketter er nævnte nedenfor. Blanketter kan indgå flere gange på det niveau, som de høre til, dog ikke blanket 0. Data opdeles i beskeder per sektion af blanket 1. 0 - Abonnementsinformation 1 - Referenceoplysning for indkomstindberetning 11000 - Generelle indkomstoplysninger 16000 - Generelle oplysninger for indkomstmodtager 16001 - Indkomstoplysninger 16002 Lønindeholdelse Data i beskederne fremsendes i det format som de er modtaget i fra SKAT som er fast separeret format poster. Der skal anvendes Codepage ISO 8859-1, en record pr. XML felt. Og skal være Base64 encoded. For yderligere information om datastruktur for blanketter se bilag: For yderligere information om datastruktur fra skat til MQ-kø se bilag: https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/20140514%20-%20underbilag%20bilag%201%20-%20skabelonversion%201.27.xlsx https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/20120828%20v%201.5%20-%20snitfladebeskrivelse%20mq%20vejledning%20på%20eindkomst%20udstilling.doc Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Base64 encoded Outputdata 3.2.4 Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C]. 3.3 Specifikation af endpoints for SKAT eindkomst Integrationen benyttes til at abonnere på en personkreds indkomstoplysninger, modtages et dagligt udtræk over indkomst indberetninger. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 33

Abonnementet oprettes via en synkron webservice, mens SKAT eindkomstoplysninger 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 data-kø og status-kø, er at der kan understøttes flere transaktioner i samme forsendelse. Data modtages på data-køen i en eller flere transaktioner. Efter sidste data er sendt, modtages en commit-besked på status-køen. Data sendt på data-køen må ikke behandles før commit-besked er modtaget på status-køen. Modtages en annullering skal al modtagen data ignoreres og slettes. 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.] Endpoint EP_SK1 hos SKAT kaldes fra Serviceplatformen for at vedligeholde et abonnement med en personkreds, som efterfølgende levere indkomstoplysninger på. 3.3.2 Oversigt over endpoints ID Navn EP_SK1 EP_SK2 EP_SK2 Vedligehold SKAT abonnement Modtag indkomstoplysninger Data-kø Modtag indkomstoplysninger Status-kø 3.3.3 Beskrivelse af endpoint EP_SK1 Vedligehold SKAT abonnement 3.3.3.1 Transportspecifikation 3.3.3.1.1 Serviceudstiller SKAT eindkomst udstiller service IndkomstOplysningPersonAbonnementAjourførService med hvilken et personabonnement kan vedligeholdes. Operationen getindkomstoplysningpersonabonnementajourfør vedligeholder personabonnementer til brug i IndkomstOplysningKlassiskAbonnement. Hvert kald kan angive nyt abonnement eller slette et eksisterende abonnement for en eller flere personer. 3.3.3.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.3.3.1.3 Teknologisk understøttelse Snitfladen er implementeret som synkron webservicebaseret, SOAP/HTTPS. 3.3.3.1.4 Teknisk endpoint Defineres af wsdl IndkomstOplysningPersonAbonnementAjourfoer : http://rep.oio.dk/skat.dk/eindkomst/wsdl/ KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 33

https://services.extranet.skat.dk/vericert/services/indkomstoplysningpersonabonnementajourfoer- ServicePort (se http://85.81.229.78/services/prod/eindkomst/wsdl/indkomstoplysningpersonabonnementajourfoer.wsdl ) 3.3.3.1.5 Teknisk retning for udveksling Serviceplatformen foretager synkront kald til SKAT eindkomst. 3.3.3.1.6 Dataretning for udveksling Serviceplatformen leverer personabonnementsoplysninger til SKAT eindkomst. 3.3.3.1.7 Service invokation / Triggers Kommunikation initieres af servicekald mod SKAT eindkomst fra Serviceplatformen. 3.3.3.2 Dataspecifikation Den samlede dataspecifikationen for den udstillede service hos SKAT eindkomst fremgår af den definerede wsdl med tilhørende xsd. Der søges på en specifik basismåned, som er den måned der går forud for den måned hvori servicekaldet initieres. Der er ikke identificeret et tekstdokument med beskrivelse, men strukturen er simpel, så dokumentationen i wdsl må anvendes i dette tilfælde. Se Kapitel 3.1.3.2 Dataspecifikation for supplerende information. XSD for indgående kald ligger hér: http://85.81.229.78/services/prod/eindkomst/view/indkomstoplysningpersonabonnementajourfoer_itype.xsd [Udfyld med beskrivelse af datavalidering] 3.3.3.3 Sikkerhed Integrationen mod SKAT benytter KOMBIT VOCES certifikat mod SKAT og opfylder Sikkerhedsmodel UC-SEC-06 [SIKKERHED]. 3.3.3.4 Leverancesikkerhed og fejlhåndtering Serviceplatformen skal, ud over retursvaret, håndtere timeout på kaldet med SKAT. Såfremt valideringen hos SKAT fejler, vil fejlen fremgå af retursvaret der modtages på Serviceplatformen. I tilfælde af fejl / timeout i kommunikationen med SKAT vil Serviceplatformen informere det kaldende fagsystem med angivelse af fejlen. 3.3.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.3.3.5.1 Aftalt driftstid Parameter Værdi KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 33

Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] 3.3.4 Beskrivelse af endpoint EP_SK2 Modtag indkomstoplysninger Data-kø Der modtages flere daglige udtræk med indkomstoplysninger på en MQ-kø. 3.3.4.1 Transportspecifikation 3.3.4.1.1 Serviceudstiller SKAT eindkomst udstiller MQ service med udgående kø, hvor Indkomstoplysninger modtages. Data polles af modtageren via læsning på køen. Indkomstoplysninger afsendes af SKAT via Data-køen i en eller flere transaktioner. Når alle data er afsendt i en leverance, sendes en afslutningsbesked på Status-køen. Samhørende beskeder på data og status-kø bestemmes med MQ-correlation-id. 3.3.4.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.3.4.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af SKAT, som tilgås via MQ-klient på Serviceplatformen. Serviceplatformen skal benytte MQ-klient version 7.5, selvom SKAT benytter MQ-queuemanager kører version 7.0.1. Se afsnit Fejl! Henvisningskilde ikke fundet. Fejl! Henvisningskilde ikke fundet. 3.3.4.1.4 Teknisk endpoint SKAT MQ er dokumenteret her: http://www.skat.dk/skat.aspx?oid=2108066 under punktet MQ og SFG 3.3.4.1.5 Teknisk retning for udveksling Serviceplatformen foretager MQget-kald til SKAT eindkomst MQ-server via MQ-klient, som returnerer næste besked på køen når denne er klar. 3.3.4.1.6 Dataretning for udveksling SKAT eindkomst sender indkomstoplysninger til Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 33

3.3.4.1.7 Service invokation / Triggers Kommunikation initieres af SKAT eindkomst, som udfører put-operationer på MQ-status køen, som er beskrevet i 3.3.5 Overordnet beskrivelse, herefter kan de fremsøgte indkomstoplysninger læses på Data-køen 3.3.4.2 Dataspecifikation Der vil modtages flere daglige udtræk fra SKAT, som skal behandles (ca. 98 kommunale udtræk som funktion af formålstypekode per system dagligt). Data specifikation følger det der er beskrevet i kapitel 3.1.3.2 Dataspecifikation. Er der ikke udtræk til et abonnement, vil der modtages fejlbesked 1015, se dokument om datastruktur fra skat til MQ-kø kapitel 5 nedenfor. For yderligere information om datastruktur for blanketter se bilag: Formatet fremsendes som fast format poster. Der skal anvendes Codepage ISO 8859-1. OBS. Hele ISO 8859-1 karaktersættet anvendes, undtagen ['] "apostrof". For yderligere information om datastruktur fra skat til MQ-kø se bilag: Det vil for hvert abonnement blive indgået en aftale om hvilke indkomstinformationer der leveres. Afhængig af aftalen kan der være felter og blanketter, som er aftalt, øvrige vil være udeladt af udtrækket. https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/20140514%20-%20underbilag%20bilag%201%20-%20skabelonversion%201.27.xlsx https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/20120828%20v%201.5%20-%20snitfladebeskrivelse%20mq%20vejledning%20på%20eindkomst%20udstilling.doc 3.3.4.3 Sikkerhed Integrationen mod SKAT benytter KOMBIT VOCES certifikat og der skal ligeledes etableres en VPN tunnel, hvilket opfylder Sikkerhedsmodel UC-SEC-09 [SIKKERHED]. 3.3.4.4 Leverancesikkerhed og fejlhåndtering Udtræk af Indkomstoplysninger overføres Exactly once. Dette styres via MQ-transaktion. Såfremt der opstår en fejl i en af transmissionerne på data-køen, kan der sendes en Annuller besked på status-køen, og hele transmissionen kan herefter genfremsendes igen. Modtager serviceplatformen en Annuler skal hele den pågældende forsendelse ignoreres og slettes. SKAT håndterer fejl på MQ service og tilhørende køer. Serviceplatformens orkestrering håndterer fejl over for SKAT, herunder at sikre genfremsendelse af søgninger der fejler. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 33

3.3.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.3.4.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] 3.3.5 Beskrivelse af endpoint EP_SK2 Modtag indkomstoplysninger Status-kø 3.3.5.1 Transportspecifikation 3.3.5.1.1 Serviceudstiller SKAT eindkomst udstiller en MQ service med en kø til at afslutningsbeskeder fra SKAT (Statuskø). Data polles af modtageren via læsning på køen. Indkomstoplysninger afsendes af SKAT via Data-køen i en eller flere transaktioner. Når alle data er afsendt i en leverance, sendes en afslutningsbesked på Status-køen. Man kan til hver en tid fortryde en afsendelse og sende en annuller besked. Samhørende beskeder på data og status-kø bestemmes med MQ-correlation-id. 3.3.5.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.3.5.1.3 Teknologisk understøttelse Snitfladen er implementeret som en MQ-kø udstillet af SKAT, som tilgås via MQ-klient på Serviceplatformen. Serviceplatformen skal benytte MQ-klient version 7.5, selvom SKAT benytter MQ-queuemanager kører version 7.0.1. Se afsnit Fejl! Henvisningskilde ikke fundet. Fejl! Henvisningskilde ikke fundet. 3.3.5.1.4 Teknisk endpoint SKAT MQ er dokumenteret her: http://www.skat.dk/skat.aspx?oid=2108066 under punktet MQ og SFG KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 33

3.3.5.1.5 Teknisk retning for udveksling Serviceplatformen foretager MQget-kald til SKAT eindkomst MQ-server via MQ-klient, som returnerer næste besked på køen når denne er klar. 3.3.5.1.6 Dataretning for udveksling Serviceplatformens MQ-klient modtager afslutningsbeskeder til udtræk af indkomstoplysninger fra SKAT eindkomst via MQ-køen. 3.3.5.1.7 Service invokation / Triggers Kommunikation initieres af, at SKAT eindkomst afsluttet eller ønsker at annullere afsendelse af data til Serviceplatformen via EP_FS2. Der modtages en besked på status kø, og herefter kan forsendelsen på data-kø beskrevet i kapitel 3.3.4 Beskrivelse af endpoint EP_SK2 Modtag indkomstoplysninger Data-kø henholdsvis læses og viderebehandles eller slettes. 3.3.5.2 Dataspecifikation Formatet fremsendes som fast format poster. Der skal anvendes Codepage ISO 8859-1. OBS. Hele ISO 8859-1 karaktersættet anvendes, undtagen ['] "apostrof". For yderligere information om datastruktur fra skat til MQ-kø se bilag: https://share-it.kombit.dk/p089/integrationsbeskrivelser/bilag/sf770_e/20120828%20v%201.5%20-%20snitfladebeskrivelse%20mq%20vejledning%20på%20eindkomst%20udstilling.doc 3.3.5.3 Sikkerhed Integrationen mod SKAT benytter KOMBIT VOCES certifikat og der skal ligeledes etableres en VPN tunnel, hvilket opfylder Sikkerhedsmodel UC-SEC-09 [SIKKERHED]. 3.3.5.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å data-køen, kan SKAT sende en Annuller besked på status-køen. Dette skal bevirke at Serviceplatformen ignorerer al information modtaget på samme ID via data-køen (EP_SK3). Herefter genfremsender SKAT hele transmissionen igen. SKAT håndterer fejl på MQ service og tilhørende køer. 3.3.5.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.3.5.5.1 Aftalt driftstid Parameter Værdi KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 33

Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Udfyldes af KOMBIT senere] [Udfyldes af KOMBIT senere] [Udfyldes af KOMBIT senere] [Udfyldes af KOMBIT senere] [Udfyldes af KOMBIT senere] 3.3.6 Service Management 3.3.6.1 Incident Management [Indhold afventer generel afklaring af governancestrukturer.] 3.3.6.2 Problem Management [Indhold afventer generel afklaring af governancestrukturer.] 3.3.6.3 Change Management [Indhold afventer generel afklaring af governancestrukturer.] 3.3.7 Testplan 3.3.7.1 Integrationstest [Indhold afventer generel afklaring af test] 3.3.7.2 Produktionssætningstest [Indhold afventer generel afklaring af test] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 33