Integration SF0770_D - SKAT Skattekort - Opslag eSkattekort
Integration SF0770_D - SKAT Skattekort - Opslag eSkattekort Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort Versionshistorik Relevans Dato Initialer Version Kommentarer 2014-1001 MHO 0.1 Første version 2014-1024 MHO 0.2 Indsat i ny template 2015-0629 JJN 0.3 Referencerettelser mm. 2015-0629 EHE 2.0.0 Teknisk beskrivelse indarbejdet Referencer Ref Titel [SPref] Se ”Note vedrørende servicemål for Serviceplatformen.pdf” på følgende link: https://share-komm.kombit.dk/p089/Referencedokumenter [SIKKERHED] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 [STSSikkerhed] 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 [WSDL-SP] 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://share- Kommentarer komm.kombit.dk/p089/Integrationsbeskrivelser/ Indholdsfortegnelse Overordnet beskrivelse ............................................................................................. 4 1 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort Kontekst for integrationsparter .................................................................................... 8 2 2.1 Kontekst for KY (Kontanthjælp) ................................................................................ 8 Specifikation for integrationsparter ............................................................................... 9 3 3.1 Specifikation af endpoints for KY (Kontanthjælp) ........................................................... 9 3.2 Specifikation af endpoints for Skat eIndkomst ............................................................. 12 Beskrivelse for integrationsplatforme ........................................................................... 17 4 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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. SKAT eIndkomst Serviceplatformen Fagsystem Hent skattekortoplysninger (synkront kald) 1.3 1.3.1 Hent skattekortoplysninger Modtag skattekortoplysninger Synkron gennemstilling Synkron gennemstilling Modtag bestilling Returner svar Servicebetingelser for den samlede integration 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. SKAT oplyse at information om servicevinduer, kan findes på følgende link http://www.skat.dk/SKAT.aspx?oId=71484 og at der via denne side kan abonneres på et RSS feed. 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 [email protected]. 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.3.2.2 Problem Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.3.2.3 Change Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 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 Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.4.1 Test i forbindelse med udvikling Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.4.1.1 Testfaciliteter og testmiljø Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.4.1.2 Testdata Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.4.2 Test i forbindelse med produktionssætning Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort [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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 2 Kontekst for integrationsparter 2.1 2.1.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 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort Se filen: SKATForwardESkattekortService.wsdl Endpoint navn https://prod.serviceplatformen.dk Endpoint IP [Udfyldes af Systematic senere] Miljø: Test URI til WSDL [WSDL-SP] Se filen: SKATForwardESkattekortService.wsdl Endpoint navn https://exttest.serviceplatformen.dk Endpoint IP [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 [WSDL-SP]/XSD Outputdata [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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Værdi Tidsrum Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. 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 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. Spidsbelastningsperiode Må antages at være i perioden 06:00 -18:00 på arbejdsdage 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. 3.1.4 Service Management 3.1.4.1 Incident Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.1.4.2 Problem Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.1.4.3 Change Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 19 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 3.1.5 Testplan 3.1.5.1 Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.1.5.2 Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort Miljø: Produktion URI til WSDL http://85.81.229.78/services/prod/eIndkomst/wsdl/ Endpoint navn services.extranet.skat.dk Endpoint IP 147.29.150.165 Miljø: Test URI til WSDL http://85.81.229.78/services/demo/eIndkomst/wsdl/ Endpoint navn 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 http://85.81.229.78/services/prod/eIndkomst/view/eSkattekortHent_IType.xsd Outputdata http://85.81.229.78/services/prod/eIndkomst/view/eSkattekortHent_OType.xsd Miljø: Test Inputdata http://85.81.229.78/services/demo/eIndkomst/view/eSkattekortHent_IType.xsd Outputdata 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Serviceplatformen: OIO webserviceklient SOAP Header med Userid SKAT OIO grænseflade OIO service SOAP response SOAP Body signeret med SKATs certifikat Message log Klient keystore TDC spærreliste Aftaler Server keystore KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Internt i SKAT Side 14 af 19 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Værdi Tidsrum SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for åbningstid. Svartid SKAT vil ikke forpligtiger sig til at oplyse et tidsrum for svartider. Tilgængelighed SKAT vil ikke forpligtiger sig til at oplyse en garanteret tilgængelighed Spidsbelastningsperiode SKAT har oplyst, at der er spidsbelastningsperiode den 25. – 26. i hver måned samt sidst på måneden. Servicevinduer 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 3.2.5.2 Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 19 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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. Fagsystemer 4.1.1 IF01 Forespørg eSkattekortoplysninger Oversigt over integrationsflows ID Navn IF01 Forespørg eSkattekortoplysninger 4.1.2 EP_SK1 SKAT eIndkomst Serviceplatformen EP_FS1 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort Fagsystem Synkront kald for hent eSkattekort SP viderestiller kald til SKAT SKAT returnerer resultat SP returnerer data til FS Serviceplatform SKAT eIndkomst 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 Integrationsbeskrivelse SF0770_D - SKAT Skattekort - Opslag eSkattekort 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 Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 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
© Copyright 2024