Snitfladebeskrivelse for MQService IndkomstMasseForspoergsel. KMD Indkomst, P13-5. Version 8.0,

Transkript

1 Snitfladebeskrivelse for MQService IndkomstMasseForspoergsel KMD Indkomst, P13-5 Version 8.0,

2 Indholdsfortegnelse Ændringer i forhold til forrige version Brug af snitfladebeskrivelsen Formål og målgrupper Formålet med standardsnitfladen Målgrupper Informationer i snitfladen Standardsnitfladens arkitektur Systemskitse Servicemål Forretningsmæssigt grundlag Teknisk implementering Beskrivelse Snitfladeoversigt MQ Tegnsæt Betingelser for anvendelse af standardsnitfladen Tilslutningsaftale... 7 Garantier Struktur for dataudveksling Hvilke datastrukturer skal anvendes? MQ Pakning MQ_PREHEADER Definition af MQ_TRANSMISSION_FLAG Definition af MQ_TRANSMISSION_ID Definition af MQ_SEKVENS_NR Eksempel på MQ_PREHEADER Indkomstoplysninger, inddata + kvittering / fejlbesked Header Personforespørgsel Kvittering eller fejlbesked på forespørgsel Kvittering på forespørgsel Fejlbesked på forespørgsel KMD - Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.

3 8.4 Indkomst- og formueforhold, uddata Header Svar Fast del, pr person Variabel del Advis-personkreds, inddata + kvittering / fejlbesked Header Advis-person Kvittering på advis-personkreds Fejlbesked på advis-personkreds Advis om årsopgørelse Header Svar Fast del, pr person Variabel del, pr person Validering af data Validiteten af forespørgselsdata Håndtering af fejl Sikkerhed Autentifikation Autorisation BILAG A. Eksempler KMD - Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.

4 Ændringer i forhold til forrige version Dokumentrevision Dato Udarbejdet af Kommentar Version nr HHK Første version HHK Version 1.1 mindre tekstuelle justeringer HHK Første version til review hos KOMBIT/UDK HHK Tilrettet med kommentarer modtaget fra KOMBIT HHK I afsnit Header pr person forklaringen til felt SEKVENS_NR_PERSON ændret fra adderes med 1 for hver ny felt til adderes med 1 for hver ny person 004 I afsnit Svar, Variabel del FELT_LEDETEKST ændres O/M fra O til M HHK Justeret med KOMBITs kommentarer. 005 Fjernet felterne RECORD_TYPE, SEKVENS_NR_VAR_DEL og FELT_LEDETEKST fra afsnit Svar, Variabel del og felterne RECORD_TYPE, SEKVENS_NR_PERSON_DET og FELT_LEDETEKST OMO Et antal rettelser knyttet til endelig release OMO Rettelser jvf KOMBIT kommentarer til releasede dokumenter. Alle dokumenter fjernes OMO Eksempel input 02: Hvis AY ikke er relevant for anvenderne, så synes jeg, det skal slettes. KMD: Rettet i V0008i I har glemt at håndtere en enkelt kommentar i afsnit i feltet ANTAL. Der står nævnt, at det angives på fem tegn, hvilket skal slettes. KMD: Rettet i V0008 Side 3

5 1 Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse er en del af beskrivelsen af snitfladen KMD INDKOMST, P13-5. Den samlede beskrivelse består af: Snitfladebeskrivelse i sammenhæng. 1) Løsningsbeskrivelsen er henvendt til myndigheden (kommune / Udbetaling Danmark). 2) WEBService IndkomstEnkelForespoergsel, som indeholder en beskrivelse af synkrone forespørgsler om indkomstoplysninger. Beskrivelsen er henvendt til myndighedens it-leverandør. 3) MQService IndkomstMasseForespoergsel, som indeholder en beskrivelse af asynkrone masseforespørgsler om indkomstoplysninger og advis om ændringer i indkomstoplysninger. Beskrivelsen er henvendt til myndighedens it-leverandør. 4) Feltoversigt, som indeholder en liste over de indkomstfelter, som KMD INDKOMST, P13-5 kan levere. Beskrivelsen er henvendt til myndigheden og til myndighedens itleverandør. 5) Tegning over sammenhæng mellem MQ records (kun MQService Indkomst- MasseForespoergsel). Tegningen er henvendt til myndighedens it-leverandør. 6) Beskrivelse af fejlkoder. Beskrivelsen er en del af aftalen med KMD A/S om brug af standardsnitfladen KMD INDKOMST, P13-5. Den er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem myndighedens it-leverandør og KMD A/S om standardsnitfladens anvendelse. KMD forbeholder sig rettighederne til snitfladebeskrivelsen. Snitfladebeskrivelsen kan udlånes af myndigheden til myndighedens it-leverandør i forbindelse med etablering af snitfladen samt ved fremtidige ændringer. Udlån til andre leverandører. Snitfladebeskrivelsen må anvendes af myndigheden og af KOMBIT i udbudsmateriale. Henvendelser vedrørende standardsnitfladen rettes til: Team Indkomst Telefon Mail kmdindkomst@kmd.dk Kontakt til KMD A/S. Side 4

6 2 Formål og målgrupper 2.1 Formålet med standardsnitfladen Formålet med snitfladen er at beskrive kommunikationen mellem det kaldende system og KMD Indkomst ved asynkrone opslag. Snitfladen anvendes til at hente indkomstoplysninger i KMD Indkomst om en personkreds (der spørges om ét til mange CPR-numre og der modtages informationer om det forespurgte antal CPR-numre). Såfremt der er behov for online opslag anvendes servicen WEBIndkomstEnkelt- Forespoergsel. 2.2 Målgrupper De primære målgrupper er: De ansvarlige for KMD Indkomst i KMD A/S. Alle myndigheder, som har licens til at bruge KMD Indkomst (kommuner, Udbetaling Danmark). Myndighedens it-leverandører, der skal bruge denne snitflade ved løsning af en opgave for myndigheden (i det følgende kaldt Anvender ). KOMBIT, som har stillet opgaven. Side 5

7 3 Informationer i snitfladen Snitfladen stiller følgende informationer til rådighed: Indkomstoplysninger i årsopgørelsesregistret, seneste 3 kalenderår. Indkomstoplysninger i forskudsregistret, indeværende år og det kommende skatteår (når dette foreligger). samt advis om: Ændringer i årsopgørelsesregistret, seneste 3 kalenderår. Side 6

8 4 Standardsnitfladens arkitektur 4.1 Systemskitse Udbetaling Danmark (UDK) UDK KMD Serviceplatformen Kommunen MQ MQ Mainframe Serviceplatformen 4.2 Servicemål Denne snitflade anvender it-systemet KMD Indkomst til at skaffe indkomstoplysninger. KMD Indkomst anvender services, som SKAT udstiller og er derved underlagt de muligheder og begrænsninger, som dette medfører. Nedenstående tal er resultater fra KMDs afprøvning af masseforespørgsel i produktion, men uden at trafikken til/fra serviceplatformen har været del i testen. På baggrund af nedenstående sættes maks antal CPR numre i en masseforespørgsel til stk Personer Start 21: Personer Start 23:45 AY Put i local remote kø 6 min 9 sek 2 min 9 sek AY Indlæsning til DB 3 min 31 sek 5 min 17 sek AY460 - Opret + validering 3 min 11 sek 2 sek AY Hent Indkomst data - årsopgørelse 2 timer 48 min 2 timer 5 min AY480 - Dan svar på lokal kø 1 min 18 sek 1 min 15 sek Side 7

9 Antal personer / minut Forretningsmæssigt grundlag Denne snitflade leverer data fra følgende registre: SKATs forskudsregister, som afvikles hos SKATs it-leverandør. Kopi af årsopgørelsesregistret i KMD Indkomst, som føres på KMD. Man kan læse mere om KMD Indkomst på KMDs kundenet under Systembrugere KMD Indkomst. Side 8

10 5 Teknisk implementering 5.1 Beskrivelse Denne snitflade leverer indkomstoplysninger og advis ved asynkrone opslag. Anvender skal i hver forespørgsel anvende den tildelte MQ-kø. Navnet på MQ-køen oplyses, når en aftale indgås med KMD indkomst. I forespørgslen angiver Anvender, hvilken personkreds (én til flere personer), hvilke oplysninger og for hvilken periode, der ønskes oplysninger om. Endvidere angives det formål, hvortil oplysningerne skal anvendes samt data til at sikre revisionsspor. Snitfladen giver adgang til de under punkt 3 nævnte indkomstoplysninger. Fejlberørte forespørgsler afvises med angivelse af årsag. 5.2 Snitfladeoversigt MQService: IndkomstMasseForespoergsel 5.3 MQ KMD anvender IBM WebSphere MQ for z/os. Der anvendes standard MQ funktionalitet 5.4 Tegnsæt Der benyttes EBCDIC (Codepage 277). Side 9

11 6 Betingelser for anvendelse af standardsnitfladen 6.1 Tilslutningsaftale 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 forpligter sig til kun at kommunikere om personer, der er dækket af den indgåede aftaler. 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 og understøtte de revisionsspor, som benyttes af KMD. Myndigheden, som Anvender er it-leverandør for, skal have indgået de nødvendige aftaler med SKAT og KMD for at snitfladen kan fungere. Se Løsningsbeskrivelsen. Side

12 7 Garantier KMD A/S forpligter sig til, at vedligeholde standardsnitfladen i overensstemmelse med transitionsaftalen (TSA) med KOMBIT. Ændringer i snitfladen varsles med 3 måneder. Ved lovændringer, der påvirker anvendelsen af snitfladen, kan de 3 måneders varsel bortfalde. Side 11

13 8 Struktur for dataudveksling 8.1 Hvilke datastrukturer skal anvendes? De følgende afsnit specificerer datastrukturerne anvendt i forskellige sammenhænge. 8.2 MQ Pakning De enkelte strukturer fremsendes enkeltvis. For at sikre at strukturerne kan sammenkædes tilføjes nedenstående strukturer på alle records MQ_PREHEADER Alle transmissioner via MQ skal påføres en MQ_PREHEADER: MQ_TRANSMISSION_FLAG: Char 5 MQ_TRANSMISSION_ID: Char 18 MQ_SEKVENS_NR: Char Definition af MQ_TRANSMISSION_FLAG En transmission kan bestå af flere MQ records. MQ_TRANSMISSION_FLAG oplyser arten af informationen indenfor transmissionen, og har en længde på fem karakterer. Status START Beskrivelse Når der sendes en START meddelelse udtrækkes et nyt MQ_Transmission_ID. Meddelelsen indeholder KUN MQ_PREHEADER FORTS SLUT (+1 blanke) I FORTS meddelelser er beskeden hæftet på efter MQ_PREHEADER. Når alle data er sendt sendes en SLUT meddelelse. Meddelelsen indeholder KUN MQ_PREHEADER Side 12

14 Definition af MQ_TRANSMISSION_ID Unik nøgle som sikrer, at data kan sammenkædes over flere records. Ved enhver ny transmission skal det sikres at MQ_TRANSMISSION_ID er unik. Nøglen defineres ved: Sub felt Navn Kort beskrivelse Længde 1 DATO_DEL Sættes dagligt i formatet ÅÅÅÅMMDD. Eksempel: TRANSAKTION_NR Tæller på ti cifre. Total Definition af MQ_SEKVENS_NR Sub felt Navn Kort beskrivelse Længde 1 MQ_SEKVENS_NR Tæller på ti cifre. Der tælles op ved hver ny transmision. MQ_SEKVENS_NR Total Eksempel på MQ_PREHEADER Dette eksempel udgør en samlet MQ-transaktion. Der anvendes standard MQ funktionalitet. Explecit kan nævnes at modtager skal gennemføre validering af korrekt sekvens og der fremsendes standard MQ fejlmeddelelser ved huller i sekvensen. Se grænse beskrevet i afsnit 4.2 Besked nr. MQ Preheader Besked 1 START FORTS Besked 1 3 FORTS Besked 2 4 FORTS Besked 3 5 SLUT Side 13

15 8.3 Indkomstoplysninger, inddata + kvittering / fejlbesked Forespørgsel til indkomst- og formueforhold indeholder en header og mindst én personforespørgsel. Ved asynkrone opslag kan der være mere end én Personforespørgsel under samme Header. Alle felter skal udfyldes i overensstemmelse med skemaet. Hvis forespørgslen ikke består KMD-Validering, se afsnittet herom, for så vidt angår informationer i headeren returneres én fejlmeddelelse. Fejl og statusmeddelelser er beskrevet i dokumentet Beskrivelse af fejlkoder. Dokumentet er tilgængeligt på KMDs kundenet Header I efterfølgende beskrivelser angiver M Mandatory, O Optional. Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_INDKO_HEAD" 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. SAGSOMRAADE M Kode der angiver det sagsområde, som oplysninger skal bruges til. Følgende værdisæt må anvendes: F = Økonomisk friplads B = Boligstøtte D = Sygedagpenge N = Barselsdagpenge C = Aktiv beskæftigelsesindsats L = Introduktionsydelse M = Repatriering E = Fleksydelse A = Social pension K = Delpension G = Social service H = Børnetilskud O = Børnebidrag I = Opkrævning af sociale og beskæftigelsesmæssige ydelser samt familieydelser J = Boliganvisning 1 Side 14

16 Felt M/O Forklaring Længde MYNDIGHEDS_ CVR_NUMMER M CVR-nummer på den forespørgende myndighed. 8 FUNKTION M Kode der angiver, hvilken type indkomst-oplysninger, der ønskes leveret: 21 = Årsopgørelsesoplysninger 40 = Forskudsopgørelses-oplysninger 2 Der leveres den gældende version af årsopgørelse eller forskud. Der er ingen historik på tidligere versioner. FRA_DATO M Generel anvendelse: Angivelse af start skatte år i formatet "ÅÅÅÅ-01-01". Eksempel: " " (år 2014). FRA_DATO må ikke være før 1. januar i dagsdatos år minus 3 år. TIL_DATO M TIL_DATO angives som ÅÅÅÅ-MM-DD, eksempel: TIL_DATO skal være samme år(åååå) som FRA_DATO. TIL_DATO må ikke være før FRA_DATO. ANTAL_PERSONER M Angiver antal af personer i den specifikke MQ transaktion. Der foranstilles "0". Eksempel: " " Personforespørgsel Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_INDKO_PERS". 15 SEKVENS_NUMMER M Løbenummer som angiver PERSON_NUMMER placering i forespørgsel. Angives på ti tegn og stigende fra 1. Der foranstilles "0". Eksempel: " ". PERSON_NUMMER M På de(n) person(er), som Myndigheden ønsker oplysninger om. Eksempel: Side 15

17 8.3.3 Kvittering eller fejlbesked på forespørgsel Forespørgslen valideres og alt efter resultatet af valideringen fremsendes enten kvittering eller fejlbesked. Kvittering fremsendes når forespørgslen er valideret. Efterfølgende gennemføres simpel validering af de medsendte person numre. Der fremsendes IKKE kvittering eller fejlbesked på denne simple validering. Invalide person numre returneres samtidigt med svar på valide person numre. Både valide og invalide person numre vil være påført SVAR_KODE og SVAR_TEKST. Fejlbesked fremsendes såfremt forespørgslen er invalid. Der gennemføres ikke validering af de medsendt person numre. SVAR_KODE og SVAR_TEKST er beskrevet i dokumentet Beskrivelse af fejlkoder, se KMD kundenet Kvittering på forespørgsel Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_INDKO_KVIT". 15 TIMESTAMP M Fra headeren i forespørgslen. 26 TRANSAKTIONSID M Fra headeren i forespørgslen. 36 MYNDIGHEDS_ CVR_NUMMER M Fra headeren i forespørgslen. 8 SAGSOMRAADE M Fra headeren i forespørgslen. 1 AARSAG_KODE M Gældende status og fejlkode, se dokument Beskrivelse af fejlkoder på KMD Kundenet. AARSAG_TEKST M Kort tekst der beskriver årsagen, se dokument Beskrivelse af fejlkoder på KMD Kundenet. ANTAL M Antal records, inkl. afviste angives på ti tegn. Der foranstilles "0". Eksempel: Side 16

18 8.3.5 Fejlbesked på forespørgsel Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_INDKO_FEJL". 15 TIMESTAMP M Fra headeren i forespørgslen. 26 TRANSAKTIONSID M Fra headeren i forespørgslen. 36 MYNDIGHEDS_ CVR_NUMMER M Fra headeren i forespørgslen. 8 SAGSOMRAADE M Fra headeren i forespørgslen. 1 AARSAG_KODE M Gældende status og fejlkode, se dokument Beskrivelse af fejlkoder på KMD Kundenet. AARSAG_TEKST M Kort tekst der beskriver årsagen, se dokument Beskrivelse af fejlkoder på KMD Kundenet. ANTAL M Angives på ti tegn. Der foranstilles Eksempel:" ". 141 Side 17

19 8.4 Indkomst- og formueforhold, uddata For hver forespørgsel leveres et svar i nedenstående struktur Header Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "SVAR_INDKO_HEAD". 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. MYNDIGHEDS_ CVR_NUMMER M CVR-nummer på den forespørgende myndighed. Eksempel: " ". 8 ANTAL_PERSONER M Angiver antal af personer i forespørgslen. Der foranstilles "0". Eksempel: " ". 95 Side 18

20 8.4.2 Svar Fast del, pr person Fast del (en forekomst pr person pr årsopgørelse eller forskud) + variable dele (en forekomst pr. <FELT_NUMMER>. Bemærk der fremsendes kun felt værdi for felt med indhold. Beløbsfelter med værdi 0 fremsendes ikke. Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "SVAR_INDKO_FAST". 15 SEKVENS_NR_FAST_DEL M Angives på ti tegn. Der foranstilles "0". Tælleren nulstilles for hver ny header. Eksempel :" ". PERSON_NUMMER M På de(n) person(er), som Myndigheden ønsker oplysninger om. Eksempel: " ". AEGTEFÆLLE_CPR O Den forespurgte persons ægtefælle i følge årsopgørelsen ved årets slutning. Ved funktion 40, angives Eksempel: " ". Ved ingen ægtefælle udyldes med FRA_DATO M Generel anvendelse: Angivelse af start skatte år i formatet "ÅÅÅÅ-01-01". Eksempel: " " (år 2014). TIL_DATO M Generel anvendelse: Angivelse af slut skatte år i formatet "ÅÅÅÅ-12-31". Eksempel: " " (år 2014). KILDE M Kode, der angiver typen af feltets indhold: 01: ÅRSOPGØRELSE 02: FORSKUDSOPGØRELSE SVAR_KODE M Svarkoder er beskrevet i dokumentet Beskrivelse af fejlkoder, se KMD kundenet. 2 5 SVAR_TEKST M Tekst der kort beskriver svarkoden. 40 ANTAL_SVAR M Angiver hvor mange variable dele der er til svarets faste del. Angives på ti tegn. Der foranstilles "0". Eksempel :" " 122 Side 19

21 Variabel del Én forekomst pr. felt pr. forespurgt person Felt M/O Forklaring Længde FELT_TYPE M Kode, der angiver typen af feltets indhold: 1 for tekst, kan indeholde en tekst på op til 40 tegn. 2 for heltal, kan være i mellem for decimaltal, skal være i mellem FELT_NUMMER M Angives på fem tegn. Der foranstilles "0". Eksempel KMD Indkomst udstiller en liste over forekommende feltnumre, se dokumentet Indkomstgrænseflade_P13_5_Feltoversigt på KMD kundenet BELOEB_FORTEGN O Beløbsfortegn. Kun udfyldt ved felttype 2+3, "+" eller "-". Ved værdi nul udfyldt med +. 1 I øvrige felttyper er feltet blankt,. FELTVAERDI_BELOEB O Beløb, kun udfyldt ved felttype 3. Beløb angives med foranstillede 0 og komma "," på pos 14. Eksempel: " ,91". 16 Ved felttyper forskellig fra 3, udfyldes feltet som 0. Eksempel " ,00". Hvis årstal angives med felttype 3, så vil årstallet være med 2 decimaler. FELTVAERDI_DAGE O Ved felttype 2 udfyldes værdien. Angives på fem tegn. Der foranstilles "0 5 Eksempel: "00219". Ved felttyper forskellig fra 2, udfyldes feltet med 0 : Eksempel "00000". FELTVAERDI_KODE_TEKST O Feltets indhold. Kun udfyldt ved felttype 1. I øvrige tilfælde vil feltet være blankt, Side 20

22 8.5 Advis-personkreds, inddata + kvittering / fejlbesked Indberetning af personkreds til advisering indeholder en header efterfulgt af mindst én person der ønskes advis om. Alle felter skal udfyldes i overensstemmelse med skemaet. Ved annullering af bestående personkreds fremsendes en forespørgsel bestående af kun Header og ingen Advis person. Validering af modtaget forespørgsel, fremsendelse af kvittering eller fejlbesked gennemføres som beskrevet i afsnit Header Felt O/M Forklaring Længde RECORD_TYPE M Værdi: "FSPG_ADVIS_HEAD". 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. SAGSOMRAADE M Kode der angiver det sagsområde, som oplysninger skal bruges til. Følgende værdisæt må anvendes: F = Økonomisk friplads B = Boligstøtte D = Sygedagpenge N = Barselsdagpenge C = Aktiv beskæftigelsesindsats L = Introduktionsydelse M = Repatriering E = Fleksydelse A = Social pension K = Delpension G = Social service H = Børnetilskud O = Børnebidrag I = Opkrævning af sociale og beskæftigelsesmæssige ydelser samt familieydelser J = Boliganvisning 1 MYNDIGHEDS_ CVR_NUMMER M CVR-nummer på den forespørgende myndighed. Eksempel: " ". 8 Side 21

23 Felt O/M Forklaring Længde FUNKTION M Kode der angiver, hvilken type indkomst-oplysninger, der ønskes advis om: 92 = Årsopgørelsesoplysning ANTAL_PERSONER M Angiver antal af personer i den specifikke MQ transaktion. Der foranstilles "0". Eksempel: " " Side 22

24 8.5.2 Advis-person Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_ADVIS_PERS" 15 SEKVENS_NR_ADVIS_PERS M Løbenummer som angiver PERSON_NUMMER placering i forespørgsel. Angives på ti tegn og stigende fra 1. Der foranstilles "0. Eksempel: " ". PERSON_NUMMER M CPR-nummer på den person, der ønskes advis om. Eksempel: Kvittering på advis-personkreds Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_ADVIS_KVIT". 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. MYNDIGHEDS_ CVR_NUMMER M CVR-nummer på den forespørgende myndighed. Eksempel: " ". 8 SAGSOMRAADE M Fra headeren i forespørgslen. 1 AARSAG_KODE M Gældende status og fejlkode, se dokument Beskrivelse af fejlkoder på KMD Kundenet. AARSAG_TEKST M Kort tekst der beskriver årsagen, se dokument Beskrivelse af fejlkoder på KMD Kundenet. ANTAL M Antal records, inkl. afviste, angives på ti tegn. Der foranstilles "0. Eksempel: Side 23

25 8.5.4 Fejlbesked på advis-personkreds Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "FSPG_ADVIS_FEJL". 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. MYNDIGHEDS_ CVR_NUMMER M CVR-nummer på den forespørgende myndighed. Eksempel: " ". 8 SAGSOMRAADE M Fra headeren i forespørgslen. 1 AARSAG_KODE M Gældende status og fejlkode, se dokument Beskrivelse af fejlkoder på KMD Kundenet. AARSAG_TEKST M Kort tekst der beskriver årsagen, se dokument Beskrivelse af fejlkoder på KMD Kundenet. ANTAL M Angives på ti tegn. Der foranstilles Eksempel:" ". 141 Side 24

26 8.6 Advis om årsopgørelse Header Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "SVAR_ADVIS_AHEA". 15 TIMESTAMP M Timestamp for forespørgslen genereres af Anvender. Format: ÅÅÅÅ-MM-DD-TT.MM.SS.XXXXXX 26 Eksempel: TRANSAKTIONSID M Unik transaktionsid genereres af Anvender. 36 Genereres efter Anvenders valg af standard. Eksempel: de305d54-75b4-431b-adb2-eb6b9e Feltets indhold valideres ikke af MQService IndkomstMasseForespoergsel. MYNDIGHEDS_CVR_NUMM ER M CVR-nummer på den forespørgende myndighed. Eksempel: " ". 8 ANTAL_PERSONER M Angiver antal af personer i den specifikke MQ transaktion. Der foranstilles "0". Eksempel: " ". 95 Side 25

27 8.6.2 Svar Fast del, pr person Om hver ny og ændret årsopgørelse leveres en forekomst i nedenstående struktur: Fast del (en forekomst pr person pr årsopgørelse) + variable dele (en forekomst pr. <FELT_NUMMER>. Bemærk der fremsendes kun felt værdi for felt med indhold. Beløbsfelter med værdi 0 fremsendes ikke. Felt M/O Forklaring Længde RECORD_TYPE M Værdi: "SVAR_ADVIS_APER". 15 SEKVENS_NR_PERSON M Tæller. Starter ved 001, og adderes med 1 for hver ny person i leverancen. Angives på ti tegn. Der foranstilles 0. Nulstilles for hver header record. Eksempel: " ". PERSON_NUMMER M På de(n) person(er), som Myndigheden ønsker oplysninger om. Eksempe: AEGTEFAELLE_CPR M Den forespurgte persons ægtefælle ifølge årsopgørelsen ved årets slutning for det sidste år der adviseres om. Eksempel: " ". Ved ingen ægtefælle udyldes med FRA_DATO M Generel anvendelse: Angivelse af start skatte år i formatet "ÅÅÅÅ-01-01". Eksempel: " " (år 2014). TIL_DATO M Angivelse af slut skatteår i formatet ÅÅÅÅ-12-31, ÅÅÅÅ skal være det samme som i FRA_DATO. Eksempel: " ". KILDE M Årsopgørelsen, værdi = SVAR_KODE M Svarkoder er beskrevet i dokumentet Beskrivelse af fejlkoder, se KMD kundenet. 5 SVAR_TEKST M Tekst der kort beskriver svarkoden. 40 ANTAL_DETALJER M Antallet af detaljer for givent CPR-nummer, Eksempel :" ". 122 Side 26

28 Variabel del, pr person For hver <FELT_NUMMER>, dannes én detail-record. Felt M/O Forklaring Længde FELT_TYPE M Kode, der angiver typen af feltets indhold: 1 for tekst, kan indeholde en tekst på op til 40 tegn. 2 for heltal, kan være i mellem for decimaltal, skal være i mellem FELT_NUMMER M Angives på fem tegn. Der foranstilles "0". Eksempel KMD Indkomst udstiller en liste over forekommende feltnumre, se dokumentet Indkomstgrænseflade_P13_5_Feltoversigt på KMD kundenet BELOEB_FORTEGN O Beløbsfortegn. Kun udfyldt ved felttype 2+3, "+" eller "-". Ved værdi nul udfyldt med +. 1 I øvrige felttyper er feltet blankt,. FELTVAERDI_BELOEB O Beløb, kun udfyldt ved felttype 3. Beløb angives med foranstillede 0 og komma "," på pos 14. Eksempel: " ,91". 16 Ved felttyper forskellig fra 3, udfyldes feltet som 0. Eksempel " ,00". Hvis årstal angives med felttype 3, så vil årstallet være med 2 decimaler. FELTVAERDI_DAGE O Ved felttype 2 udfyldes værdien. Angives på fem tegn. Der foranstilles "0 5 Eksempel: "00219". Ved felttyper forskellig fra 2, udfyldes feltet med 0 : Eksempel "00000". FELTVAERDI_KODE_TEKST O Feltets indhold. Kun udfyldt ved felttype 1. I øvrige tilfælde vil feltet være blankt, Side 27

29 9 Validering af data 9.1 Validiteten af forespørgselsdata De forretningsmæssige valideringer kan inddeles i: Simpel validering: Datatyper, formater, mandatory data, værdisæt herunder grænseværdier og tilladte værdier fra kodelister, samt periodetjek. Udvidet validering: Sammenhængsvalidering og validering mod tabeller i KMD Indkomst. Regler for feltudfyldelse og datalængder fremgår af afsnit 8 Struktur for dataudveksling. 9.2 Håndtering af fejl Der kan opstå tre forskellige typer af fejl i forbindelse med kald til KMD MQService IndkomstMasseForespørgsel: Transportorienterede fejl i forbindelse med eksekvering af den startede transaktion, f.eks. at dele af den benyttede infrastruktur ikke er tilgængelig eller tekniske fejl. Formatfejl, hvor den modtagne besked ikke opfylder de krav til format og indhold, som er beskrevet i afsnit 8 Struktur for dataudveksling. Forretningsmæssige fejl, hvor den modtagne besked ikke opfylder de krav til indhold og formalia, som er beskrevet i afsnit Sekvensen for validering er flg.: 1. Såfremt beskeden ikke kan committes af afsender fremkommer en fejlmeddelelse fra MQ 2. Beskedens indhold valideres op mod de gældende formatdefinitioner. 3. Beskedens indhold valideres efter forretningsmæssige regler. Kun hvis der ikke er konstateret fejl i et trin, fortsættes til næste valideringstrin. Det betyder, at en besked kan indeholde flere fejl end der gives besked om. Side 28

30 Sikkerhed.1 Autentifikation For at benytte KMD MQService IndkomstMasseForespørgsel skal der indgåes en tilslutningsaftale mellem KMD og Anvender. Mellem serviceportalen og P13-5 snitflader anvendes VPN. Det er uafklaret hvilken kommunikation/sikkerhed, som skal anvendes mellem UDK og P13-5 snitflader..2 Autorisation Ud fra den dedikerede MQ-forbindelse som benyttes af Anvender mappes til en systembruger defineret i KMDs sikkerhedssystem (KSP/CICS). Systembrugeren repræsenterer Anvender, og KMD sikrer ved indgåelse af anvenderaftale med serviceaftageren, at den relevante bruger er oprettet og givet de nødvendige rettigheder til at kunne konsumere snitfladen. Side 29

31 11 BILAG A. Eksempler Se eksempler herunder. Vi har ikke nogen eksempler på MQ messege descriptor indhold, men vi bruger ikke standard MQ felterne. I stedet er der lagt MQPREHEADER ind i beskeden. Max størrelsen på beskeder, som vi kan modtage er begrænset af, at vi kun modtager enten en START record, en header record, en person record, eller en SLUT record i hver besked. HEADER beskeden er den længest struktur vi modtager, så max størrelsen på beskeder vi kan modtage er MQ_PREHEADER(33) + HEADER(118) = 151 tegn. Når vi leverer svar tilbage til Anvender har består den største mulige besked af MQ_PREHEADER(33) + Svar fast del(122) + X * Felt strukturen(69). I vores programmer er der en grænse på 400 felter, hvilket give en maksimal længde på *69 = tegn. Jvf afsnit 4.2 er der fastsat en grænse på personer der må sendes inden for samme MQ_TRANSMISSION_ID altså i samme bunke. Masseforespørgsel: Masseforespørgsel-Input-2.txt Masseforespørgsel-Output-2.txt Masseforespørgsel vejledning Microsoft Word Document Advisforspørgsel: Advis_eksemple_til_K ombit.txt Advisforespørgsel-Input-Output-2.txt Side 30