Integration SF0770_A - SKAT Indkomst - Opslag personoplysninger Integrationsbeskrivelse - version 2.3.3

Integration SF0770_A - SKAT Indkomst - Opslag personoplysninger Integrationsbeskrivelse - version 2.3.3 Kommunernes Datællesskab KDF

Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-10-06 MHO 0.1 Første version 2014-10-24 MHO 0.2 Indsat i ny template 2015-06-29 JJN 2.0 Referencerettelser mm. 2015-06-29 EHE 2.1 Teknisk beskrivelse godkendt 2015-08-14 JJN 2.2.0 I kapitel 1 er der indsat en kommentar vedrørende forventninger til historiske data i eindkomst. [WSDL-SP] opdateret med reference til ny wsdl-fil. Rettelser til wsdl-fil indeholder manglende filer samt indarbejdelse KOMBIT token sikkerhedsmodel. 2015-12-15 JJN 2.3.0 Reference til bilag, som indeholder pixi-beskrivelse for tilslutning til SKAT via Revisorordning tilføjet. Link til Spref indsat i referencer. Kapitel 1.1 Opdateret med datagrænsning Kapitel 1.5 Opdateret med yderlige beskrivelse forhold for tilslutning. WSDL tilføjet til bilag 2016-12-17 JJN 2.3.1 Alle referencer til SAPA er slettet Forudsætninger og vilkår ændret: - Kapitel 1.5 - Kapitel 2.1.3 relevant for KY - Kapitel 2.2.3 relevant for KSD - Kapitel 4.1.3 Relevant for Serviceplatformen Identifikation indkomstoplysning (Dublethåndtering) - Kapitel 1.2, 3.1.3.2 Der er lagt supplerende materiale til bilag, herunder et eksempel på en abonnementstale. 2017-01-06 JJN 2.3.2 I Kapitel 1 er der tilføjet en tekst, som gør opmærksom på at format indkomstdata ændre sig over tid. Kapitel 1.5.2 er det præciseret at der skal indgås en abonnementstale med SKAT for at kunne benytte servicen. 2017-03-10 JJN 2.3.3 Kapitel 1 er uddybet med en overordnet beskrivelse de filtreringsmuligheder en abonnementstale kan indgås med Kapitel 2.3 er omdøbt til kapitel 2.4, og Kapitel 2.3 beskriver lovhjemmel, kapacitet og aktiviteter i forbindelse med idriftsættelse Ydelsesrefusion. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 34

Kapitel 3.1.3.3 præcisere hvilket CVR-nr., som der skal benyttes i forbindelse med generering token for at anvende servicen. Opdateret tabel vedr. teknisk endpoint for anvender, med henvisning til servicenavn på sp samt version. Referencer Ref Titel Kommentarer [SPref] Note vedrørende servicemål for Serviceplatformen [SIKKERHED] Use cases for brug sikkerhedsmodeller på Serviceplatformen v.0.4.3 Kun relevant for leverandøren til serviceplatformen Se link https://share-komm.kombit.dk/p089/referencedokumenter/forms/samlet.aspx [STS-Sikkerhed] [WSDL-SP] [WSDL-EXT] [GVF] [UBB1] Se vilkår Bilag 2 Vilkår for anvendelse sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Integrationsbeskrivelsen refererer til SF0770_A Teknisk Spec 20151201.zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Integrationsbeskrivelsen refererer til SF0770_A Bilag 20161117.zip som indeholder materiale i forbindelse med eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Generelle vilkår og forudsætninger Bestillingsformular til abonnementstale med SKAT: 20151101 - UnderBilag Bilag 1 - SkabelonVersion 1.31.xlsx KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 34

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... 8 1.5 Tilslutning til sniftflade... 8 2 Kontekst for integrationsparter... 10 2.1 Kontekst for KY (Kontanthjælp) [!@KY@!]... 10 2.2 Kontekst for KSD (Sygedagpenge) [!@KSD@!]... 13 2.3 Kontekst for Ydelsesrefusion [!@YR@!]... 17 2.4 Kontekst for SKAT [!@SKAT@!]... 19 3 Specifikation for integrationsparter... 21 3.1 Specifikation endpoints for KY+KSD... 21 3.2 Specifikation endpoints for SKAT eindkomst... 25 4 Beskrivelse for integrationsplatforme... 30 4.1 Beskrivelse for Serviceplatformen... 30 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 34

1 Overordnet beskrivelse 1.1 Integrationens formål Integration har til formål at hente indkomstdata til fagløsninger, som har forvaltningsmæssigt brug for disse data. En part (kommune) kan hente Indkomstoplysninger på alle borgere i Danmark, og er ikke begrænset til egne borgere. Indkomstoplysninger for den enkelte borger er begrænset i henhold til den tale der indgås mellem SKAT og den part der anvender servicen. Aftalen og filtreringen er baseret på det lovgrundlag, der giver parten ret til at hente data i forbindelse med en konkret sag. Det er muligt at filtrer i flere dimensioner. Indkomstoplysningerne - En række oplysningsfelter vedrørende indkomst (feltniveau, mere end 75 felter), f.eks. A-indkomst, hvor der betales AM-bidrag, Indeholdt A- skat, ATP-bidrag, Sundhedsforsikring i pensionsindskud Typer Indkomstoplysninger f.eks. Lønindkomst, Pension, SU, Ydelser mf. Indkomstindberetter liste SE-nr. for virksomheder og myndigheder, som anvendes til at begrænse udfaldsrummet. Periode Periodeangivelse som dækker Lønperioder eller Dispositionsdatoer Indkomstoplysninger fra eindkomst leveres i en generisk format, hvilket betyder, at oplysningsfelter kan tilføjes, ændres og udgå i formatet uden at selve integrationen ændres. Ændringer sker typisk på baggrund ændringer i lovgivningen om beskatning indkomst og typisk i forhold til et helt indkomstår. Advisering om ændringer i indkomstoplysninger sker almindelig vis i god tid inden ændringerne træder i krt, således at anvendere kan nå at fortage eventuelle tilpasninger abonnementstale og anvendersystem. EIndkomst har indkomstdata tilbage til 2008. Det må dog forventes at der løbende hvert år slettes et skatteår. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet forespørger på indkomstoplysninger ved kald service på Serviceplatformen, som gennemstiller kaldet fra fagsystemet til SKAT eindkomst. SKAT eindkomst svarer synkront på kaldet til Serviceplatformen, som gennemstiller kaldet fra SKAT eindkomst til fagsystemet. Integrationen er en gennemstillingsintegration. Hentes store mængder data via servicen, kan der være behov for at dele forespørgslen op, så der hente data i flere omgange. Dette kan opstå hvis der hentes indkomstdata for mange borgere samtidig, eller for en meget lang indkomstperiode eller for en borger med en meget stor mænge indkomstdata samt en kombination disse. Hentes der indkomstoplysning for samme borge skal flere gange, skal anvendersystemet kunne håndtere at modtage overlappende indkomstoplysning. Dette er enkelt at håndtere, da alle indkomstregistreringer kan unik identificeres. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 34

SKAT eindkomst Serviceplatformen Fagsystem Integrationsbeskrivelse Hent indkomstoplysninger (synkront kald) Hent indkomstoplysninger Modtag indkomstoplysninger Synkron gennemstilling Synkron gennemstilling Modtag bestilling Returner svar 1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Tidsrum Flow: Hent indkomstoplysninger Systemet driftsvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for åbningstid. Svartid Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for svartider. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 34

Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. SKAT vil ikke forpligtiger sig til at oplyse en garanteret tilgængelighed Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdage SKAT har oplyst, at der er en generel spidsbelastning eindkomst-systemer den 25. 26. i hver måned samt sidst på måneden. Servicevinduer 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 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. Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. SKAT oplyse at information om servicevinduer, kan findes på følgende link http://www.skat.dk/skat.aspx?oid=71484 og at der via denne side kan abonneres på et RSS feed. Man kan generelt finde information om driftssituationen på SKATs driftlog for Ny Driftslog for udstilling data fra eindkomst på link http://www.skat.dk/skat.aspx?oid=71484 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 Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til dataellesskab@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 denne tilgår senere. Incident Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 34

Problem Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Change Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 1.3.3 Lifecycle Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 1.4 Teststrategi Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 1.4.1 Test i forbindelse med udvikling Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Testfaciliteter og testmiljø Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Testdata Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 1.4.2 Test i forbindelse med produktionssætning Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 1.5 Tilslutning til sniftflade For at kunne anvende snitflade er det en række vilkår og forudsætninger, som skal være opfyldt en tilslutningspart, der skal tilsluttes. Ved tilslutningspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætning, som gælder på tværs snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter der skal udføreres som forudsætning for tilslutning en tilslutningspart er beskrevet for hver enkelt tilslutningspart i kapitel 2. 1.5.1 Roadmap for Implementering Nedenstående diagram viser en mulig køreplan for udrulningen et anvendersystem inden for KOMBIT rammearkitektur under monopolbrudsprojektet. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning en snitflade, som følge en udrulning et anvendersystem, vil referere til den fase, den hensigtsmæssig kan udføres i. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 34

Serviceplatformen: Ved idriftsættelse en snitflade er alle aktiviteter sluttet, og snitfladen er klar til anvendelse Kildesystem: Alle aktiviteter i forhold til serviceplatformen er slutte, men der kan være yderligere aktiviteter i forbindelse med tilslut et anvendersystem eller en kommune. Anvendersystem og kommune: Ved tilslutning et anvendersystem og eller en kommuner, er der en række aktiviteter op til idriftsættelse, dels talemæssig karakter, og dels også konfigurationsmæssig karakter. Er der aktiviteter, som medføre konfiguration på Serviceplatformen, vil dette ske i forbindelse med oprettelse myndighedens servicetalen for kommunen. 1.5.2 Særlige vilkår For at kun modtage indkomstoplysninger fra SKAT skal modtageren indgå en abonnementstale med SKAT om præcis hvilke indkomstoplysninger, der skal modtages. Abonnementstalen skal være funderet i et lovgrundlag, som give adgang til de specifikke indkomstoplysninger. 1.5.3 Supplerende information om tilslutning Bemærk at kommunens CVR-nummer stadig skal have KMD som revisor, da funktionerne i KMD Indkomst ellers ophører med at fungere. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 34

2 Kontekst for integrationsparter 2.1 Kontekst for KY (Kontanthjælp) [!@KY@!] 2.1.1 Lovhjemmel og forvaltningsmæssigt formål Der findes følgende lovhjemmel for systemets anvendelse servicen: Det anførte hjemmelsgrundlag er bestemt det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund en rimelige og dækkene analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål er at indhente oplysninger om personindtægter i forbindelse med oprettelse en sag, samt oplysning en sag. Disse er essentielle data i forbindelse med Beregningsgrundlaget, som optræder i flere dele ydelsessystemet informationsmodeller. 2.1.2 Kapacitets- og servicekrav Ydelsessystemet skal lave opslag ved oprettelse nye sager, og genopslag i forbindelse med f.eks. genoplysning sagen. Forventet volumen for integration er estimeret til 15.000 16.500 kald per måned. 2.1.3 Forudsætninger for produktionssætning integration Systemspecifikt Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et KY kan benytte snitfladen. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og hængighed Kommentar TS101 Indgåelse Dataudvekslingstale mellem SKAT og Aftale Serviceplatformen SKAT Kommune Fase 1 Det er samme -

kommuner om videregivelse data via serviceplatformen TS301 tale, som indgås i TS201 for SF0770_B, SF0770_D, SF0770_E, SF1570, SF2580, SF2585 TS102 TS103 Aftale Aftale Udarbejdelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Beslutning om kommunes SE nr. for fagsystem Anvendersystem Fase 1 Anvendersystem Fagprojekter Fagprojekter TS102 Det er samme tale, som indgås for SF0770_E Kommune Kommune Fase 1 Det er samme tale, som indgås for SF0770_B, SF0770_D, SF0770_E, SF1570 TS104 Indgåelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Fase 1 Aftale SKAT Kommune Anvendersystem TS103 og TS104 Det er samme tale, som indgås for SF0770_E TS105 Leverandør Fase 2.1 Konfigurering SKAT abonnementstale i anvendersystem Konfiguration Anvendersystem Leverandør TS104 Det er samme tale, som indgås for SF0770_E TS106 Autorisering KOMBIT som revisor Aftale SKAT tast selv Kommune Kommune Fase 2.2 TS103 Det er samme tale, som indgås for SF0770_E KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 34

TS107 Anmodning om Servicetale for SF0770_A Konfiguration Administrationsmodul Leverandør Fase 2.2? (Leverandør eller serviceplatform TS107 TS108 Godkendelse servicetale for SF0770_A Kommune Kommune Fase 2.2 Konfiguration Administrationsmodul TS108 TS101 - Hver kommune som skal have adgang til eindkomst, skal indgå en Dataudvekslingstale med SKAT om dette. SKAT vil drive og indhente godkendelsen Dataudvekslingstale med kommunerne. Kommunerne skal godkende talen. TS102 - Et anvendersystems adgang til eindkomstoplysninger, sker på baggrund en lovhjemmel. For hver lovhjemmel oprettes et abonnement i eindkomst, som anvendersystem skal benytte. Abonnement oprettes SKAT på baggrund en abonnementstale, som angive lovgrundlag, og de eindkomstoplysninger, der stilles til rådighed. Et fagsystem kan dække et eller flere fagområder. De enkelte fagområder skal være understøttet relevant lovgivning for overførelse indkomstoplysninger. Hvert fagområde vil få tilknyttet et abonnement SKAT, som dokumenterer dette lovgrundlag, som et system anvender for at hente indkomstoplysninger i en konkret sag. Datagrundlaget der specificeres i bilag 1 kan forskellig for SF0770_A og SF0770_E hensyn til den efterfølgende databehandling. TS103 - Kommune skal for hver fagsystem opgive hvilket SE-nr. som ønskes anvendt til udhentning Indkomstoplysninger. TS104 - For hvert fagsystem en kommune skal anvendes, skal der mellem SKAT og kommunen indgås en undertale til dataudvekslingstale, som angiver det specifikke datagrundlag. TS105 - Anvender system skal konfigureres med abonnementstalen her under relationer til de enkelte kommuners SE-nr. Følgende parameter skal konfigureres i anvendersystem: - AbonnentTypeKode - AbonnementTypeKode - AdgangFormaalTypeKode og den enkelte kommunes SE-nr. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 34

Såfremt datagrundlaget er forskellig i SF770_A og SF0770_E vil der indgå to stk. AbonnementTypeKode TS106 - Kommunen skal autorisere KOMBIT i forhold til revisorordningen. Dette sker via SKATs portal Tast Selv erhverv. Der logges på med et OCES medarbejdercertifikat eller virksomhedscertifikat for den pågældende kommunen. Fra en liste vælges det SE-nr, som er oprette til brug for fagsystemet. Efterfølgende vælges Autoriser revisor m. fl. til indberetning fra menuen. Ud for feltet Autoriser IT-leverandør til eindkomst angives KOMBITs CVR-nr: 19 43 50 75. Se vejledning i [WSDL-EXT]/ Autorisation revisor TS107 - Leverandøren skal anmode om indgåelse servicetale for kommunen, der skal bruge snitflade SF0770_A, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS108 - Kommune skal godkende ovenstående servicetale. 2.2 Kontekst for KSD (Sygedagpenge) [!@KSD@!] 2.2.1 Lovhjemmel og forvaltningsmæssigt formål Der findes følgende lovhjemmel for systemets anvendelse servicen: Det anførte hjemmelsgrundlag er bestemt det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund en rimelig og dækkene analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål er at indhente oplysninger om personindtægter i forbindelse med oprettelse en sag, samt oplysning en sag. Disse er essentielle data i forbindelse med Beregningsgrundlaget, som optræder i flere dele sygedagpengesystemets informationsmodeller. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 34

2.2.2 Kapacitets- og servicekrav Sygedagpengesystemet skal lave opslag ved oprettelse nye sager, og genopslag i forbindelse med f.eks. genoplysning sagen. Der forventes max. 85.000 opslag per måned. 2.2.3 Forudsætninger for produktionssætning integration Systemspecifikt Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et KSD kan benytte snitfladen. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og hængighed Kommentar TS201 Aftale SKAT Kommune Fase 1 Indgåelse Dataudvekslingstale mellem SKAT og kommuner om videregivelse data via serviceplatformen Serviceplatformen TS301 Det er samme tale, som indgås som indgås i TS101 for SF0770_B, SF0770_D, SF0770_E, SF1570, SF2580, SF2585 TS202 TS203 Aftale Aftale Udarbejdelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Beslutning om kommunes SE nr. for fagsystem Anvendersystem Fase 1 Anvendersystem Fagprojekter Fagprojekter TS202 Det er samme tale, som indgås for SF0770_E Kommune Kommune Fase 1 Det er samme tale, som indgås for SF0770_B, SF0770_D, SF0770_E, SF1570, TS204 Indgåelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Fase 1 Aftale SKAT Kommune Anvendersystem TS103 Det er samme tale, som indgås for SF0770_E KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 34

og TS104 TS205 Leverandør Fase 2.1 Konfiguration SKAT abonnementstale i anvendersystem Konfiguration Anvendersystem Leverandør TS105 Det er samme tale, som indgås for SF0770_E TS206 Autorisering KOMBIT som revisor Aftale SKAT tast selv Kommune Kommune Fase 2.2 TS106 Det er samme tale, som indgås for SF0770_E TS207 Anmodning om Servicetale Konfiguration Administrationsmodul Leverandør Fase 2.2? (Leverandør eller serviceplatform TS107 TS208 Godkendelse servicetale Konfiguration Administrationsmodul Kommune Kommune Fase 2.2 TS108 TS201 - Hver kommune som skal have adgang til eindkomst, skal indgå en Dataudvekslingstale med SKAT om dette. SKAT vil drive og indhente godkendelsen Dataudvekslingstale med kommunerne. Kommunerne skal godkende talen. TS202 - Et anvendersystems adgang til eindkomstoplysninger, sker på baggrund en lovhjemmel. For hver lovhjemmel oprettes et abonnement i eindkomst, som anvendersystem skal benytte. Abonnement oprettes SKAT på baggrund en abonnementstale, som angive lovgrundlag, og de eindkomstoplysninger, der stilles til rådighed. Et fagsystem kan dække et eller flere fagområder. De enkelte fagområder skal være understøttet relevant lovgivning for overførelse indkomstoplysninger. Hvert fagområde vil få tilknyttet et abonnement SKAT, som dokumenterer dette KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 34

lovgrundlag, som et system anvender for at hente indkomstoplysninger i en konkret sag. Datagrundlaget der specificeres i bilag 1 kan forskellig for SF0770_A og SF0770_E hensyn til den efterfølgende databehandling. TS203 - Kommune skal for hver fagsystem opgive hvilket SE-nr. som ønskes anvendt til udhentning Indkomstoplysninger. TS204 - For hvert fagsystem en kommune skal anvende, skal der mellem SKAT og kommunen indgås en undertale til dataudvekslingstale, som angiver det specifikke datagrundlag. TS205 - Anvender system skal konfigureres med abonnementstalen her under relationer til de enkelte kommuners SE-nr. Følgende parameter skal konfigureres i anvendersystem: - AbonnentTypeKode - AbonnementTypeKode - AdgangFormaalTypeKode og den enkelte kommunes SE-nr. Såfremt datagrundlaget er forskellig i SF770_A og SF0770_E vil der indgå to stk AbonnementTypeKode TS206 - Kommunen skal autorisere KOMBIT i forhold til revisorordningen. Dette sker via SKATs portal Tast Selv erhverv. Der logges på med et OCES medarbejdercertifikat eller virksomhedscertifikat for den pågældende kommunen. Fra en liste vælges det SE-nr, som er oprette til brug for fagsystemet. Efterfølgende vælges Autoriser revisor m. fl. til indberetning fra menuen. Ud for feltet Autoriser IT-leverandør til eindkomst angives KOMBITs CVR-nr: 19 43 50 75. Se vejledning i [WSDL-EXT]/ Autorisation revisor Registreringen revisorordning for Erhvervssystem for SF2580 sker samme sted. TS207 - Leverandøren skal anmode om indgåelse servicetale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS208 - Kommune skal godkende ovenstående servicetale. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 34

2.3 Kontekst for Ydelsesrefusion [!@YR@!] 2.3.1 Lovhjemmel og forvaltningsmæssigt formål Adgang til oplysninger i indkomstregistret sker med hjemmel i Retssikkerhedsloven 11a stk 3, jf. stk 1+2 og 11c Lov om kommunernes finansiering visse offentlige ydelser udbetalt kommunerne, Udbetaling Danmark og arbejdsløshedskasserne 12 Det forvaltningsmæssige formål er at samle informationer om de offentlige forsørgelsesydelser, automatisk hjemtage kommunens refusioner fra staten, regne kommunens egen medfinansiering og ikke mindst håndtere tællerne for den enkelte borgers ydelser. Som en del beregningerne i Ydelsesrefusion er det nødvendigt at kende til den virksomhedsindberettede løn for borgere på Ydelsen Løntilskud. Indberetning om udbetaling ydelsen kommer fra kommunerne via eindkomst i den månedlige proces for Ydelsesrefusion, men virksomhedernes indberetning lønnen kommer forskudt ift den månedlige proces, hvorfor et opslaget med IndkomstOplysningPersonHent servicen er nødvendig. 2.3.2 Kapacitets- og servicekrav Ydelsesrefusion skal lave opslag en borgers indkomst i forbindelse med et ansættelse, hvor der er udbetaling løntilskud. Der forventes max. 10.000 opslag per måned. 2.3.3 Forudsætninger for produktionssætning integration Systemspecifikt Dette kapitel beskriver de opgaver, som skal gennemføres SKAT i relation til snitfladen, for at en integrationspart kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og hængighed Kommentar TS401 Aftale SKAT Fase 1 Indgåelse Dataudvekslingstale mellem SKAT og Ydelsesrefusion om videregivelse data via serviceplatformen Serviceplatformen Ydelsesrefusion TS301 Det er samme tale, som indgås for SF0770_E TS401 TS402 Udarbejdelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Aftale Fase 1 Anvendersystem Ydelsesrefusion Ydelsesrefusion TS102 Det kan være en del samme tale, som indgås for SF0770_E TS402 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 34

TS403 Aftale Beslutning om SE nr. for Ydelsesrefusion Anvendersystem Ydelsesrefusion Ydelsesrefusion Fase 1 Samme SEnr. kan anvendes i SF0770_E TS403 TS404 TS405 Indgåelse Abonnementstale om adgang til eindkomst (bilag 1 og tilhørende underbilag til dette) Konfiguration SKAT abonnementstale i Ydelsesrefusion Fase 1 Aftale SKAT Ydelsesrefusion Ydelsesrefusion TS403 Fase 2.1 Konfiguration Anvendersystem Leverandør Ydelsesrefusion Leverandør Ydelsesrefusion TS105 Samme abonnemtstale som SF0770_E TS403 Samme opgave som i SF0770_E TS405 TS406 Anmodning om Servicetale Fase 2.2 Konfiguration Administrationsmodul Leverandør Ydelsesrefusion Leverandør Ydelsesrefusion TS107 TS407 Godkendelse servicetale Fase 2.2 Konfiguration Administrationsmodul Ydelsesrefusion Ydelsesrefusion TS108 TS401 - Ydelsesrefusion skal indgå en databehandlertale med SKAT om dette. SKAT vil drive og indhente godkendelsen Dataudvekslingstale med kommunerne. Kommunerne skal godkende talen. TS402 - Ydelsesrefusions adgang til eindkomstoplysninger, sker på baggrund en eller flere lovhjemler. For hver lovhjemmel oprettes et abonnement i eindkomst, som anvendersystem skal benytte. Abonnement oprettes SKAT på baggrund en abonnementstale, som angive lovgrundlag, og de eindkomstoplysninger, der stilles til rådighed. Et fagsystem kan dække et eller flere fagområder. De enkelte fagområder skal være understøttet relevant lovgivning for overførelse indkomstoplysninger. Hvert fagområde vil få tilknyttet et abonnement SKAT, som dokumenterer dette lovgrundlag, som et system anvender for at hente indkomstoplysninger i en konkret sag. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 34

Datagrundlaget der specificeres i bilag 1, kan forskellig for SF0770_A og SF0770_E hensyn til den efterfølgende databehandling. TS403 - Ydelsesrefusion skal opgive hvilket SE-nr. som ønskes anvendt til udhentning Indkomstoplysninger. TS404 - SKAT og Ydelsesrefusion skal indgå en undertale til dataudvekslingstale, som angiver det specifikke datagrundlag, som skal udstilles eindkomst. TS405 - Ydelsesrefusion skal konfigureres med abonnementstalen her under relationer til Ydelsesrefusions SE-nr. Følgende parameter skal konfigureres i anvendersystem: - AbonnentTypeKode - AbonnementTypeKode - AdgangFormaalTypeKode og Ydelsesrefusions SE-nr: 34199736. Såfremt datagrundlaget er forskellig i SF770_A og SF0770_E vil der indgå to stk AbonnementTypeKode TS406 - Leverandøren skal anmode om indgåelse servicetale på vegne Ydelsesrefusion i rammearkitekturens administrationsmodul, og Ydelsesrefusion skal godkender denne anmodning jf. Vilkår for anvendelse sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS407 - Ydelsesrefusion skal godkende ovenstående servicetale. 2.4 Kontekst for SKAT [!@SKAT@!] 2.4.1 Lovhjemmel og forvaltningsmæssigt formål Ikke relevant 2.4.2 Kapacitets- og servicekrav Ikke oplyst. 2.4.3 Forudsætninger for produktionssætning integration Systemspecifikt Dette kapitel beskriver de opgaver, som skal gennemføres SKAT i relation til snitfladen, for at en integrationspart kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og hængighed Kommentar KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 34

TS301 Udarbejdelse skabelon for dataudvekslingstale mellem SKAT og kommuner om videregivelse data via serviceplatformen Aftale KOMBIT SKAT SKAT Fase 1 Det er samme tale, som også indgås for SF0770_B, SF0770_D, SF0770_E, SF1570, SF2580, SF2585 TS301 - SKAT skal udarbejde en dataudvekslingstale til brug for kommunernes tilslutning under revisorordning og lønservicebureau til eindkomst via KOMBITs serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 34

3 Specifikation for integrationsparter 3.1 Specifikation endpoints for KY+KSD Integrationen benyttes ydelsessystemet, sygedagpengesystemet og sagsoverblik/partskontaktløsningen (fagsystemerne) til at hente indkomstoplysninger fra SKAT eindkomst for en eller flere personer til brug for sagsbehandling og kontrol. Fagsystemerne kalder Serviceplatformen, som udstiller en synkron service, der udstiller indkomstoplysninger for en eller flere personer. 3.1.1 Overordnet forretningslogik Serviceplatformen udstiller en synkron service, der udstiller indkomstoplysninger for en eller flere personer (svarende til SKAT eindkomst): 1. Fagsystemet kalder EP_FS1 IndkomstoplysningerLaes på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet (Synkront kald) 3.1.2 Oversigt over endpoints ID Navn EP_FS1 IndkomstoplysningerLaes 3.1.3 Beskrivelse endpoint EP_FS1- IndkomstoplysningerLaes Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatformen udstiller service IndkomstoplysningerLaes Operationer: - Laes Henter indkomstoplysninger for en eller flere personer 3.1.3.1.2 Serviceanvender Fagsystemet er serviceanvender. 3.1.3.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS. 3.1.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger. Reference til wsdl [WSDL-SP]/resources/SKATForwardEIndkomstService.wsdl Operationer inkluderet er som angivet i snit 3.1.2. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 34

Servicenavn på Serviceplatformen Version på Serviceplatformen Servicen ligger under navnet EIndkomst Gældende version ift. denne integrationsbeskrivelse er 1. 3.1.3.1.5 Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen med søgeparametre for at modtage indkomstoplysninger retur. 3.1.3.1.6 Dataretning for udveksling Indkomstoplysninger (lønindberetninger mv.) modtages fagsystemet fra Serviceplatformen (SKAT). 3.1.3.1.7 Service invokation / Triggers Kommunikation initieres, at fagsystemet udsteder et kald til Serviceplatformen. Dataspecifikation Da der er tale om en gennemstillingsintegration svarer dataspecifikationen for servicen til dataspecifikationen i schema-filerne udstillet SKAT: Miljø: Produktion Inputdata Outputdata [WSDL-SP]/XSD [WSDL-SP] /XSD Der henvises til følgende dokument udstillet SKAT for yderligere oplysninger om dataelementer og valideringer: http://85.81.229.78/systems/eskatdata%20(hentselv)/arkiv/hent- Selv20131217/IndkomstOplysningPersonHent_v1.1_20131219.docx, men dokumentet er også vedlagt i [WSDL-EXT] Valideringer fremgår ovennævnte dokument og/eller WSDL defineret i snit 3.1.3.1.4. Vedrørende abonnementsopsætning gælder det at 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 tales for hver abonnement. Eksempler på værdier for elementerne er vist nedenfor, og det kan forventes at fremtidige værdier vil ligne: AbonnentTypeKode 0850 AbonnementTypeKode 3153 AdgangFormaalTypeKode 201 (Dagpenge ved sygdom) KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 34

Ovenstående koder kan sammen med SE-nr. 34 19 39 83 anvendes i ekstern test på serviceplatformen. Resultatet indeholder en list de borgere, som der forespørges på. For hver borger kan der være en eller flere sæt indkomstoplysning, disse er identificeret ved følgende nøglefelter: PersonCivilRegistrationIdentifier SEnummerIdentifikator (IndberetningPligtigVirksomhed) AngivelseVirksomhedEgenIdentifikator AngivelsePeriode, StartDate AngivelsePeriode, EndDate IndkomstPersonGruppeDispositionDato (elementet kan være udfyldt) Se [WSDL-EXT] - TilslutningVejledning.zip dokument 20090702 SøgePeriodeFlereEnsIndkomstOplysninger.doc De egentlige indkomstdata følger efter i en hierarkisk struktur blanketter med et antal felter. Hvilke blanketter og felter gøres den tale der er indgået med skal. Types vil det følgende 3 blanketter: 11000 - Generelle indkomstoplysninger 16000 - Generelle oplysninger for indkomstmodtager 16001 Indkomstoplysninger Et overblik over alle blanketter og felter, som der kan abonneres på findes i [UBB1] Sammenstilles indkomstdata fra flere kald på samme borger, skal det modtagne anvendersystemhåndtere indkomstdata, så der ikke er dubletter indkomstdata. Ovenstående nøglefelter som identificerer et sæt indkomstoplysninger kan benyttes til at sikre at der kun er en forekomst et sæt indkomstdata. Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed]. Bemærk at kommunerne vil tilgå servicen via et token, som trækkes med baggrund i kommunens CVR-nr., mens Ydelsesrefusion vil tilgå servicen med KOMBITs CVR-nr. I selve snitfladen skal fagsystem stadig angive det SE-nr, som der er angivet i den abonnementstale, som er indgået mellem SKAT og den relevante myndighed/juridisk ansvarlig. Leverancesikkerhed og fejlhåndtering Der er tale om en simple synkron service, som er idempotent At least once. Såfremt kaldet fejler, skal det kaldende system foretage et nyt kald. Der er tale om basal fejlhåndtering, hvor fagsystemet skal kunne håndtere følgende fejlsituationer: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 34

Fejlhåndtering (EP_FS1) # - Fejl type Håndtering 1. - Ingen forbindelse pga. manglende netværk, forkert endpoint, manglende eller forkert certifikat, manglende eller forkert opsætning i STS, opsætning firewalls. Fagsystem kalder Serviceplatformen igen, da kaldet er idempotent. Ved gentagende fejl reporteres fejlen i henhold til det, der er beskrevet i kapitel 1.3.2 Service Management. 2. - Timeout Se ovenfor. 3. - XML er ikke valid Serviceplatformen returnerer fejlbesked til fagsystemet. 4. - Skat returnere semantiske eller forretningsmæssige fejl. Serviceplatformen returnerer fejlbesked til fagsystemet. Servicemål Følgende undersnit indeholder oplysninger vedrørende servicemål for talt driftstid. 3.1.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsvikles 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 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. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 34

3.1.4 Service Management Incident Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Problem Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Change Management Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 3.1.5 Testplan Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 3.2 Specifikation endpoints for SKAT eindkomst Integrationen benyttes Serviceplatformen til at hente indkomstoplysninger fra SKAT eindkomst for en eller flere personer. SKAT eindkomst udstiller en synkron service, der udstiller indkomstoplysninger for en eller flere personer. 3.2.1 Overordnet forretningslogik SKAT eindkomst udstiller en synkron service, der udstiller indkomstoplysninger for en eller flere personer. 3.2.2 Oversigt over endpoints ID Navn EP_ SK1 Læs SKAT indkomstoplysninger KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 34

3.2.3 Beskrivelse endpoint EP_SK1 Læs SKAT indkomstoplysninger Transportspecifikation 3.2.3.1.1 Serviceudstiller SKAT eindkomst udstiller servicen IndkomstOplysningPersonHent. Operationer: - getindkomstoplysningpersonhent Returnerer synkront indkomstoplysninger for en eller flere personer 3.2.3.1.2 Serviceanvender Serviceplatformen er serviceanvender. 3.2.3.1.3 Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS. 3.2.3.1.4 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn http://85.81.229.78/services/prod/eindkomst/wsdl/ services.extranet.skat.dk Endpoint IP 147.29.150.165 Miljø: Test URI til WSDL Endpoint navn http://85.81.229.78/services/demo/eindkomst/wsdl/ services.extranet.demo.skat.dk Endpoint IP 147.29.75.55 3.2.3.1.5 Teknisk retning for udveksling Serviceplatformen foretager synkront kald til SKAT eindkomst. 3.2.3.1.6 Dataretning for udveksling SKAT eindkomst leverer indkomstdata til Serviceplatformen. 3.2.3.1.7 Service invokation / Triggers Kommunikation initieres servicekald mod SKAT eindkomst fra Serviceplatformen. Dataspecifikation Dataspecifikationen for servicen findes i følgende schema-filer udstillet SKAT: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 34

Miljø: Produktion Inputdata Outputdata http://85.81.229.78/services/prod/eindkomst/view/indkomstoplysningpersonhent_itype.xsd http://85.81.229.78/services/prod/eindkomst/view/indkomstoplysningpersonhent_otype.xsd Miljø: Test Inputdata Outputdata http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningpersonhent_itype.xsd http://85.81.229.78/services/demo/eindkomst/view/indkomstoplysningpersonhent_otype.xsd Der henvises til følgende dokument udstillet SKAT for yderligere oplysninger om dataelementer og valideringer: http://85.81.229.78/systems/eskatdata%20(hentselv)/arkiv/hentselv20131217/indkomstoplysningpersonhent_v1.1_20131219.docx Valideringer fremgår ovennævnte dokument og/eller wsdl defineret i snit 3.2.3.1.4. Der henvises til følgende side hos SKAT, hvor der findes en udvikler-wiki med yderligere detaljer: http://85.81.229.78/wiki/tiki-index.php Sikkerhed Både test- og produktionsmiljøet anvender SSL med VeriSign SSL-certifikater. Klientprogrammet identificerer sig over for SKAT med et OCES Virksomhedscertifikat. For de enkelte miljøer skal disse være udstedt følgende CA er: Miljø Certificate Authority Test TDC OCES Systemtest CA 2 Produktion TDC OCES CA Nedenstående tegning viser det overordnede koncept: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 34

SOAP Body signeret med forbrugerens certifikat SOAP Header med Userid Serviceplatformen: OIO webservice-klient SKAT OIO grænseflade OIO service SOAP response SOAP Body signeret med SKATs certifikat Message log TDC spærreliste Klient keystore Aftaler Server keystore Internt i SKAT Serviceplatformen danner OIO request og signerer SOAP body med KOMBITs virksomhedscertifikat. Serviceplatformens klient keystore skal indeholde KOMBITs OCES virksomhedscertifikat og DanId OCES root certifikat. SKATs server sikrer, at certifikatet er gyldigt, og at der findes en gyldig tale med SKAT. SKAT-serverens keystore indeholder SKATs virksomhedscertifikat og DanId OCES root certifikat. SKATs taledatabase validerer adgang til servicen. SKATs server kalder videre internt til SKAT OIO-servicen med CVR-nummer som userid i SOAP header. SKATs server modtager svar fra OIO servicen SKATs server signerer svaret med SKATs virksomhedscertifikat. Klienten på Serviceplatformen modtager svaret og validerer SKATs signatur op imod DanId OCES root certifikatet Leverancesikkerhed og fejlhåndtering Der er tale om en simple synkron service, som er idempotent At least once. Såfremt kaldet fejler, skal serviceplatformen videreformidle denne fejl til fagsystemet. Der er tale om basal fejlhåndtering, hvor fagsystemet skal kunne håndtere følgende fejlsituationer: Fejlhåndtering (EP_SK1) # - Fejl type Håndtering 1. - Ingen forbindelse pga. manglende netværk, forkert endpoint, manglende eller Serviceplatformen returnerer KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 34

forkert certifikat, manglende eller forkert opsætning i STS, opsætning firewalls. Ved gentagende fejl reporteres fejlen i henhold til det, der er beskrevet i kapitel 1.3.2 Service Management. 2. - Timeout Se ovenfor. 3. - XML er ikke valid Serviceplatformen returnerer fejlbesked til fagsystemet. 4. - Valideringsfejl hos SKAT I tilfælde valideringsfejl hos SKAT, vil årsagen (fejlkoden) fremgå retursvaret, der modtages på Serviceplatformen. Disse videresendes direkte tilbage til det kaldende fagsystem. I tilfælde valideringsfejl hos SKAT, vil årsagen (fejlkoden) fremgå retursvaret, der modtages på Serviceplatformen. Disse videresendes direkte tilbage til det kaldende fagsystem. I tilfælde fejl / timeout i kommunikationen med SKAT vil Serviceplatformen informere det kaldende fagsystem med angivelse fejlen. Da der er tale om en forespørgsel, der kan kaldes gentagne gange for samme person, vil fagsystemet selv være ansvarlig for at kalde igen. Servicemål Følgende undersnit indeholder oplysninger vedrørende servicemål for talt driftstid. 3.2.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for åbningstid. SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for svartider. SKAT vil ikke forpligtiger sig til at oplyse en garanteret tilgængelighed SKAT har oplyst, at der er spidsbelastningsperiode den 25. 26. i hver måned samt sidst på måneden. SKAT oplyse at information om servicevinduer, kan findes på følgende link http://www.skat.dk/skat.aspx?oid=71484 og at der via denne side kan abonneres på et RSS feed. Man kan generelt finde information om driftssituationen på SKATs driftlog for Ny Driftslog for udstilling data fra eindkomst på link http://www.skat.dk/skat.aspx?oid=71484 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 34

3.2.4 Service Management [Afklaring/KDF: Link til driftslog med varsling servicevinduer mv.: https://www.skat.dk/skat.aspx?oid=1745905] Ikke oplyst. Ikke oplyst. Ikke oplyst. 3.2.5 Testplan Incident Management Problem Management Change Management Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende tale for Serviceplatformen. 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende snit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes flere integrationsflow, som vil være beskrevet hver for sig i nærværende snit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående snit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 34

Fagsystem Integrationsbeskrivelse EP_FS1 Serviceplatformen IF01 Forespørg indkomstoplysninger EP_SK1 SKAT eindkomst 4.1.1 Oversigt over integrationsflows ID Navn IF01 Forespørg indkomstoplysninger 4.1.2 Integrationsflow IF01: Forespørg indkomstoplysninger Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 IndkomstoplysningerLaes Afsnit 3.1 EP_SK1 Læs SKAT indkomstoplysninger Afsnit 3.2 Integrationstype Gennemstillingsintegration. Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatform SKAT eindkomst Synkront kald for hent indkomst SP viderestiller kald til SKAT SKAT returnerer resultat SP returnerer data til FS EP_FS1 EP_SK1 Sekvens: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 34

1. Fagsystem (FS) kalder Serviceplatformen (SP) med søgeparametre (synkront kald) 2. SP validerer skemaet og returnerer eventuel valideringsfejl til FS (se punkt 6.) 3. SP viderestiller kald med søgeparametre til SKAT eindkomst (synkront kald) 4. SKAT returnerer synkront svar på forespørgslen til SP i servicekaldets returparameter 5. SP viderestiller svaret fra SKAT eindkomst til FS. I tilfælde timeout, genererer SP retursvaret 6. SP returnerer svaret til FS i servicekaldets returparameter Ingen krav. Ingen krav. Ingen krav. Ingen krav. Ingen krav. Datatransformering Datapersistering Databerigelse Routing Orkestrering Sikkerhed Sikkerheden baseres på to selvstændige trusts: - Serviceplatform og fagsystemerne (ydelsessystemet og sygedagpengesystemet) - Serviceplatform og kildesystem Serviceplatformen skal sikre, at det kun er godkendte fagsystemter inkl. dataejere, som kan anvende servicen. Der er ingen krav til delegering mellem de to trusts. Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. Testdata og testfaciliter [Indhold venter generel klaring test] Ingen krav. Konfiguration KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 34

Supplerende information Ingen supplerende information. 4.1.3 Tilslutning til integrationspart: Serviceplatformen Dette kapitel liste de forudsætninger, som skal være opfyldt for at Serviceplatformen kan udstille den pågældende snitflade. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og hængighed Kommentar TSP01 Tilmelding KOMBIT til revisorordning hos SKAT Aftale Serviceplatformen KDF KDF Fase 1 Aftale er indgået Det er samme tale, som indgås for: SF0770_E TSP02 KOMBITs CVR nr. oprettes hos SKAT Sikkerhed SKAT Serviceplatformen Serviceplatformen Fase 1 Det er samme certifikat, som anvendes for: SF0770_B, SF0770_D og SF0770_E TSP03 TSP04 Registrering Service og IT system i STS Organisation Registrering Serviceinformation Konfiguration STS Organisation Serviceplatformen Serviceplatformen Konfiguration Serviceplatformen Serviceplatformen Serviceplatformen Fase 1 Fase 1 TSP01 - KOMBIT skal via Tast-selv erhverv registrerer sig til revisorordning. Dette sker ved at KOM- BIT registrerer de services, som skal anvendes i forhold til at hente eindkomstoplysningerne. Der er ikke tale om en egentlig registrering KOMBIT, som revisor. I [WSDL-EXT]/ 20141020 Pixi - OpretAftaleOmAdgangViaServicegrænseflade.doc findes SKATs vejledning. Følgende services skal markeres: - IndkomstOplysningKlassiskAbonnentHent (SF0770_E) - IndkomstOplysningPersonAbonnementAjourfør (SF0770_E) - IndkomstOplysningPersonHent (SF0770_A) KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 33 34

TSP02 - Til brug for adgang til eindkomst produktionssystemet skal Serviceplatformen benytte et OCES Virksomhedscertifikat (TDC OCES CA), som udstedes KOMBIT (cvr 19435075). CVR-nr skal være registreret hos SKAT for at opnå adgang for webservices. TSP03 - Kildesystem skal oprettes eller kan allerede være oprettet i STS Organisation, og webservicen for IndkomstOplysningPersonHent til kildesystemet skal registreres, som et endpoint til Kildesystem, så dette kan anvendes i en servicetale. Ligeledes skal servicen IndkomstoplysningerLaes være registreret som endpoint til Serviceplatformen i STS Organisation, så dette kan anvendes i en servicetale. TSP04 - Der skal registres information vedrørende servicen i serviceplatformen, så der kan oprettes servicetaler for kommunerne, bl.a. skal logiske og fysiske endpoint skal være relateret. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 34 34