KMD Indkomst Indkomstgrænseflade P13-5 Løsningsbeskrivelse Version 9
Internt Indholdsfortegnelse 1 Versionsoversigt... 3 2 Referenceoversigt... 4 3 Formål... 5 4 Konceptuel løsningsmodel... 6 4 Krav til løsning... 7 4.1 Overordnet krav... 7 4.2 Krav og acceptkriterier... 7 5 Sikkerhedsstyring... 9 5.1 Generelt... 9 5.2 Sporbarhed... 9 5.3 Identifikation / formål på spørgeren sikkerhedsmodel... 9 5.4 Indkomstoplysninger, synkrone opslag (enkelt forespørgsel)... 10 5.5 Advis og Indkomstoplysninger, asynkrone opslag (masse forespørgsel)... 10 5.6 Tekniske forhold... 10 6 Inddata og uddata... 11 6.1 Indkomstoplysninger, synkrone opslag (enkelt forespørgsel)... 11 6.1.1 Årsopgørelsesoplysninger... 11 6.1.2 Forskudsopgørelsesoplysninger... 11 6.1.3 Inddata... 11 6.1.4 Uddata... 11 6.2 Indkomstoplysninger, asynkrone opslag (masse forespørgsel)... 11 6.2.1 Årsopgørelsesoplysninger... 11 6.2.2 Forskudsopgørelsesoplysninger... 11 6.2.3 Inddata... 12 6.2.4 Uddata... 12 6.3 Advis om årsopgørelse... 13 6.3.1 Advis, inddata... 13 6.3.2 Advis, uddata... 13 6.3.3 Driftsplan... 13 7 Bilag: Strukturer... 14 Side 2 af 14
1 Versionsoversigt Dato Hvem Hvad Version 25-03-2013 JXP Opgavebeskrivelse oprettet 000 08-04-2013 JXP Opgavebeskrivelse klar til intern godkendelse 000 15-04-2013 JXP Opgavebeskrivelse gennemgået intern godkendelse 001 26-06-2013 JXP Strukturer er flyttet til bilag 1 og der er henvisning dertil relevante steder. 002 Strukturer justeret efter udvikler-gennemgang. Kvittering og fejl er beskrevet i bilag 1. MQ-kommunikation uddybet i afsnit 4.3 Tegninger i afsnit 6 er udvidet med Kvittering og Fejl. Afsnit 7 henviser til afsnit 4. Forsiden omdøbt til Løsningsbeskrivelse. 21-10-2013 JXP Krav 003 justeret, så det fremgår, at det er de personer som Myndigheden 003 indberetter, som der gives advis om. Så kan der sendes advis til anvender, selvom personkredsen er indberettet af en anden anvender (fx KMD Sag). Afsnit 6.2: Ændret navn på rolleprofil. Afsnit 6.4: Fordeling af hændelser er blevet et selvstændigt program og der er tilføjet ny Anvender-tabel. Afsnit 6.5: Tilføjelse af ny Anvender-tabel. Bilag 1 justeret med feltbeskrivelse af Antal elementer. Bilag 1 udvidet med afsnittet Strukturer på Digitaliser.dk Bilag 2 justeret med tre nye felter. 15-09-2014 JXP Udvidelse af P13-5 indarbejdes. Den indebærer: 004 synkrone opslag (enkelt forespørgsel) efter forskudsdata asynkrone opslag efter forskudsdata asynkrone opslag efter årsopgørelsesdata redaktionelle ændringer (især Myndighed erstatter kommune, re-nummerering af afsnit). At der indlægges kontrol på Anvenders brug af løsningen 02-10-2014 JXP, HHK Internt review gennemført og kommentarer indarbejdet. 005 23-12-2014 JXP, HHK Indarbejdelse af respons på KOMBITs kommentarer til version 005 006 30-04-2015 HHK Indarbejdelse af præcision på afsnit 4.2, pkt. 003 Advis-eIndkomst underpunkt f og pkt. 004 Advis-årsopgør underpunkt e. 007 Kvittering for svar udgår af løsningsdesignet og fig. 1 er justeret (pkt. 6, kvittering for svar er fjernet). Samtidigt udgår tidligere afsnit 7.2.4, 7.4.3 og 7.5.5, Kvittering for leverance, afgives af Myndighed. Tilføjelse af nyt afsnit 7.1, MQ Pakning (inkl. underpunkterne 7.1.1 og 7.1.2. Indarbejdelse af præcisioner, jvf MHs kommentarer modtaget 26.01.2015. 21.05.2015 HHK Indarbejdelse af kommentarer modtaget 05.05.2015 fra Mia Riisager Larsen: Løsningsbeskrivelsens afsnit 2 ændres til at hedde Formål. 008 Bilag 7: Strukturer eksemplerne fjernes og der henvises til snitfladebeskrivelserne. 18.06.2015 HHK Fjernelse af eindkomst fra Løsningsbeskrivelsen. 009 Indarbejdelse af en referenceoversigt samt konsekvensrettelser. Tegningen, fig.1, og beskrivelsen af den konceptuelle løsnngsmodel udvides til også at afspejle anvendelsen af kopi-register. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 3 af 14
2 Referenceoversigt I denne løsningsbeskrivelse anvendes referencer til følgende dokumenter med angivelse af deres placering: Beskrivelse Dokumentnavn Placering Snitfladebeskrivelse MQ KMD Indkomst - MQService IndkomstMasseForespoergsel vx.x https://kundenet.kmd.dk/snitfladeb eskrivelser Snitfladebeskrivelse Webservice KMD Indkomst - WEBService IndkomstEnkeltForespoergsel - vx.x https://kundenet.kmd.dk/snitfladeb eskrivelser Oversigt over felter fra årsog forskudsopgørelse. Indkomstgrænseflade_P13_5_Feltoversigt_vX.X https://kundenet.kmd.dk/suppleren de Strukturtegning for MQ KMD Indkomst - Strukturtegning for MQServie IndkomstMasseForespoergsel vx.x https://kundenet.kmd.dk/suppleren de Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 4 af 14
3 Formål Formålet med projektet er, at udvikle en standardiseret Business-To-Business-snitflade mellem 3. parts systemer og KMD Indkomst. Løsningen skal understøtte KOMBITs ønske om at gøre snitflader offentligt tilgængelige. Opgaven falder ind under klippekortaftalen med KOMBIT, og følgelig skal krav, timeforbrug samt accepttest godkendes af KOMBIT (Mia Riisager Larsen) og internt i KMD af Mette Bagge (MEB) og Business Line Manager for KMD Indkomst Steen Østergaard (SOT). Formålet er at levere en åben, tilgængelig, brugbar snitflade med fokus på datasikkerhed, leveranceomkostninger og hensigtsmæssig størrelse til formålet. Der skal leveres informationer fra SKATs forskudsregister og årsopgørelsesregistret(kopiregister) i KMD Indkomst. Ændringer i struktur og indhold i disse registre kan medføre ændringer til løsningens indholdet og - snitflade. Der er normalt ændringer hvert år. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 5 af 14
4 Konceptuel løsningsmodel Nedenstående figur 1 beskriver de konceptuelle forretningsprocesser omkring fremsendelse af personkreds, validering, kvittering/fejlmeddelelser, forespørgsel til og svar fra SKAT samt videre fremsendelse af svar til Myndighed. Informationer om årsopgørelser hentes i kopi register i KMD Indkomst. Øvrige informationer hentes ved opslag i SKAT. Myndighed Anvender 2. 1. forespørgsel Validering 3. forespørgsel 2. Kvittering/ fejlmeddelse Afsend/ Modtag SKAT el KOPI 5. Svar 4. Svar Forskud SKAT Årsopgørelse Kopi-register Bemærkninger til figur 1: Henvisning til figur 1 Figur 1 Konceptuel løsningsmodel Forklaring 1 Myndigheden fremsender en forespørgsel. Forespørgslen kan indeholde et enkelt personnummer eller samling af personnumre (en personkreds). Opbygning af personkredsen er beskrevet i Snitfladebeskrivelse MQ, se Referenceoversigt. Inden registrering af personkredsen i KMDs database udføres en række valideringer. 2 Efter valideringerne fremsendes enten en KMD kvitteringsmeddelelse eller en KMD fejlmeddelelse. Hvis der er tale om KMD kvittering udføres de efter pkt. 3 5 beskrevne handlinger, i modsat fald stopper behandliingen. 3 KMD fremsender forespørgsel til SKAT eller kopi-register (internt register i KMD fra SKAT). 4 KMD modtager svar fra SKAT eller kopi-register. 5 KMD videresender SKAT/kopi-register svar/ fejlmeddelelser til Myndighed. KMD fortolker ikke svar fra SKAT eller kopi-register. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 6 af 14
4 Krav til løsning 4.1 Overordnet krav Løsningen skal levere følgende indkomstoplysninger: indkomstoplysninger fra årsopgørelsesregistret, synkrone opslag (enkelt forespørgsel) og asynkrone opslag (masse forespørgsel). indkomstoplysninger fra forskudsregistret, synkrone opslag (enkelt forespørgsel) og asynkrone opslag (masse forespørgsel). og advis om: ændringer fra årsopgørelsesregistret. 4.2 Krav og acceptkriterier Krav 001 Aftaler og lovmedholdelighed Acceptkriterier a. En Myndighed (en kommune eller Udbetaling Danmark) og KMD skal indgå aftale om brug af denne løsning. Myndigheden kan anvende de dele af løsningen, den ønsker. b. En Myndigheds it-leverandør eller en Myndigheds it-afdeling (i det følgende kaldt Anvender) og KMD skal indgå aftale om Anvenders brug af denne løsning. c. En Anvender optræder på vegne af en Myndighed. d. Myndigheden skal have licens på brug af KMD Indkomst. e. Myndigheden skal have registreret aftale med SKAT om adgang til relevante registre. f. Det er Myndighedens ansvar at dataanvendelsen er lovmedholdelig. g. KMD informerer Anvender om ændringer i snitfladen pr. mail. De til enhver tid gældende snitfladebeskrivelser findes på KMDs kundenet. Der gives mindst 3 måneders frist før strukturændringer træder i kraft. Ændringer i bestanden af leverede felter adviseres umiddelbart efter ændringerne er aftalt mellem SKAT og KMD, hvilket kan medføre en kortere frist end 3 måneder. 002 Udstilling af indkomstoplysninger a. Løsningen tilbyder udstilling af indkomstoplysninger i form af - årsopgørelsesoplysninger, seneste 3 skatteår. - forskudsoplysninger, indeværende år og det kommende skatteår (når dette foreligger). b. Synkrone opslag efter indkomstoplysninger er en online løsning. Synkrone opslag vedrører én person for én periode og dækker enten årsopgørelse eller forskudsopgørelse. c. Asynkrone opslag efter indkomstoplysninger er en batch løsning. Asynkrone opslag vedrører en eller flere personer for én periode og dækker enten årsopgørelse eller forskudsopgørelse. d. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. e. Fremskaffelse af forskudsopgørelsen sker ved opslag i SKATs forskudsregister via snitflade som SKAT stiller til rådighed. Fremskaffelse af årsopgørelsen sker ved opslag i den kopi af årsopgørelsen, som KMD Indkomst fører. 004 Advis-årsopgør a. Der adviseres om tilgang og ændring af årsopgørelsen for de seneste 3 skatteår. b. Et advis indeholder oplysninger i personens årsopgørelse. c. Advisering sker om de personer, som Myndigheden fremsender personkreds til KMD Indkomst om. d. Adviseringen sker løbende i forbindelse med, at ændringerne modtages fra SKAT. e. Advisforespørgelse fremsendes fra Myndighed med oplysninger, som anført i Snitfladebeskrivelsen, se Referenceoversigt. Der dannes og leveres advis meddelelser til Myndighed, som opfylder de krav der er anført i forespørgslen. f. Der dannes og leveres advis meddelelser til Anvender, som opfylder de krav der er anført i forespørgslen. g. Personkredsen er gældende indtil ny personkreds fremsendes. Den nye personkreds overskriver fuldt og helt den tidligere personkreds. Der er ingen delta-opdatering af en personkreds. Ønskes er personkreds slettet fremsendes en tom forespørgsel ( tom = indeholder kun header-informationer og ingen personkreds). Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 7 af 14
Krav Acceptkriterier 005 Tekniske krav a. Kommunikation om synkrone opslag (enkelt forespørgsel) sker mellem Anvender og KMD via en web-service. b. Der anvendes OIOXML-standarden. For at sikre en enkel anvendelse og vedligeholdelse anvendes kodeværdier for de udstillede indkomstoplysninger. c. Der er ikke krav om en officiel godkendelse af overholdelse af OIOXML-standarden. d. OIOXML-beskrivelsen formuleres på dansk. e. Kommunikation om asynkrone opslag (masse forespørgsel) og advis sker mellem Anvender og KMD via IBM MQ. 006 Sikkerhed a. En Myndighed skal overfor KMD oplyse, hvilke(n) Anvender(e) som må optræde på Myndighedens vegne. Herunder hvilke sagsområder og funktioner, som Anvender må få adgang til. Ved synkrone opslag(enkelt forespørgsel): b. Anvender skal i hver elektronisk henvendelse til KMD Indkomst identificere sig med certifikat, som i KMDs KSP/CICS-system vil være tilknyttet en pseudo-bruger, der er autoriseret til en rolleprofil, som giver adgang til denne løsning. c. Rolleprofilen tildeles kun Anvendere, der har indgået aftale med KMD herom. d. Identifikation af Anvender skal sikres via certifikatets indhold. Ved asynkrone opslag(masse forespørgsel) og advis: e. Anvender skal benytte en på forhånd aftalt MQ forbindelse. 007 Sporbarhed Enhver KMD intern behandling af forespørgsel skal kunne spores til den konkrete forespørgsel fra Myndigheden. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 8 af 14
5 Sikkerhedsstyring 5.1 Generelt En Myndighed skal indgå aftale med KMD om anvendelse af denne løsning. Aftalen skal oplyse hvilke(n) Anvender(e), som må optræde på Myndighedens vegne samt aftale hvilke sagsområder og funktioner, som den enkelte Anvender må få adgang til. Aftalen kan tilbagekaldes af Myndigheden overfor KMD. En Myndigheds it-leverandør eller en Myndigheds it-afdeling (i det følgende kaldt Anvender) skal indgå aftale med KMD om anvendelse af denne løsning. Anvender må kun anvende løsningen for de Myndigheder, som Anvender har indgået aftale med. Anvender forpligtiger sig til kun at kommunikere om personer, der er dækket af de indgåede aftaler. KMD og Anvender skal indgå aftale, der afspejler ovennævnte forhold. I denne aftale fremgår det ligeledes, at KMD's logning kun relaterer sig til Anvender og ikke til brugere af Anvenders egen it-løsning. Det er Anvenders ansvar at føre logning af de slutbrugere og it-løsninger, der anvender denne løsning via Anvenders it-løsning. Aftalen dækker både information vedrørende indkomstoplysninger og advisering, men Anvender bestemmer selv, hvilke dele af løsningen der ønskes anvendt. 5.2 Sporbarhed KMDs løsning gennemfører logning for at sikre: modtagelse/afsendelse af forespørgsel/svar til/fra eller Anvender: håndteringen af egne interne processer afsendelse/modtagelse af forespørgsel/svar til/fra SKAT. KMDs løsning gennemfører ingen logning til at sikre Myndighedens overholdelse af persondataloven, forvaltningsloven eller anden lovgivning. Dette ansvar påhviler Myndigheden. 5.3 Identifikation / formål på spørgeren sikkerhedsmodel Løsningen forudsætter, at der, i forbindelse med kundens aftale med SKAT om at modtage og anvende informationer fra SKAT, ikke vil blive stillet krav om ændringer i kendte procedurer. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 9 af 14
5.4 Indkomstoplysninger, synkrone opslag (enkelt forespørgsel) Fig 2: 3. part service anvender KMD Indkomst. Klient PC (Anvendercertifikat) OCES CA (NETS_DANID) Validering af: Anvendercertifikat 3. parts Service (Anvendercertifikat) OIOXML EWS TDC rodcertifikat Eksternt KMD Internt KMD Tilslutningssaftale bekræftes BFS Certifikat oversættes til RACFid Anvendercertifikater: (OCES) MOCES: Medarbejdercertifikat FOCES: Funktionscertifikat SOCES: Servercertifikat Applikationskomponet Indkomst KMD Indkomst EWS (External Webservice Server) anvendes til at udstille KMD's webservices til 3. part. BFS (Business Foundation Server) anvendes til al kommunikation fra KMD's decentrale arkitektur (.NET) til KMD's centrale arkitektur (mainframe). Applikationskomponenterne ligger på en Z/OS mainframe, og driftsafvikles regionalt. Kommunikationsformen er synkron. 5.5 Advis og Indkomstoplysninger, asynkrone opslag (masse forespørgsel) Masseforespørgsel, advis (begge ved aflevering af personkreds) og deres dertilhørende svar udveksles gennem beskyttede (dedikerede) MQ kanaler. 5.6 Tekniske forhold Som teknisk driftsmodel benyttes TDM Central Internet.NET. Driftsmodellen består af klientmiljø og 2 servermiljøer. Servermiljøerne er sammensat af to teknologier:.net og Z/OS. Z/OS rummer al forretningslogik og data. Som middleware benyttes ZSRØR. TDM en kan kun anvendes til sagsbehandlerapplikationerne og dermed til applikationer, der betjener brugere, som er kendt i RACF og som er tilsluttet CAP/IP-nettet. KMD benytter MQ Series. Løsningen vil anvende 1 MQ køer, som vil indeholde besked om, at der er lagt data i svar køen. Er Anvender it-leverandør for flere Myndigheder, anvendes samme MQ-forbindelse for alle Myndigheder. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 10 af 14
6 Inddata og uddata 6.1 Indkomstoplysninger, synkrone opslag (enkelt forespørgsel) Denne del af løsningen giver Anvender mulighed for ved online opslag at hente oplysninger om enkeltperson. De udstillede oplysninger er beskrevet i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. Anvender indsender en forespørgsel på hver person, der ønskes oplysninger om. Løsningen med synkrone opslag (enkelt forespørgsel) er ikke forberedt for automatiseret masse-kald. 6.1.1 Årsopgørelsesoplysninger Der leveres de oplysninger, der er registreret om personen i årsopgørelsen for det i forespørgsel angivne Fradato-år. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. 6.1.2 Forskudsopgørelsesoplysninger Der leveres de oplysninger, der er registreret om personen i forskudsopgørelsen for det i forespørgsel angivne Fradato-år. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. 6.1.3 Inddata Forespørgslen skal have indhold, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. 6.1.4 Uddata For hver forespørgsel leveres et svar med indhold, som som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. 6.2 Indkomstoplysninger, asynkrone opslag (masse forespørgsel) Denne del af løsningen giver Anvender mulighed for at hente oplysninger om flere personer. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. Anvender indsender personnumre på de personer, der ønskes oplysninger om. Svarene sendes senere efter behandling fra KMD. 6.2.1 Årsopgørelsesoplysninger Der leveres de oplysninger, der er registreret om personen i årsopgørelsen for det i forespørgsel angivne Fradato-år. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. 6.2.2 Forskudsopgørelsesoplysninger Der leveres de oplysninger, der er registreret om personen i forskudsopgørelsen for det i forespørgsel angivne Fradato-år. De udstillede oplysninger er omtalt i Indkomstgrænseflade_P13_5_Feltoversigt, se Referenceoversigt. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 11 af 14
6.2.3 Inddata Forespørgslen indeholder en header del efterfulgt af en personkredsindeholdende CPR numre på de personnumre, der ønskes oplysninger om. Forespørgslen skal have indhold, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. Løsningen kvitterer for modtagelsen eller giver en fejlbesked for hver forespørgsel, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. De modtagne, ikke-fejlbehæftede, personnumre bliver behandlet dagligt i henhold til KMDs driftsplan. 6.2.4 Uddata For hvert, ikke-fejlbehæftet personnummer i forespørgslen leveres et svar med indhold, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. Fejlbehæftede personnummer er anført, uden svarinformationer, med sigende svarkode og tekst, nederst i svaret. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 12 af 14
6.3 Advis om årsopgørelse Denne del af løsningen giver Myndighed mulighed for at modtage advis om ændringeri årsopgørelser. Myndighed fremsender én separat forspørgsel for hver kombination af Myndighed, sagsområde og funktion. Forespørgslen er gældende indtil den ændres af Myndigheden. Det forudsættes endvidere, at Myndigheden har aftalt med KMD Indkomst om at sende advis til dennes Anvender. Løsningen giver ikke CPR advis i nogen form. 6.3.1 Advis, inddata 6.3.1.1 Personkreds Myndighed fremsender én separat forspørgsel for hver kombination af Myndighed, sagsområde og funktion. Om hver person indsendes oplysninger, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. Den modtagne personkreds vil overskrive alle tidligere, som har samme kombination af Myndighed, sagsområde og funktion. Personkredse kan IKKE opdateres via deltameddelelser. Løsningen kvitterer for modtagelsen eller giver en fejl besked for hver forespørgsel, som beskrevet i snitfladebeskrivelserne, se Referenceoversigt. 6.3.2 Advis, uddata 6.3.2.1 Årsopgørelsesoplysninger Der adviseres om de 3 skatteår, som KMD Indkomst understøtter. Der gives advis ved følgende ændringer: 1. Tilgang pga. flytning. 2. Tilgang pga. personnummer skift (det nye personnummer står i strukturen). 3. Oprettelse (tilgang af person, der ikke i forvejen er registreret i pågældende år). 4. Ajourføring (almindelig ligningsmæssig ændring af en eksisterende person). Der gives ikke advis ved afgang pga. fraflytning. Et advis om årsopgørelse indeholder de felter, der fremgår af årsopgørelsen. Oversigt over tilgængelige felter findes på KMDs kundenet. 6.3.3 Driftsplan KMD udstiller en driftsplan som angiver tidspunkt for rettidig indberetning af personkredsen samt tidpunkt for afsendelse af leverancen. Driftsplanen kan ses på KMDs kundenet under KMD Indkomst. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 13 af 14
7 Bilag: Strukturer Strukturer er beskrevet i snitfladebeskrivelserne, se Referenceoversigt. Indkomstgrænseflade_P13_5_Løsningsbeskrivelse_v009 Side 14 af 14