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

Transkript

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

2 Versionshistorik Relevans Dato Initialer Version Kommentarer MHO 0.1 Første version MHO 0.2 Indsat i ny template JJN 2.0 Referencerettelser mm EHE 2.1 Teknisk beskrivelse godkendt JJN 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 JJN 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 JJN Alle referencer til SAPA er slettet Forudsætninger og vilkår ændret: - Kapitel Kapitel relevant for KY - Kapitel relevant for KSD - Kapitel Relevant for Serviceplatformen Identifikation indkomstoplysning (Dublethåndtering) - Kapitel 1.2, Der er lagt supplerende materiale til bilag, herunder et eksempel på en abonnementstale JJN I Kapitel 1 er der tilføjet en tekst, som gør opmærksom på at format indkomstdata ændre sig over tid. Kapitel er det præciseret at der skal indgås en abonnementstale med SKAT for at kunne benytte servicen JJN 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 København S CVR Side 2 37

3 Kapitel 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 JJN Kapitel 1 er opdateret med retningslinjer for opslag på bagrung batchopslag JJN Kapitel Dataspecifikation: pga. lovgivningsændring for eindkomst er datagrundlaget ændret. Ændringerne er beskrevet i kapitlet. Ligeledes er der tilføjet nye talebilag for abonnementstale XEHL Opdateret reference [WSDL-SP] med teknsik specifikation inkluderende LBSB, opdateret endpoint-oversigt i snit Referencer Ref Titel Kommentarer [SPref] Note vedrørende servicemål for Serviceplatformen [SIKKERHED] Use cases for brug sikkerhedsmodeller på Serviceplatformen v Kun relevant for leverandøren til serviceplatformen Se link [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 Integrationsbeskrivelsen refererer til SF0770_A Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link Integrationsbeskrivelsen refererer til SF0770_A Bilag zip som indeholder materiale i forbindelse med eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link 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: UnderBilag Bilag 1 - SkabelonVersion 1.37.xlsx KOMBIT A/S Halfdansgade København S CVR Side 3 37

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning til sniftflade Kontekst for integrationsparter Kontekst for KY (Kontanthjælp) [!@KY@!] Kontekst for KSD (Sygedagpenge) [!@KSD@!] Kontekst for Ydelsesrefusion [!@YR@!] Kontekst for SKAT [!@SKAT@!] Specifikation for integrationsparter Specifikation endpoints for KY+KSD Specifikation endpoints for SKAT eindkomst Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 4 37

5 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 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 København S CVR Side 5 37

6 SKAT eindkomst Serviceplatformen Fagsystem Integrationsbeskrivelse Servicens er ikke beregnet til at et anvendersystem kan foretage opslag i forbindelse med batchvikling, såfremt man har behov for dette, skal man dels begrænse hyppigheden kald til servicen, sådan ikke stresse, samt ligge denne kald i ydretimerne ( ). Såfremt man har et stort behov for batchorienteret opslag vil det være nødvendigt at overveje andre mulige løsninger. Hent indkomstoplysninger (synkront kald) Hent indkomstoplysninger Modtag indkomstoplysninger Synkron gennemstilling Synkron gennemstilling Modtag bestilling Returner svar 1.3 Servicebetingelser for den samlede integration 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 KOMBIT A/S Halfdansgade København S CVR Side 6 37

7 Mellem = 1,5 sekund Kompleks = 4 sekunder SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for svartider. 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 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 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 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: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse denne tilgår senere. KOMBIT A/S Halfdansgade København S CVR Side 7 37

8 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 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 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 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 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, KOMBIT A/S Halfdansgade København S CVR Side 8 37

9 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. 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 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 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 København S CVR Side 9 37

10 2 Kontekst for integrationsparter 2.1 Kontekst for KY (Kontanthjælp) 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 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 kald per måned 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 -

11 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 København S CVR Side 11 37

12 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 København S CVR Side 12 37

13 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: 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@!] 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 København S CVR Side 13 37

14 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 opslag per måned 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 København S CVR Side 14 37

15 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 København S CVR Side 15 37

16 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: 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 København S CVR Side 16 37

17 2.3 Kontekst for Ydelsesrefusion 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 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 opslag per måned 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 København S CVR Side 17 37

18 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 København S CVR Side 18 37

19 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: 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@!] Lovhjemmel og forvaltningsmæssigt formål Ikke relevant Kapacitets- og servicekrav Ikke oplyst 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 København S CVR Side 19 37

20 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 København S CVR Side 20 37

21 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 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) Oversigt over endpoints ID Navn Reference til wsdl* Servicenavn på Serviceplatformen** Version på Serviceplatformen*** EP_FS1 Indkomstoplysninger- Laes [WSDL- SP]/wsdl/token/ EIndkomstService.wsdl eindkomst 3.0 Servicenavn: SKATForwardE- IndkomstService Operationsnavn: IndkomstoplysningerLaes * Referencen [WSDL-SP] findes i referencelisten i starten dette dokument, og i referencelisten henviser til entydig version referencen. ** Servicenavn refererer til det navn man kan finde servicen under på Serviceplatformens administrationsside (i relevant miljø). *** Version referer til den version servicen på Serviceplatformens administrationsside, som denne integrationsbeskrivelse omhandler. KOMBIT A/S Halfdansgade København S CVR Side 21 37

22 3.1.3 Beskrivelse endpoint EP_FS1- IndkomstoplysningerLaes Transportspecifikation Serviceudstiller Serviceplatformen udstiller service IndkomstoplysningerLaes Operationer: - Laes Henter indkomstoplysninger for en eller flere personer Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS Teknisk endpoint Endpointoplysning er angivet i tabellen i snit Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen med søgeparametre for at modtage indkomstoplysninger retur Dataretning for udveksling Indkomstoplysninger (lønindberetninger mv.) modtages fagsystemet fra Serviceplatformen (SKAT) 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: Selv /IndkomstOplysningPersonHent_v1.1_ docx, men dokumentet er også vedlagt i [WSDL-EXT] KOMBIT A/S Halfdansgade København S CVR Side 22 37

23 Valideringer fremgår ovennævnte dokument og/eller WSDL defineret i snit 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) Ovenstående koder kan sammen med SE-nr 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 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: Generelle indkomstoplysninger Generelle oplysninger for indkomstmodtager 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. KOMBIT A/S Halfdansgade København S CVR Side 23 37

24 Indkomstoplysninger fra SKAT leveres i et dynamisk format, som der kan tilføjes, ændres eller slettes dataelementer uden at integration faktisk ændres. Generelt sker ændringer på baggrund ændringer i grundlaget for eindkomst, og ofte i god tid før i ikrttrædelse. Anvendersystemerne skal tage stilling om disse ændringer gør, at der skal ændre i den abonnementstale, som er indgået med SKAT. Anvenderprojekterne har alle indgået tale under følgende talebilag: Bilag 1 nr Y SkabelonVersion 1.21.docx UnderBilag Bilag 1 - SkabelonVersion 1.27.xlsx Der kan være benytte andre versioner talebilag, men dette ændre ikke ved datagrundlaget, så længe nedenstående nye talebilag ikke er benyttet. Som følge ny lovgivning mm. ændres, der i de oplysninger, der indberettes til eindkomst. Dette kan betyde, at abonnementstale om adgang til eindkomst Udstilling skal udvides, hvis der har brug for de nye oplysninger. En ny eventuel ny tale skal indgås i følgende talebilag: Bilag 1 nr Y v SkabelonVersion 1.23.docx UnderBilag Bilag 1 - nr 1 v SkabelonVersion 1.37.xlsx Alle fire talebilag kan findes i [WSDL-EXT]. Nedenfor er ændringer beskrevet: Ændring felt: Blanket Felt : IndkomstType - (Opdateres i Bilag 1) Feltbeskrivelse: Koden angiver, om efterfølgende personindberetninger er almindelige lønansatte eller om de vedrører personer under reglerne for arbejdsudleje, grønlands skat, samt beskæftigelsestype mv Ændring Ny indkomsttype med værdien Udbetaling indkomst fra Arbejdsmarkedets Fond for Udstationerede lønmodtagere. Nyt felt: Blanket Felt : RUT-nr. på udenlandsk arbejdsgiver vedr. AFU - (Opdateres i Underbilag 1) Feltbeskrivelse: RUT-nr. - indberettet ved udbetaling indkomst fra Arbejdsmarkedets Fond for Udstationerede lønmodtagere Ændring: Nyt felt KOMBIT A/S Halfdansgade København S CVR Side 24 37

25 Erstatning felt: Blanket Felt : Bruttoløn (bruttoindkomst) - (Opdateres i Underbilag 1) Feltbeskrivelse: Udregnes således: A-indkomst både med og uden AM-bidrag + lønmodtagerens andel arbejdsgiveradministreret pensionsordning og ATP. Ændring: Feltet udgår og erstattes Blanket Felt Lønmodtagers pensionsandel Blanket Felt Arbejdsgivers pensionsandel Beregning bruttoløn i fremtiden 2) Bruttoindkomstbeløn kan i fremtiden tilnærmelsesvis udregnes som summering følgende felter: A-indkomst, hvor der betales AM-bidrag A-indkomst hvor der ikke betales AM-bidrag 1/3 del ATP-bidrag Lønmodtagers pensionsandel Arbejdsgivers pensionsandel Der står 'tilnærmelsesvis', da arbejdstagers egen andel ATP ikke altid er præcis 1/3 det samlede ATP i Man kan med fordel benytte feltet , da dette indeholder 1/3-del det ATP-beløb borgeren eget ATP beløb. Bemærkning: KY abonnere på dette felt, mens det ikke ser ud til at KSD benytter feltet. Nyt felt: Blanket Felt : Ingen forhold mellem løn og timer - (Opdateres i Underbilag 1) Feltbeskrivelse: Erstatter indberetning 9-taller under BlanketFeltNummer løntimer KOMBIT A/S Halfdansgade København S CVR Side 25 37

26 Ændring: Se ovenstående Nyt felt: Blanket Felt : Lønmodtager - eget ATP-bidrag - (Opdateres i Underbilag 1) Feltbeskrivelse: Beløbet udgør 1/3-del det ATP-beløb, der findes under BlanketFeltNummer ATP-bidrag Ændring: Nyt felt Ændring felt: Blanket Felt : Indkomstart - (ingen opdatering tale) Feltbeskrivelse: Indtægtsarten angiver arten en indkomstoplysning, eksempelvis angiver indtægtsart = 24, at indtægten BlanketFeltNummer A-indkomst uden AM-bidrag er 'Delpension'. Gældende værdisæt for indtægtsart samt tilhørende indkomstoplysning findes på SKATs hjemmeside for eindkomst i vejledningen 'Teknisk vejledning (formater m.v.) til eindkomst og LetLøn' snit på adressen: Ændring: Indkomsart 3 - Dagpenge (ved sygdom og ulykke), der er A-indkomst og Dagpengegodtgørelser for 1. til 3. ledighedsdag (udbetalt arbejdsgiver) udgår fra Den er erstattes følgende 2 indtægtsarter: Sygedagpenge der er A-indkomst og udbetales kommuner og arbejdsgivere. Gældende fra 1. januar Godtgørelse for ledighedsdag (G-dage) fra arbejdsgivere 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. KOMBIT A/S Halfdansgade København S CVR Side 26 37

27 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: 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 Service Management Timeout Se ovenfor XML er ikke valid Serviceplatformen returnerer fejlbesked til fagsystemet 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 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode 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 KOMBIT A/S Halfdansgade København S CVR Side 27 37

28 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 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 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 Overordnet forretningslogik SKAT eindkomst udstiller en synkron service, der udstiller indkomstoplysninger for en eller flere personer. KOMBIT A/S Halfdansgade København S CVR Side 28 37

29 3.2.2 Oversigt over endpoints ID Navn EP_ SK1 Læs SKAT indkomstoplysninger Beskrivelse endpoint EP_SK1 Læs SKAT indkomstoplysninger Transportspecifikation Serviceudstiller SKAT eindkomst udstiller servicen IndkomstOplysningPersonHent. Operationer: - getindkomstoplysningpersonhent Returnerer synkront indkomstoplysninger for en eller flere personer Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen implementeres som webservicebaseret, SOAP/HTTPS Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn services.extranet.skat.dk Endpoint IP Miljø: Test URI til WSDL Endpoint navn services.extranet.demo.skat.dk Endpoint IP Teknisk retning for udveksling Serviceplatformen foretager synkront kald til SKAT eindkomst Dataretning for udveksling SKAT eindkomst leverer indkomstdata til Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 29 37

30 Service invokation / Triggers Kommunikation initieres servicekald mod SKAT eindkomst fra Serviceplatformen. Dataspecifikation Dataspecifikationen for servicen findes i følgende schema-filer udstillet SKAT: Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata Der henvises til følgende dokument udstillet SKAT for yderligere oplysninger om dataelementer og valideringer: Valideringer fremgår ovennævnte dokument og/eller wsdl defineret i snit Der henvises til følgende side hos SKAT, hvor der findes en udvikler-wiki med yderligere detaljer: 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 KOMBIT A/S Halfdansgade København S CVR Side 30 37

31 Test TDC OCES Systemtest CA 2 Produktion TDC OCES CA Nedenstående tegning viser det overordnede koncept: 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: KOMBIT A/S Halfdansgade København S CVR Side 31 37

32 Fejlhåndtering (EP_SK1) # - 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. Serviceplatformen returnerer Ved gentagende fejl reporteres fejlen i henhold til det, der er beskrevet i kapitel Service Management Timeout Se ovenfor XML er ikke valid Serviceplatformen returnerer fejlbesked til fagsystemet 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 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode 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 i hver måned samt sidst på måneden. KOMBIT A/S Halfdansgade København S CVR Side 32 37