Lohn AG

[#1]

Dit document beschrijft de  ‘Lohn AG - Visma Raet Payroll API’-connector. De connector is door LohnAG gebouwd bovenop de Youforce Payroll API 

De interface bestaat uit 2 hoofdstromen:

1. Medewerkergegevens van HR Core Business naar Lohn AG
   
   
2. Salarisstroken terug vanuit Attentia naar het personeelsdossier in Youforce

1 - MEDEWERKERGEVENS NAAR LOHN AG

Medewerkergegevens

De basis medewerkergegevens bestaan uit de volgende velden.

Lohn AG Veld	Verplicht	API Endpoint	API Endpoint / Field	HRCB field
Personalnr	Ja	employee	upi	7014 - Uniek persoonlijk Id (Upi)
Vorname	Ja	employee	FirstNames	51 - voornamen
Nachname	Ja	employee	LastNameToUse	524 - opgemaakte naam aanhef
Geburtsname	Ja	employee	LastNameAtBirth	24 - Achternaam
Alias	Ja	employee	KnownAs	165 - Roepnaam
NamenZusatz		employee	Title	94 - Titel voor
Geschlecht	Ja	employee	Gender	36 - Geslacht
Geburtsdatum	Ja	employee	DateOfBirth	35 - Geboorte datum
GeburtsOrt	Ja	employee	PlaceOfBirth	7363 - Geboorte plaats
Strasse	Ja	employee	personData/addresses/street + number (type = Home)	391 - Straat 392 - Huisnummer
Adresszusatz		employee	Addition	393 - huisnummer toevoeging
Plz	Ja	employee	ZipCode	394 - Postcode
Ort	Ja	employee	City	395 - Woonplaats
Staat	Ja	employee	Country	34 - Woonland
EMail	Ja	employee	EmailAddresses	7212 e-mailadres
Staatsangehoerigkeit	Ja	employee	PrimaryNationality	10204761 -Nationaliteit
Identifikationsnr	Ja	employee (Germany only)	TaxIdentificationNumber	10525942 - Belastingidentificatie nummer
BeginnTaetigkeit	Ja	employee	HireDate	39 - datum indienst
EndeTaetigkeit		employee	DischargeDate	10520479 - Geplande laatste datum indienst
VertragsformID		employee (Germany only)	ContractType	10525565 - Contract type
Taetigkeit		employee (Germany only)	WorkingAs	10525582 - Werkzaam als (DE)
Rentenversicherungsfreiheit		employee (Germany only)	Certificationofpensioninsuranceexemption	10525562 - Certificaat vrijstelling pensioenverzekering (DE)
RentenversicherungAufstockung		employee (Germany only)	Certificationofincreasedpensioninsurance	10525559 - Certificering verhoogde pensioenverzekering (DE)
ElterneigenschaftNachweis		employee (Germany only)	Certificationofparenthood	10525561 - Certificering van ouderschap (DE)
Kinderfreibetrag		employee (Germany only)	Childtaxcredit	10525560 - Belastingvermindering voor kinderen (DE)
GrenzgaengerLand		employee (Germany only)	Crossborderworker	10525566 - Grensarbeider (DE)
Schwerbehindert		employee (Germany only)	Degreeofdisability	10525567 - Arbeidsongeschiktheidspercentage (DE)
AusbildungsID		employee (Germany only)	EducationDegree	10525568 - Opleidingsgraad (DE)
GruppeID		employee (Germany only)	EmployeeGroup	10525569 - Medewerkergroep (DE)
VersicherungsStatus		employee (Germany only)	HealthInsuranceType	10525571 - Type ziektekostenverzekering (DE)
SchulabschlussID		employee (Germany only)	LevelOfEducation	10525572 - Opleidingsniveau (DE)
ZusaetzlicheArbeitsvehaeltnisse		employee (Germany only)	MainEmploymentAtOtherEmployer	10525574 - Hoofdbetrekking bij andere werkgever (DE)
KrankenkasseName		employee (Germany only)	HealthInsuranceName	10525575 - Naam (DE)
KrankenkasseOrt		employee (Germany only)	HealthInsurancePlace	10525576 - Plaats (DE)
Kirche		employee (Germany only)	Religion	10525577 - Religie (DE)
Steuerklasse		employee (Germany only)	TaxGroup	10525578 - Belastinggroep (DE)
Krankenkasse		employee (Germany only)	HealthInsuranceWith	10525571 - Type ziektekostenverzekering (DE)
Sollzeit	Ja	employee	WorkingAmount	465 - Uren periode
KalendarischeArbeitstage	Ja	employee	WorkingDays	464 - Dagen periode
KalendarischeArbeitstageMoStunden	Ja	employee	WorkingPattern DayIndexNumber == 1	HR Werkpatroon Maandag
KalendarischeArbeitstageDiStunden	Ja	employee	WorkingPattern DayIndexNumber == 2	HR Werkpatroon Dinsdag
KalendarischeArbeitstageMiStunden	Ja	employee	WorkingPattern DayIndexNumber == 3	HR Werkpatroon Woensdag
KalendarischeArbeitstageDoStunden	Ja	employee	WorkingPattern DayIndexNumber == 4	HR Werkpatroon donderdag
KalendarischeArbeitstageFrStunden	Ja	employee	WorkingPattern DayIndexNumber == 5	HR Werkpatroon Vrijdag
KalendarischeArbeitstageSaStunden	Ja	employee	WorkingPattern DayIndexNumber == 6	HR Werkpatroon Zaterdag
KalendarischeArbeitstageSoStunden	Ja	employee	WorkingPattern DayIndexNumber == 7	HR Werkpatroon Zondag
Iban	Ja	employee	IBAN	7755 - IBAN (1)
Kontoinhaber		employee	AccountOwner	10001091 - Land beginstigde (1)
Swift		employee	BIC	7745 - BIC (1)
Lohngrundart	Ja	employee	BasicWage	10300579 - Salaris
KostenstellenName		employee	CostAllocationName	53 - kostenplaats
KostenstellenBezeichner		employee	CostAllocationTitle	53 - kostenplaats
VersicherungsNr		employee (Germany only)	SocialSecurityNumber	10525941 - Sociaal verzekeringsnummer (DE)
VermoegenswirksameLeistungen		employee (Germany only)	CapitalAccumulationBenefits	10525558 - Kapitaalopbouwvoordelen (DE)
FirmenPKW		employee (Germany only)	CompanyCar	10525564 - Auto van de Zaak (DE)
Kindergartenzuschuss		employee (Germany only)	ChildDaycareAllowance	10525563 - Tegemoetkoming kinderopvang (DE)
BetrieblicheAltersvorsorge		employee (Germany only)	EmployerFundedPension	10525570 - Werkgeverspensioen (DE)
Fahrtkosten		employee (Germany only)	TravelAllowance	10525579 - Reiskostenvergoeding (DE)
Gutschein		employee (Germany only)	Vouchers	10525580 - Cheques (DE)
Lohnbestandteil Name		fixed payment	FixedPayments PayComponent	See list HR Core Business
Lohnbestandteil Wert		fixed payment	FixedPayments Value	See list HR Core Business
Lohnbestandteil GültigVon		fixed payment	FixedPayments ValidFrom	See list HR Core Business
Lohnbestandteil GültigBis		fixed payment	FixedPayments ValidTo	See list HR Core Business
Lohnbestandteil Name		employee benefits	Benefits PayComponent	See list HR Core Business
Lohnbestandteil Wert		employee benefits	Benefits Value	See list HR Core Business
Lohnbestandteil GültigVon		employee benefits	Benefits ValidFrom	See list HR Core Business
Lohnbestandteil GültigBis		employee benefits	Benefits ValidTo	See list HR Core Business
Monatsbewegungsdaten Name		employees one-off	OneOffPayments PayComponent	See list HR Core Business
Monatsbewegungsdaten Wert		employees one-off	OneOffPayments Value	See list HR Core Business
Monatsbewegungsdaten Monat		employees one-off	OneOffPayments Date	See list HR Core Business

Arbeidsvoorwaarden, vergoedingen & inhoudingen

Binnen de API is een generieke structuur ontwikkeld voor de arbeidsvoorwaarden, vergoedingen & inhoudingen (vast / Periode) en vergoedingen & inhoudingen (eenmalig/dag).

Welke velden als arbeidsvoorwaarden, vergoedingen & inhoudingen in de API zijn opgenomen wordt bepaald door het HR Core systeem. Op dit moment is dit een vaste lijst met element die beheert wordt door HR Core.
Uitbreidingen op deze lijst (zie  HR Core Business velden) kunnen aangevraagd worden bij HR Core. 

Duitse schermen

Voor Payroll Duitsland is een specifieke arbeidsvoorwaarde aangemaakt met de algemene medewerker en contractgevens welke nodig zijn voor de integratie met Lohn AG.
Dit betreft het arbeidsvoorwaarde scherm integratie Duitsland 

Autorisatie filters

Op dit moment kan er alleen gefilterd worden op bedrijf. 
Bij het onboaden van een nieuwe klant kan aangegeven worden welke bedrijven er in de koppeling meegenomen moeten worden.

Momenteel worden de filters nog in samenspraak met de API consultants door development ingericht. Dit maakt echter onderdeel uit van de onboarding van een nieuw klant op deze interface.

2 - SALARISSTROKEN NAAR YOUFORCE

De salarisstroken worden vanuit Lohn AG via de Payroll API geupload naar het personeelsdossier.