Snitfladebeskrivelse KMD Social Pension til Ny Familieydelsesløsning Version 4.0, 03.05.2017
Indholdsfortegnelse Indholdsfortegnelse 1. Ændringer i forhold til forrige version... 2 2. Brug af snitfladebeskrivelsen... 2 3. Formål og målgrupper... 3 Formålet med snitfladen... 3 Målgrupper... 3 4. Snitfladens arkitektur... 3 5. Teknisk implementering... 4 6. Protokol for dataudveksling... 4 Personkreds i dataudveksling... 4 Opbygning af datastrømmen... 6 Datastrukturer... 6 Dataformater/tegnsæt... 8 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 Versionsoversigt Version Dato Oprettet/ændret af Beskrivelse af ændring 0.1 25.08.2016 BEB 1. version 0.2 27.09.2016 BEB Værdisæt for pensiontype er ændret: Type 97 er udgået. Type 96 Opsat pension- dækker både lønmodtager/selvstændig Type 98 er lig med repatriering Afsnit 6: Passus indsat om at det er det modtagne system, som er ansvarlig for kun at benytte og opbevare data som er relevante for at kunne beregne og udbetale særligt børnetilskud 1.0 27.10.2016 BEB Header og trailer indsat 2.0 16.12.2016 TLP Værdisæt for pensionstype er ændret: Tilføjet Pensionstype 00 (Modtager ikke pension) og rettet tekst til Pensionstype 01(Modtager ikke pension -> Invaliditetsydelse 3.0 24.04.2017 TLP Tilføjet defaultværdi til datastruktur tabel s. 7,8 4.0 03.05.2017 TLP Tilføjet dataset navn s. 8 2. Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse udgør grundlaget for indgåelse af konkrete aftaler med Ny Familieydelsesløsning om udveksling af data med KMD Social Pension. Der er tale om en midlertidig snitflade indtil Ny Familieydelsesløsning kan få leveret de nødvendige data via en snitflade til Ny Pensionsløsning. Den er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem Ny Familieydelsesløsning 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. Udlån til andre leverandører Henvendelser vedrørende KMD Børneydelse rettes hos KMD til: Business Line Manager, Familieydelser, KMD Ballerup Lautrupparken 40-42 2750 Ballerup Telefon: 44 60 10 00 05-07-2017 Side 2
Formål og målgrupper 3. Formål og målgrupper Formålet med snitfladen Der ydes et særligt børnetilskud for et barn under 18 år, når en af eller begge barnets forældre modtager førtidspension tilkendt før 1.1.2003 eller modtager folkepension. Ny familieydelsesløsning har behov for information fra KMD Social Pension til brug for beregning og udbetaling af dette særligt børnetilskud til pensionister. Målgrupper Ny Familieydelsesløsning, KMD Børneydelse, Udfasningsprojektet for KMD Social Pension og KMD Social Pension. 4. Snitfladens arkitektur KMD Social Pension danner med ugentlig frekvens et sekventielt udtræk, som via SFTP forsendes til Ny Familieydelsesløsning. Ugentligt udtræk Start Dan udtræk Til fil Læs personkreds Beregn Social Pension Skriv Social Pension Dan fil Og send til STFP KMD Social Pension FY Netcompany Ny Personkredstabel Social Pension Kommaseparere t fil Slut 05-07-2017 Side 3
Teknisk implementering 5. Teknisk implementering Eksekvering: Batch. Kanal: Sekventiel fil. Medie: Datasæt leveret via SFTP. 6. Protokol for dataudveksling Personkreds i dataudveksling Til brug for dannelse af det sekventielle udtræk etablerer KMD Social Pension en tabel indeholdende den personkreds som senest er fremsendt til KMD Børneydelser via den eksisterende snitflade mellem de to løsninger. Tabellen vedligeholdes efterfølgende med de personer som bliver oprettet som folkepensionister eller overgår fra førtidspension til folkepension i KMD Social Pension. Tabellen vil indeholde alle personer som overgår fra førtidspension til folkepension uanset pensionstype. Frasortering af ikke relevante personer skal ske hos modtagersystemet. Der leveres dog kun aktive sager herunder også en frasortering af sager, hvor retten til pension bortfalder. Det forudsættes, at modtagersystemet kun opbevarer og gør brug af data som er relevante for beregning og udbetaling af det særlige børnetilskud til pensionister. 05-07-2017 Side 4
Protokol for dataudveksling Etablering af personkreds (Engangsjob) Etablering KMD Social Pension Læs eksisterende personkreds Seneste leverance Skriv personkreds Ny Personkredstabel Slut Vedligehold personkreds Vedligeholdelse KMD Social Pension Opret hhv. Stop bevilling Pensionsbevilling Opret person på personkredstabel Ny Personkredstabel Slut 05-07-2017 Side 5
Protokol for dataudveksling Opbygning af datastrømmen KMD Social Pension leverer ugentligt et udtræk til Ny Familieydelsesløsning indeholdende den definerede personkreds. Der leveres oplysninger om pensionist og evt. samlever i form af personnummer, virkningsdato, pensionstype, samlivsstatus, indtægt og bortfaldsgrænse pensionstillæg. Hver record indeholder oplysninger om 2 kvartaler, indeværende kvartal og forrige kvartal. Datastrukturer Header Felt Dataformat Beskrivelse Leverandør (18) Fast tekst KMD Social Pension System (16) Fast tekst Ny Familieydelse Dannet (16) YYYY-MM-DD-HH.MM Tidspunkt for dannelse af fil Data Felt Personnummer Virkningsdato_i Pensionstype_i Datafor mat (02) Beskrivelse Personnummer på pensionist i KMD Social Pension Virkningsdato for indeværende kvartal yyyy-mm-dd Pensionstype: Art/tekst: Default-værdi Altid udfyldt yyyy-mm-dd 00 00 Modtager ikke pension 01 Invaliditetsydelse 13 Mellemste førtidspension 14 Højeste førtidspension 16 Forhøjet 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 91 Midlertidig bortfaldet førtidspension 93 Midlertidig bortfaldet folkepension 05-07-2017 Side 6
Protokol for dataudveksling 96 Opsat folkepension lønmodtager/selvstændig 98 Repatriering Samlivstatus_i (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 (1 blanktegn) Partner_i Partner_pensio ns-type_i Indtægt_penstil -læg_i Bortfaldsgræns e_ pensionstillæg_i Virkningsdato_f Pensionstype_f Samlivstatus_f Partner_f Partner_pensio ns-type_f Indtægt_penstil -læg_f (02) (02) (01) (02) Personnummer på ægtefælle/samlever i KMD 0000000000 Social Pension Som pensionstype ovenfor 00 Pensionisten indtægt pensionstillæg. Hvis ægtefællens/samleverens indtægt skal påvirke indtægtsgrundlaget, indgår også dennes indtægt i beløbet. Årligt beløb i hele 100 kr. Bortfaldsgrænse for pension. Årligt beløb i hele 100 kr. 0000000000 0000000000 Virkningsdato forrige kvartal yyyy-mm-dd yyyy-mm-dd Samme værdisæt som Pensionstype_i 00 Samme værdisæt som Samlivstatus_i (1 blanktegn) Personnummer på ægtefælle/samlever i KMD 0000000000 Social Pension Som pensionstype ovenfor 00 Pensionisten indtægt pensionstillæg. Hvis ægtefællens/samleverens indtægt skal påvirke indtægtsgrundlaget, indgår også dennes indtægt i beløbet. 0000000000 05-07-2017 Side 7
Årligt beløb i hele 100 kr. Bortfaldsgræns e_ pensionstillæg_ f Bortfaldsgrænse for pension. Årligt beløb i hele 100 kr. 0000000000 Trailer Felt Dataformat Beskrivelse Tekst (16) Fast tekst Antal records Antal (08) Antal records på denne fileksklusiv header og trailer Format: 99999999 Dataformater/tegnsæt Der leveres med fast rekordlængde. Datasæt-navn: KFS.H.E83300D.Dyyyymmdd.txt For at sikre at data afleveres korrekt og for ikke at få problemer med danske specialtegn som æ, ø og å anvendes CodePage 1252. 05-07-2017 Side 8