Indledende Snitfladebeskrivelse for udveksling af data fra Ny Pension Til KMD Børneydelse Version 0.2, 13.05.2016
Indholdsfortegnelse Indholdsfortegnelse Indholdsfortegnelse... 1 1. Ændringer i forhold til forrige version... 2 2. Brug af snitfladebeskrivelsen... 2 3. Formål og målgrupper... 2 Formålet med snitfladen... 2 Målgrupperne... 3 4. Snitfladens arkitektur... 3 Teknisk implementering... 3 Tekniske betingelser for anvendelse af snitfladen... 3 5. Protokol for dataudveksling fra Ny Pension til KMD Børneydelse... 4 Personkreds i dataudveksling... 4 Opbygning af datastrømmen... 4 Datastrukturer til anvendelse... 5 Dataformater/tegnsæt... 6 6. Validering af data... 7 Krav til validiteten af data... 7 Håndtering af fejl... 7 7. Sikkerhed... 7 KMD. Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.
Ændringer i forhold til forrige version 1. Ændringer i forhold til forrige version Dette dokument er nyoprettet version. V0.2: Der er indsat tegning under snitfladens arkitektur, der er indsat tegnsæt, og præciseret at der forsendes via en SFTP. 2. Brug af snitfladebeskrivelsen Kunden har bedt om en beskrivelse af den dataudveksling der kan blive behov for i det tilfælde at implementering af Ny Familieydelsesløsning kommer til at foregå senere end implementering af Ny Pensionsløsning. Den midlertidige dataudveksling skal dække behov i KMD Børneydelse for kendskab til indkomst for pensionister. Grundlag for indgåelse af aftaler Indeværende dokumentet skal fungere som et grundlag for evt. senere udarbejdelse af en snitfladebeskrivelse og snitflade. Dokumentet er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem Kunden og KMD om snitfladens anvendelse. Beskrivelsen må ikke overdrages eller kopieres i videre omfang end forudsat i ophavsretsloven men kun udlånes til softwareleverandører i forbindelse med etablering af snitfladen samt ved fremtidige ændringer. Henvendelser vedrørende KMD Børneydelse rettes hos KMD til: Udlån til andre leverandører Kontakt til KMD Business Line Manager, Familieydelser, KMD Ballerup Lautrupparken 40-42 2750 Ballerup Telefon: 44 60 10 00 3. Formål og målgrupper Formålet med snitfladen KMD Børneydelse har behov for information fra Ny Pension til brug for beregning og udbetaling af særligt børnetilskud til pensionister i henhold til Lov om børnetilskud og forskudsvis udbetaling af børnebidrag, 4, stk. 3, nr. 4 eller 5. Udpluk af loven: 4. Der kan endvidere ydes et særligt børnetilskud efter reglerne i stk. 2 og 3. Stk. 2. Der ydes 2 gange det særlige børnetilskud, jf. stk. 3, når ingen af barnets forældre lever. Stk. 3. Det særlige børnetilskud udgør 8.436 kr. årlig, 1) når faderskabet til barnet ikke er fastslået efter gældende regler, 2) når kun en af barnets forældre lever, 15-09-2016 Side 2
Snitfladens arkitektur 3) når barnet adopteres af en enlig person, 4) når en af eller begge barnets forældre modtager folkepension efter lov om social pension, 5) når folkepension til én eller begge af to forældre, der er berettigede til folkepension, ikke udbetales, fordi 46 i lov om social pension finder anvendelse, Målgrupperne Kunden, KMD Børneydelse og Ny Pension. 4. Snitfladens arkitektur Eksekvering: Batch. Kanal: Sekventiel fil. Medie: Datasæt leveret via SFTP. Forslag til indhold i dataudtrækket er dannet med afsæt i den nuværende snitflade (HK90052). Teknisk implementering Ny Pension danner med ugentlig frekvens et sekventielt udtræk, som via SFTP forsendes til modtagelse i KMD Børneydelse. Tekniske betingelser for anvendelse af snitfladen Datamodtagelsen er kun tilgængelig for KMD Børneydelse. 15-09-2016 Side 3
Protokol for dataudveksling fra Ny Pension til KMD Børneydelse 5. Protokol for dataudveksling fra Ny Pension til KMD Børneydelse Personkreds i dataudveksling Den personkredsen KMD Børneydelse har behov for at modtage oplysninger på, tager udgangspunkt i Lov om børnetilskud og forskudsvis udbetaling af børnebidrag 5 og 5a og beskrivelse af berettigelse til børnetilskud på www.borger.dk. Da en del af kriterierne for tildeling af særligt børnetilskud allerede er håndteret i KMD Børneydelse, ønsker KMD Børneydelse at modtage en så bred personkreds, at sandsynligheden for at alle relevante personer udtrækkes er størst. Derfor følgende forretningsregler for udtræk: Personen er folkepensionist, eller er tilkendt førtidspension efter reglerne, der gjaldt før 1. januar 2003 Personen har barn/børn under 18 år Hvis det viser sig at ovenstående kriterier giver anledning til en for stor datamængde, kan overvejes at tilføje yderligere regler, som f.eks. barnet bor på samme adresse. Opbygning af datastrømmen Ny Pension leverer ugentligt udtræk til KMD Børneydelse for den definerede personkreds. Pensionsudtrækket giver oplysninger om pensionstype, indtægt, bortfaldsgrænse mv. på samme måde som den nuværende snitflade mod Pension (HK90052). Strukturen består af en Header, Records med detailoplysninger og en Trailer. Header giver information om oprettelsestidspunkt (timestamp) for datasættet, f.eks. 2016-01-26-14.45.12.230000. Detailrecords indeholder information om pensionist og evt. samlever i form af pensionstype, indtægt og bortfaldsgrænse for indeværende og forrige kvartal. o Hver record indeholder oplysninger for 2 kvartaler, angivet ved Virkningsdato_i (indeværende kvartal) og Virkningsdato_f (forrige kvartal). Regelsæt for hvilke kvartaler/hvilken virkningsdato der skal opbygges oplysninger for, skal defineres af KMD Børneydelse og indbygges i Ny Pension. Trailer giver information om antal records, der er repræsenteret i udtrækket. 15-09-2016 Side 4
Protokol for dataudveksling fra Ny Pension til KMD Børneydelse Datastrukturer til anvendelse Header: Felt Dataformat Beskrivelse Individtype CHAR (02) Værdi = 00 Tidspunkt CHAR (26) Oprettelsestidspunkt (timestamp) yyyy-mm-dd-hh.mm.ss.ms0000 Filler CHAR (52) Buffer (rekordlængde: 80) Beløbsrecord: Felt Dataformat Beskrivelse Individtype CHAR (02) Værdi = 10 Personnummer CHAR (10) Personnummer på pensionist Virkningsdato_i CHAR (10) Virkningsdato for indeværende kvartal yyyy-mm-dd Pensionstype_i CHAR (02) Pensionstype: Art/tekst: 13 Mellemste førtidspension 14 Højeste førtidspension 16 Forhøjet almindelig førtidspension 18 Almindelig Førtidspension 25 Førtidspension 32 Folkepension med førtidsbeløb 33 Folkepension med invaliditetsbeløb Folkepension med invaliditets- og 34 erhvervsudygtighedsbeløb 35 Folkepension 36 Folkepension med invaliditetstillæg 91 Midlertidig bortfaldet førtidspension 93 Midlertidig bortfaldet folkepension 96 Opsat folkepension -lønmodtaget 97 Opsat folkepension selvstændig 98 Opsat folkepension engangsbeløb Samlivstatus_i CHAR (01) A = Gift - faktisk adskilt B = Gift - faktisk adskilt pga. plejehjemsophold C = Separeret - reelt enliger D= Enke/enkemand - reelt enlig E= Erklæret enlig F= Fraskilt - reelt enlig G= Gift / registreret partnerskab H= Enke/enkemand efter ægteskab, modt. I = Enke/enkemand efter samliv (Z), modt. J= Enke/enkemand efter samliv (S), modt. K= Enke/enkemand efter samliv (O), modt. 15-09-2016 Side 5
Protokol for dataudveksling fra Ny Pension til KMD Børneydelse O = Overgangsordning - før 26.04.1990 S = Samlevende - før 01.03.99 Z = Samlevende - efter 01.03.99 U = Uerklæret enlig - før 01.03.99 Partner_i CHAR (10) Værdi = 9999999999 eller blank Indtægt_penstil_i CHAR (10) Årlig indtægt i hele kroner Bortfald_penstil_i CHAR (10) Bortfaldsgrænse for pension i hele kroner Virkningsdato_f CHAR (10) Virkningsdato forrige kvartal yyyy-mm-dd Pensionstype_f CHAR (02) Samme værdisæt som Pensionstype_i Samlivstatus_f CHAR (01) A = Gift - faktisk adskilt B = Gift - faktisk adskilt pga. plejehjemsophold C = Separeret - reelt enliger D= Enke/enkemand - reelt enlig E= Erklæret enlig F= Fraskilt - reelt enlig G= Gift / registreret partnerskab H= Enke/enkemand efter ægteskab, modt. I = Enke/enkemand efter samliv (Z), modt. J= Enke/enkemand efter samliv (S), modt. K= Enke/enkemand efter samliv (O), modt. O = Overgangsordning - før 26.04.1990 S = Samlevende - før 01.03.99 Z = Samlevende - efter 01.03.99 U = Uerklæret enlig - før 01.03.99 Partner_f CHAR (10) Værdi = 9999999999 eller blank Indtægt_penstil_f CHAR (10) Årlig indtægt i hele kroner Bortfald_penstil_f CHAR (10) Bortfaldsgrænse for pension i hele kroner Adviskode_f CHAR (05) Samme værdisæt som Adviskode_i rekordlængde: 183 Trailer Felt Dataformat Beskrivelse Individtype CHAR (02) Værdi = 99 Antal CHAR (10) Antal rekords i alt Udfyldes med antal rækker i datasæt, uden header og trailer Filler CHAR (68) Buffer (rekordlængde: 80) Dataformater/tegnsæt Der leveres med fast rekordlængde. For at sikre at data afleveres korrekt og for ikke at få problemer med danske specialtegn som æ, ø og å anvendes CodePage 1252. Konvertering til EBCDIC-code foretages efter modtagelse. 15-09-2016 Side 6
Validering af data 6. Validering af data Data valideres efter gældende regler når de modtages og anvendes i KMD Børneydelse. Krav til validiteten af data N/A. Håndtering af fejl N/A. 7. Sikkerhed Der er tale om udveksling af oplysninger mellem 2 løsninger som begge driftsafvikles i KMD. Udvekslingen af oplysninger fra Ny Pension til KMD Børneydelse foregår via SFTP, som er tagget på de indadvendte VLANS. 15-09-2016 Side 7