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

Transkript

1 Integration SF0770_A - SKAT Indkomst - Opslag personoplysninger Integrationsbeskrivelse - version Kommunernes Datafæ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 af 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 dataafgrænsning Kapitel 1.5 Opdateret med yderlige beskrivelse af forhold for tilslutning. Opdateret wsdl Referencer Ref Titel Kommentarer [SPref] Note vedrørende servicemål for Serviceplatformen [SIKKERHED] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Kun relevant for leverandøren til serviceplatformen Se link [STS-Sikkerhed] [WSDL-SP] Se vilkår Bilag 2 - Vilkår for anvendelse af 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 KOMBIT A/S Halfdansgade København S CVR Side 2 af 23

3 [WSDL-EXT] 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 KOMBIT A/S Halfdansgade København S CVR Side 3 af 23

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY (Kontanthjælp) Kontekst for KSD (Sygedagpenge) Kontekst for SAPA (sagsoverblik/partskontakt) Specifikation for integrationsparter Specifikation af endpoints for KY+KSD+SAPA Specifikation af endpoints for SKAT eindkomst Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen Noter vedr. beslutning, detaljer og andet... Fejl! Bogmærke er ikke defineret. 5.1 Input vedr. lovhjemmel... Fejl! Bogmærke er ikke defineret. KOMBIT A/S Halfdansgade København S CVR Side 4 af 23

5 SKAT eindkomst Serviceplatformen Fagsystem Integrationsbeskrivelse 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 på den enkelte borger er begrænset i henhold til den aftale 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. 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 af 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. Hent indkomstoplysninger (synkront kald) Hent indkomstoplysninger Modtag indkomstoplysninger Synkron gennemstilling Synkron gennemstilling Modtag bestilling Returner svar KOMBIT A/S Halfdansgade København S CVR Side 5 af 23

6 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Flow: Hent indkomstoplysninger Systemet driftsafvikles 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. 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 af 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 af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. SKAT oplyse at information om servicevinduer, kan findes på følgende link og at der via denne side kan abonneres på et RSS feed. KOMBIT A/S Halfdansgade København S CVR Side 6 af 23

7 Man kan generelt finde information om driftssituationen på SKATs driftlog for Ny Driftslog for udstilling af 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 af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere Incident Management Problem Management Change Management Lifecycle Management 1.4 Teststrategi Test i forbindelse med udvikling Testfaciliteter og testmiljø Testdata Test i forbindelse med produktionssætning KOMBIT A/S Halfdansgade København S CVR Side 7 af 23

8 1.5 Tilslutning af services Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. [Afklaring /KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] Funktionalitet på Serviceplatformen Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed] Generelle forhold for tilslutning til integrationspart: SKAT KOMBITs certifikat skal anvendes til at autorisere kommunikationen med udgangspunkt i Fejl! Henvisningskilde ikke fundet.. Dette kræver at der for hver kommune for hvert fagsystem har indgået en aftale om overførelse af indkomstoplysninger, hvilket er gjort i forbindelse med aftale omkring monopolbrud. Til brug for adgang til produktion skal Serviceplatformen benytte et OCES Virksomhedscertifikat (TDC OCES CA), som udstedes af KOMBIT (cvr ). Et fagsystem kan dække et eller flere fagområder. De enkelte fagområder skal være understøttet af relevant lovgivning for overførelse af indkomstoplysninger. Hvert fagområde vil få tilknyttet en adgangsformålstypekode, som dokumenterer det lovgrundlag, som et system anvender for at hente indkomstoplysninger i en konkret sag Generelle forhold for tilslutning til integrationspart: KY, KSD og SAPA Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed] For at få adgang til indkomstoplysninger kræves det, at det SE-nummer kommunen anvender over for SKAT i forhold til fagsystemet, autoriserer KOMBIT (cvr ) som revisor i forhold til det pågældende SE-nummer. Dette skal gøres i SKATs Tast-selv Erhverv portal, og i [WSDL-EXT] findes SKATs vejledning vedrørende dette. Denne opgave skal kommunen udføre inden fagsystemet kan anvende denne service. 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 8 af 23

9 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 af servicen: Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en 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 af 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 af en sag, samt oplysning af en sag. Disse er essentielle data i forbindelse med Beregningsgrundlaget, som optræder i flere dele af ydelsessystemet informationsmodeller Kapacitets- og servicekrav Ydelsessystemet skal lave opslag ved oprettelse af nye sager, og genopslag i forbindelse med f.eks. genoplysning af sagen. Forventet volumen for integration er estimeret til kald per måned Specifikke forhold for tilslutning af system Ingen identificeret. 2.2 Kontekst for KSD (Sygedagpenge) Lovhjemmel og forvaltningsmæssigt formål Der findes følgende lovhjemmel for systemets anvendelse af servicen: KOMBIT A/S Halfdansgade København S CVR Side 9 af 23

10 Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dæ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 af 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 af en sag, samt oplysning af en sag. Disse er essentielle data i forbindelse med Beregningsgrundlaget, som optræder i flere dele af sygedagpengesystemets informationsmodeller Kapacitets- og servicekrav Sygedagpengesystemet skal lave opslag ved oprettelse af nye sager, og genopslag i forbindelse med f.eks. genoplysning af sagen. Der forventes max opslag per måned Specifikke forhold for tilslutning af system Ingen identificeret. 2.3 Kontekst for SAPA (sagsoverblik/partskontakt) Lovhjemmel og forvaltningsmæssigt formål Lovhjemmel til brug af integrationen og det forvaltningsmæssige formål er dokumenteret i vedhæftede reference: SKAT Hjemmelgrundlag for brug af eindkomst. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af 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 af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav Ukendt, men det er formentlig ikke så stort. KOMBIT A/S Halfdansgade København S CVR Side 10 af 23

11 2.3.3 Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 11 af 23

12 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY+KSD+SAPA Integrationen benyttes af 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 EP_FS1 IndkomstoplysningerLaes Beskrivelse af 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 Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL [WSDL-SP] KOMBIT A/S Halfdansgade København S CVR Side 12 af 23

13 Se filen SKATForwardEIndkomstService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL [WSDL-SP] SKATForwardEIndkomstService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemerne kalder Serviceplatformen med søgeparametre for at modtage indkomstoplysninger retur Dataretning for udveksling Indkomstoplysninger (lønindberetninger mv.) modtages af fagsystemet fra Serviceplatformen (SKAT) Service invokation / Triggers Kommunikation initieres af, 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 af SKAT: Miljø: Produktion Inputdata Outputdata [WSDL-SP]/XSD [WSDL-SP] /XSD Der henvises til følgende dokument udstillet af 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 13 af 23

14 Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit 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 aftales 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 Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed] 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 af 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. KOMBIT A/S Halfdansgade København S CVR Side 14 af 23

15 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer Service Management Incident Management Problem Management Change Management Testplan Integrationstest KOMBIT A/S Halfdansgade København S CVR Side 15 af 23

16 Produktionssætningstest 3.2 Specifikation af endpoints for SKAT eindkomst Integrationen benyttes af 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 Oversigt over endpoints ID Navn EP_ SK1 Læs SKAT indkomstoplysninger Beskrivelse af 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 KOMBIT A/S Halfdansgade København S CVR Side 16 af 23

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

18 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 af følgende CA er: Miljø Certificate Authority 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 aftale med SKAT. SKAT-serverens keystore indeholder SKATs virksomhedscertifikat og DanId OCES root certifikat. SKATs aftaledatabase validerer adgang til servicen. KOMBIT A/S Halfdansgade København S CVR Side 18 af 23

19 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 forkert certifikat, manglende eller forkert opsætning i STS, opsætning af 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 af valideringsfejl hos SKAT, vil årsagen (fejlkoden) fremgå af retursvaret, der modtages på Serviceplatformen. Disse videresendes direkte tilbage til det kaldende fagsystem. I tilfælde af valideringsfejl hos SKAT, vil årsagen (fejlkoden) fremgå af retursvaret, der modtages på Serviceplatformen. Disse videresendes direkte tilbage til det kaldende fagsystem. I tilfælde af fejl / timeout i kommunikationen med SKAT vil Serviceplatformen informere det kaldende fagsystem med angivelse af 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 underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade København S CVR Side 19 af 23

20 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 i hver måned samt sidst på måneden. 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 af data fra eindkomst på link Service Management [Afklaring/KDF: Link til driftslog med varsling af servicevinduer mv.: Incident Management Ikke oplyst Problem Management Ikke oplyst Change Management Ikke oplyst Testplan Integrationstest Produktionssætningstest KOMBIT A/S Halfdansgade København S CVR Side 20 af 23

21 Fagsystem Integrationsbeskrivelse 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. EP_FS1 Serviceplatformen IF01 Forespørg indkomstoplysninger EP_SK1 SKAT eindkomst Oversigt over integrationsflows ID Navn IF01 Forespørg indkomstoplysninger 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 Integrationstype Gennemstillingsintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 21 af 23

22 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: 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 af timeout, genererer SP retursvaret 6. SP returnerer svaret til FS i servicekaldets returparameter Datatransformering Ingen krav Datapersistering Ingen krav Databerigelse Ingen krav Routing Ingen krav Orkestrering Ingen krav 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. KOMBIT A/S Halfdansgade København S CVR Side 22 af 23

23 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 afventer generel afklaring af test] Konfiguration Ingen krav Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade København S CVR Side 23 af 23