TLN - AANLEVER- EN ONTVANGSTSPECIFICATIE VOOR WERKGEVERS Achmea ISelect VERSIE 0.1
1 DATAMODEL... 3 1.1 Werknemers... 3 2 METHODE 1: CSV... 6 2.1 Inleiding... 6 2.2 Bestandsoverdracht: CSV via Arbeidsvoorwaardenportaal... 6 2.3 Aanleverspecificatie CSV-bestand Werknemers... 6 2
1 DATAMODEL 1.1 Werknemers 1.1.1 Velden Volgorde Veldkop Veldtype Omschrijving Verplicht 1. PERSONEELSNUMMER String Personeelsnummer (sleutel). Unieke waarde binnen bedrijf. J 2. VOORNAAM String Roepnaam of voorletters J 3. VOORVOEGSEL String Voorvoegsel(s) (bv. van der ) N 4. ACHTERNAAM String Achternaam J 5. GESLACHT String M of V (iets anders geldt als onbekend) N 6. STRAATNAAM String Straatnaam N 7. HUISNUMMER String Huisnummer N 8. HUISNUMMER_TOE String Huisnummer toevoeging N 9. POSTCODE String Postcode N 10. WOONPLAATS String Woonplaats N 11. GEBOORTEDATUM Datum Geboortedatum N 12. EMAIL String E-mailadres t.b.v. initiele registratie J 13. DID Datum Datum in dienst (anciënniteitsdatum) N 14. DUD Datum Datum uit dienst (laatste dag werkzaam) N 15. PT_FACTOR Decimaal Parttime factor (waarde tussen 0 en 1). N 16. UURLOON Decimaal Bruto uurloon (tbv (ver)koop verlofuren). Waarde in. N 17. MAANDSALARIS Decimaal Bruto maandsalaris (betaalsalaris) inclusief arbeidsvoorwaardelijke correcties (zoals J correctie parttime of onbetaald verlof), inclusief eventuele vaste toeslagen en/of vergoedingen.. Waarde in. 18. LOONHEFFINGSKORTING Boolean Indicatie toepassen loonheffingskorting ( lege waarde, geen waarde of 0 = False, N waarde 1= True) 19. PKB_SPAARSALDO Decimaal Actueel PKB-spaarsaldo (geldig voor de actuele periode) J 20. PERIODE Short Terugwerkende kracht correcties doorvoeren, neem hiervoor contact op met Iselect N 21. JAAR Short Terugwerkende kracht correcties doorvoeren, neem hiervoor contact op met Iselect N
1.2 Productkeuzes 1.2.1 Velden Volgorde Veldkop Veldtype Omschrijving 1. COMPANYID String Referentie bij welke werkgever medewerker hoort (sleutel) 2. PERSONEELSNUMMER String Personeelsnummer (sleutel). Unieke waarde binnen COMPANYID. 3. VOORNAAM String Voornaam 4. VOORVOEGSEL String Voorvoegsel 5. ACHTERNAAM String Achternaam 6. COMPANYPRODUCTCODE String ProductCode zoals bekend bij werkgever 7. ISELECTPRODUCTCODE String ProductCode zoals gedefinieerd door Iselect 8. WAARDE Decimal Waarde 9. WAARDETYPE String WaardeType ( Uren of Geld ) 10. LOONCODE String LoonCode zoals bekend bij werkgever 11. ISELECTLOONCODE String LoonCode zoals gedefinieerd door Iselect 12. KEUZEDATUM Datum Datum waarop keuze is gemaakt 13. STARTDATUMVERWERKINGSPERIODE Datum Startdatum van de verwerkingsperiode waarvoor de keuze is gemaakt 14. EINDDATUMVERWERKINGSPERIODE Datum Einddatum van de verwerkingsperiode waarvoor de keuze is gemaakt 15. VERWERKINGSPERIODENUMMER Short Verwerkingsperiode 16. VERWERKINGSJAAR Short Verwerkingsjaar 1.2.2 IselectProductCodes en IselectLoonCodes IselectProductCode IselectLoonCode Omschrijving UitbetalenPKB ISEL001 Eenmalige uitbetaling spaarsaldo in actuele periode (tijdvaktabel) ISEL099 Eenmalige uitbetaling spaarsaldo in actuele periode (bijzonder tarief) ISEL002 Waarde tbv afboeking spaarsaldo payroll 4
KopenVerlof ISEL003 Aantal gekochte uren tbv payroll ISEL004 Aantal gekochte uren tbv bijboeking verlofkaart ISEL005 Waarde aankoop tbv payroll ISEL006 Waarde aankoop tbv afboeking spaarsaldo payroll ISEL001 Eenmalige uitbetaling spaarsaldo in actuele periode (tijdvaktabel) ISEL099 Eenmalige uitbetaling spaarsaldo in actuele periode (bijzonder tarief) Studiekosten ISEL019 Eenmalige bruto inhouding studiekosten ISEL020 Eenmalige netto vergoeding studiekosten ISEL021 Waarde tbv afboeking spaarsaldo payroll ISEL001 Eenmalige uitbetaling spaarsaldo in actuele periode (tijdvaktabel) ISEL099 Eenmalige uitbetaling spaarsaldo in actuele periode (bijzonder tarief) 5
2 METHODE 1: CSV 2.1 Inleiding Bij deze methode biedt de werkgever het de werknemergegevens aan in een CSV-bestand ( comma separated value bestand). De in de keuzemodule door de werknemer gemaakte productkeuzes worden door het systeem ook weer aan de werkgever aangeboden als CSVbestand. Achmea-iSelect biedt twee mogelijkheden voor de bestandsoverdracht van de CSV s. Deze mogelijkheden zullen in de volgende paragrafen besproken worden. 2.2 Bestandsoverdracht: CSV via Arbeidsvoorwaardenportaal Als eerste is het voor de werkgever mogelijk het CSV-bestand in het Arbeidsvoorwaardenportaal te uploaden. De door de werknemers gemaakte productkeuzes zullen ook via ditzelfde portaal beschikbaar gesteld worden als download. Omdat het portaal enkel via https beschikbaar is, zijn de bestanden op transportniveau versleuteld. 2.3 Aanleverspecificatie CSV-bestand Werknemers 2.3.1 Bestandsspecificatie Het door de werkgever aan te leveren CSV-bestand dient aan de volgende specificaties te voldoen: Velden dienen te worden gescheiden door een puntkomma (en dus géén komma, tab of ander scheidingsteken); Eventueel mag een veld worden omsloten met dubbele quotes, maar dit is niet verplicht; Als er een puntkomma in de veldinhoud voorkomt, dient het veld omsloten te worden met dubbele quotes; Als er een dubbele quote in de veldinhoud voorkomt, dient het veld omsloten te worden met dubbele quotes, en dient de dubbele quote in de veldinhoud voorafgegaan te worden (ge-escaped) door een extra dubbele quote; 6
Indien de inhoud karakters bevat die niet binnen de ASCII karakterset vallen (denk hierbij aan vreemde tekens, zoals é of ë ), dient het bestand gecodeerd te zijn in Windows-1252 / ANSI Latin I; Alle gangbare regelscheidingstekens (<CR>, <LF>, <CR><LF>) worden ondersteund; Zowel een komma als punt worden ondersteund als decimaal scheidingsteken; Duizendtalscheidingstekens worden niet ondersteund; De ondersteunde datumnotatie is DD-MM-JJJJ, waarbij voorloopnullen bij dagen en maanden niet verplicht zijn; Een kopregel (met de veldnamen) is niet verplicht; Als er geen kopregel wordt gebruikt, dienen alle velden aanwezig te zijn, op de volgorde zoals gespecificeerd in de volgende paragraaf; Als er wel een kopregel wordt gebruikt, dienen de veldnamen exact overeen te komen met de specificatie in de volgende paragraaf. De veldnamen zijn niet hoofdlettergevoelig; Als er wel een kopregel wordt gebruikt, hoeven enkel de verplichte velden aanwezig te zijn, en is de volgorde niet van belang; Het is toegestaan om lege regels in het CSV-bestand te hebben. 2.4 Ontvangstspecificatie CSV-bestand Productkeuzes 2.4.1 Bestandsspecificatie Het te ontvangen CSV-bestand voldoet aan de volgende specificaties: Velden worden gescheiden door een puntkomma; Het bestand is gecodeerd in Windows-1252; Als regelscheidingstekens wordt de <CR><LF>-combinatie toegepast; Het bestand bevat een kopregel met de veldnamen. 7
3 METHODE 2: KOPPELING MET SALARISSYSTEMEN 3.1 Inleiding Veel van de grotere salarissystemen (denk aan Afas, Loket.nl, ADP, enz.) bieden web services aan waar via een beveiligde verbinding de voor Iselect benodigde werknemergegevens opgehaald kunnen worden, en waar de productkeuzes naartoe teruggekoppeld kunnen worden. Dit elimineert de noodzaak van het handmatig uit te voeren proces met de CSV s, en automatiseert kortom dit hele proces, zodat u er geen omkijken naar heeft. Wij zullen per situatie, aan de hand van uw eigen inrichting, moeten bekijken hoe zo n koppeling gelegd kan worden. Informeer gerust bij Iselect naar de mogelijkheden. 8