Integration SF0770_D - SKAT Skattekort - Opslag eskattekort Integrationsbeskrivelse - version 2.0.0

Relaterede dokumenter
Integration SF0770_A - SKAT Indkomst - Opslag personoplysninger Integrationsbeskrivelse - version 2.0.0

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

Integration SF Erhvervssystemet (eindkomst) Integrationsbeskrivelse - version 2.1.0

Integration SF Organisation services Integrationsbeskrivelse - version 2.2.0

Integration SF Sags- og Dokumentindeks Integrationsbeskrivelse - version 2.2.0

Integration SF SKAT R75 Integrationsbeskrivelse - version 2.0.0

Integration SF1920 NemLogin / Digital fuldmagt Integrationsbeskrivelse - version 1.0.0

SF Erhvervssystemet (eindkomst) Integrationsbeskrivelse version 2.2.2

Integration SF Klassifikation services Integrationsbeskrivelse - version 2.2.0

Integration SF STAR DFDG Bevillinger Integrationsbeskrivelse - version 2.0.0

Integration SF0800 Feriekonto Online opslag Integrationsbeskrivelse - version 2.0.0

Integration SF Ledelsesinformation - dataload Integrationsbeskrivelse - version 2.0.0

Integration SF SKAT R75 Integrationsbeskrivelse - version 2.3.0

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

Integration SF Organisation services Integrationsbeskrivelse - version 2.8.2

Integration SF1590_A - ØiR - Afsend økonomipostering til ØiR (Finans) Integrationsbeskrivelse - version 2.1.0

Integration SF Logning i de fælleskommunale IT systemer version 1.1 Integrationsbeskrivelse - version 2.0.0

SF1691 NemHandel (Modtag efaktura) Integrationsbeskrivelse - version 1.0.0

Integration SF Organisation services Integrationsbeskrivelse - version 2.7.0

SF1530 CVR-Online Integrationsbeskrivelse - version 2.2.0

Integration SF Organisation services Integrationsbeskrivelse - version 2.8.3

Integration SF Sags- og Dokumentindeks Integrationsbeskrivelse - version 2.8.1

Integration SF CPR online opslag Integrationsbeskrivelse - version 2.0.0

Integration 1411_A Hent informationer om social pension Integrationsbeskrivelse - version 2.0.0

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

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

Integration SF STAR DFDG Bevillinger Integrationsbeskrivelse - version 2.3.1

SF1460_A Modtag besked Integrationsbeskrivelse - version 2.3.0

Integration SF1590_C - ØiR - Afsend udbetalingsanmodninger til ØiR (Udbetalinger) Integrationsbeskrivelse - version

SF2250 NemSMS - Afsend SMS og tilmeld borger Integrationsbeskrivelse - version 2.2.1

Integration SF1320_A - CPR - Hændelser Integrationsbeskrivelse - version 2.0.2

Integration SF0770_B - SKAT Indkomst - Indberetninger Integrationsbeskrivelse - version 2.3.0

SF1622 Transitionsdata fra STAR Integrationsbeskrivelse - version 1.0.0

Integration SF Jobcenter Send bevilling til jobcentersag Integrationsbeskrivelse - version 2.0.1

SF 2800 Fordelingskomponent - Modtag objekter Integrationsbeskrivelse - version 2.0.0

SF Terminalservice UDK. Serviceversion Integrationsbeskrivelse - version 3 KDI

Integration 1411_E Besked om tillægsprocent Integrationsbeskrivelse - version 0.3.2

SF Print på Serviceplatformen Integrationsbeskrivelse - version 2.1.6

Integration SF0802 Feriekonto batchopslag Integrationsbeskrivelse - version 2.0.0

Integration 1411_D Besked om information om social pension Integrationsbeskrivelse - version 2.0.0

SF0810 Indlæggelser og Udskrivninger v1.0 Integrationsbeskrivelse v0.9

Integration SF2900 Fordelingskomponent version Integrationsbeskrivelse - version 2.0.2

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

Integration SF0770_B - SKAT Indkomst - Indberetninger Integrationsbeskrivelse - version 2.1.1

Integration SF7002 Overfør Sortiment til abonnent Integrationsbeskrivelse - version 1.3.1

SF Print på Serviceplatformen Integrationsbeskrivelse - version 2.2.0

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

Integration SF2601 Pensionsudbetaling for pensionister under administrationer

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

Integration SF0770_B - SKAT Indkomst - Indberetninger Integrationsbeskrivelse - version 2.4.0

SNITFLADER TIL INDEKSER. Præsentation af de fælleskommunale støttesystemernes snitflader til indekser

Integration SF CPR online opslag Integrationsbeskrivelse - version 2.1.0

Version 1.0. Vilkår for brug af Støttesystemet Adgangsstyring

Integration SF7001 Overfør Klassifikation til abonnent Integrationsbeskrivelse - version 1.3.0

Integration SF1320_A - CPR - Hændelser Integrationsbeskrivelse - version 2.0.0

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

Teknisk leverandørspor - Serviceplatformen

Integration 1411_A_V3 Hent informationer om social pension Integrationsbeskrivelse - version 3.2.1

Transkript:

Integration SF0770_D - SKAT Skattekort - Opslag eskattekort Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF

Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-10- 01 2014-10- 24 2015-06- 29 2015-06- 29 MHO 0.1 Første version MHO 0.2 Indsat i ny template JJN 0.3 Referencerettelser mm. EHE 2.0.0 Teknisk beskrivelse indarbejdet Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS- Sikkerhed] [WSDL-SP] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: https://share-komm.kombit.dk/p089/referencedokumenter Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://sharekomm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Integrationsbeskrivelsen refererer til SF0770_D Teknisk Spec 20150701.zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link https://sharekomm.kombit.dk/p089/integrationsbeskrivelser/ Indholdsfortegnelse 1 Overordnet beskrivelse... 4 1.1 Integrationens formål... 4 1.2 Overordnet forretningsflow i integrationen... 4 1.3 Servicebetingelser for den samlede integration... 4 1.4 Teststrategi... 6 1.5 Tilslutning af services... 6 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 19

2 Kontekst for integrationsparter... 8 2.1 Kontekst for KY (Kontanthjælp)... 8 3 Specifikation for integrationsparter... 9 3.1 Specifikation af endpoints for KY (Kontanthjælp)... 9 3.2 Specifikation af endpoints for Skat eindkomst... 12 4 Beskrivelse for integrationsplatforme... 17 4.1 Beskrivelse for Serviceplatformen... 17 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 19

SKAT eindkomst Serviceplatformen Fagsystem Integrationsbeskrivelse 1 Overordnet beskrivelse 1.1 Integrationens formål Integration har til formål at hente skattekort til fagsystemer, som har forvaltningsmæssigt brug for et øjebliksbillede af borgeres skattekortoplysninger. Integrationen kan benyttes af brugere, der er blevet tildelt adgang af SKAT. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystem forespørger på oplysninger om skattekort 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 skattekortoplysninger (synkront kald) Hent skattekortoplysninger Modtag skattekortoplysninger Synkron gennemstilling Synkron gennemstilling Modtag bestilling Returner svar 1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Flow 1 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 19

Tidsrum 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 eindkomstsystemer 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 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 http://www.skat.dk/skat.aspx?oid=71484 og at der via denne side kan abonneres på et RSS feed. 1.3.2 Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: https://share-komm.kombit.dk/p089/ KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 19

Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere. 1.3.2.1 Incident Management 1.3.2.2 Problem Management 1.3.2.3 Change Management 1.3.3 Lifecycle Management [Udfyldes med oplysninger om versionering af services. Fx beskrives: om der er mulighed for sideløbende versioner af servicen, om der findes specialiseringer servicen, hvor lang tid der afsættes til overgang til ny version, hvilken organisation der kan drive ændringer. 1.4 Teststrategi 1.4.1 Test i forbindelse med udvikling 1.4.1.1 Testfaciliteter og testmiljø 1.4.1.2 Testdata 1.4.2 Test i forbindelse med produktionssætning 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 it-systemer 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 Itsystemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 19

[Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] 1.5.1 Funktionalitet på Serviceplatformen Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. 1.5.2 Generelle forhold for tilslutning til integrationspart: SKAT Til brug for adgang til produktion skal Serviceplatformen benytte et OCES Virksomhedscertifikat (TDC OCES CA), som udstedes af KOMBIT (cvr 19435075). Til brug for test kan certifikater bestilles på: https://test.www.danid.dk/export/sites/dk.danid.oc/da/erhverv/bestil_digital_signatur/ 1.5.3 Generelle forhold for tilslutning 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 skaffe adgang til informationen kræves, at det SE-nummer kommunen anvender overfor SKAT i forhold til fagsystemet, autoriserer KOMBIT (cvr 19435075) som revisor i forhold til det pågældende SE-nummer. 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 19

2 Kontekst for integrationsparter 2.1 Kontekst for KY (Kontanthjælp) 2.1.1 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 kunne vurdere grundlaget for bevilling af kontanthjælp samt til beregning af skat ved straks-udbetalinger. 2.1.2 Kapacitets- og servicekrav eindkomst eskattekorthent bliver kaldt, når der indtræffer en hændelse i ydelsessystemet, som f.eks. en ny sag oprettes, oplyses eller en sag genoplyses. Forventet volumen for snitfladen er estimeret til 73.000 75.000 kald per måned. 2.1.3 Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 19

3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY (Kontanthjælp) Integrationen benyttes af fagsystemet til at hente eskattekortoplysninger fra SKAT eindkomst for en eller flere personer. Fagsystemet kalder serviceplatformen, som udstiller en synkron service, der kan hente skattekortoplysninger for en eller flere personer. 3.1.1 Overordnet forretningslogik Serviceplatformen udstiller en synkron service, der udstiller skattekortoplysninger for en eller flere personer (svarende til SKAT eindkomst): 1. Fagsystemet kalder EP_FS1 SkattekortoplysningerLaes på Serviceplatformen (Synkront kald) 2. Serviceplatformen returnerer svaret til fagsystemet (Synkront kald) 3.1.2 Oversigt over endpoints ID Navn EP_FS1 SkattekortoplysningerLaes 3.1.3 Beskrivelse af endpoint EP_FS1 - SkattekortoplysningerLaes 3.1.3.1 Transportspecifikation 3.1.3.1.1 Serviceudstiller Serviceplatformen udstiller service SkattekortoplysningerLaes Operationer: - Laes Henter skattekortoplysninger 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 for produktionsmiljø: Miljø: Produktion URI til WSDL [WSDL-SP] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 19

Se filen: SKATForwardESkattekortService.wsdl Endpoint navn Endpoint IP https://prod.serviceplatformen.dk [Udfyldes af Systematic senere] Miljø: Test URI til WSDL [WSDL-SP] Se filen: SKATForwardESkattekortService.wsdl Endpoint navn Endpoint IP https://exttest.serviceplatformen.dk [Udfyldes af Systematic senere] 3.1.3.1.5 Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen med søgeparametre for at hente skattekortoplysninger. 3.1.3.1.6 Dataretning for udveksling Skattekortoplysninger modtages af fagsystemet fra Serviceplatformen (SKAT). 3.1.3.1.7 Service invokation / Triggers Kommunikation initieres af, at fagsystemet udsteder et kald til Serviceplatformen. 3.1.3.2 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: http://85.81.229.78/systems/eindkomst/eindkomst20110412/eskattekorthent_20110412.doc Valideringer fremgår af ovennævnte dokument og/eller wsdl defineret i afsnit 3.1.3.1.4. 3.1.3.3 Sikkerhed Der anvendes Serviceplatformens standard sikkerhedsmodel med systemspecifikke certifikater, baseret på KOMBITs CVR-nummer. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 19

3.1.3.4 Leverancesikkerhed og fejlhåndtering Det er fagsystemet, der håndterer eventuelle fejl i retursvar eller timeout og dermed beslutter, om forespørgsel skal genfremsendes. 3.1.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time.ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. 3.1.4 Service Management 3.1.4.1 Incident Management 3.1.4.2 Problem Management 3.1.4.3 Change Management KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 19

3.1.5 Testplan 3.1.5.1 Integrationstest 3.1.5.2 Produktionssætningstest 3.2 Specifikation af endpoints for Skat eindkomst Integrationen benyttes af et Serviceplatforment til at hente eskattekortoplysninger fra SKAT eindkomst for en eller flere personer. SKAT eindkomst udstiller en synkron service, der udstiller eskattekortoplysninger for en eller flere personer. 3.2.1 Overordnet forretningslogik SKAT eindkomst udstiller en synkron service der udstiller skattekortoplysninger for en eller flere personer. 3.2.2 Oversigt over endpoints ID Navn EP_SK1 eindkomst eskattekorthent 3.2.3 Beskrivelse af endpoint EP_SK1 - eskattekorthent 3.2.3.1 Transportspecifikation 3.2.3.1.1 Serviceudstiller SKAT eindkomst udstiller servicen eskattekorthent Operationer: - geteskattekorthent Returnerer synkront skattekortoplysninger 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ø. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 19

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 af servicekald mod SKAT eindkomst fra Serviceplatformen. 3.2.3.2 Dataspecifikation Dataspecifikationen for servicen findes i følgende schema-filer udstillet af SKAT: Miljø: Produktion Inputdata Outputdata http://85.81.229.78/services/prod/eindkomst/view/eskattekorthent_itype.xsd http://85.81.229.78/services/prod/eindkomst/view/eskattekorthent_otype.xsd Miljø: Test Inputdata Outputdata http://85.81.229.78/services/demo/eindkomst/view/eskattekorthent_itype.xsd http://85.81.229.78/services/demo/eindkomst/view/eskattekorthent_otype.xsd Der henvises til følgende dokument udstillet af SKAT for yderligere oplysninger om dataelementer og valideringer: http://85.81.229.78/systems/eindkomst/eindkomst20110412/eskattekorthent_20110412.doc KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 19

Valideringer fremgår af ovennævnte dokument og/eller wsdl defineret i afsnit 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 3.2.3.3 Sikkerhed Både test- og produktions-driftsmiljøet anvender SSL med VeriSign SSL-certifikater. Klientprogrammet identificerer sig overfor 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 webserviceklient 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 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 19

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. 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 3.2.3.4 Leverancesikkerhed og fejlhåndtering Serviceplatformen skal, ud over retursvaret, håndtere timeout på kaldet med 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 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. 3.2.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt 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 af 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 15 af 19

3.2.4 Service Management 3.2.4.1 Incident Management Ikke oplyst. 3.2.4.2 Problem Management Ikke oplyst. 3.2.4.3 Change Management Ikke oplyst. 3.2.5 Testplan 3.2.5.1 Integrationstest 3.2.5.2 Produktionssætningstest KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 19

Fagsystemer 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 eskattekortoplysninger EP_SK1 SKAT eindkomst 4.1.1 Oversigt over integrationsflows ID Navn IF01 Forespørg eskattekortoplysninger 4.1.2 Integrationsflow IF01: Forespørg eskattekortoplysninger 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 Hent skattekortoplysninger Afsnit 3.1 EP_SK1 Læs SKAT skattekortoplysninger Afsnit 3.2 4.1.2.2 Integrationstype Integrationen er en gennemstillingsintegration. 4.1.2.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 19

Fagsystem Serviceplatform SKAT eindkomst Synkront kald for hent eskattekort SP viderestiller kald til SKAT SKAT returnerer resultat SP returnerer data til FS Hent eskattekortoplysninger EP_FS1 eskattekorthent 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 4.1.2.4 Datatransformering Ingen krav. 4.1.2.5 Datapersistering Ingen krav. 4.1.2.6 Databerigelse Ingen krav. 4.1.2.7 Routing Ingen krav. 4.1.2.8 Orkestrering Ingen krav. 4.1.2.9 Sikkerhed Sikkerheden baseres på to selvstændige trusts: - Serviceplatform og fagsystem - Serviceplatform og SKAT eindkomst Serviceplatformen skal sikre, at det kun er godkendte kildesystemer inkl. dataejere, som kan anvende servicen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 19

Der er ingen krav til delegering mellem de to trusts. 4.1.2.10 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. 4.1.2.11 Testdata og testfaciliter 4.1.2.12 Konfiguration Ingen krav. 4.1.2.13 Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 19