Payroll koppeling
Talentech Nmbrs koppeling: medewerkers, contracten en salarissen uit Talentech naar Nmbrs
Met een koppeling tussen Talentech en Nmbrs gaan medewerkers, contracten, salarissen en ontslagen van de Nederlandse entiteit uit de HR-module van Talentech naar het juiste Nmbrs-bedrijf, met de ingangsdatum uit Talentech. Het personeelsnummer uit Nmbrs gaat terug naar Talentech, zodat beide systemen dezelfde medewerker herkennen.
Wat de koppeling doet
Noord-Europese groepen die Talentech gebruiken voor recruitment en HR, en een Nederlandse entiteit in Nmbrs laten verlonen, voeren contracten en salarissen nu twee keer in. Een nieuw contract dat in Talentech pas volgende maand ingaat, staat soms al eerder in Nmbrs.
- KoppelHet leest elk uur medewerkers, posities, contracten, salarissen en ontslagaanvragen uit Talentech.
- De juridische entiteit van de positie bepaalt of de medewerker naar Nmbrs gaat, en naar welk bedrijf.
- Een nieuwe werknemer komt met contract, uren en salaris in Nmbrs; het personeelsnummer gaat terug naar Talentech.
- Een salaris of contract met een latere ingangsdatum gaat naar de Nmbrs-periode van die datum.
- Een ontslagaanvraag zet de datum uit dienst in Nmbrs.
Terug: Het personeelsnummer uit Nmbrs komt als extern kenmerk bij de medewerker in Talentech.
Waar je op let bij Talentech en Nmbrs
- Een salaris in Talentech bestaat uit een bedrag, een valuta en een ingangsdatum, zonder aanduiding of het om een maand-, jaar- of uurbedrag gaat. Bij de start spreken we af hoe de organisatie salarissen vastlegt; KoppelHet controleert daarna of een bedrag in die orde van grootte past voordat het naar Nmbrs gaat.
- Contracten in Talentech hebben een vlag voor contracten die nog moeten ingaan, naast uren per week en een berekende deeltijdfactor. KoppelHet zet een toekomstig contract met zijn begindatum klaar in Nmbrs, zodat het in de juiste periode ingaat en niet eerder.
- In Talentech hangt een medewerker aan een positie, en de positie hoort bij een juridische entiteit. Die entiteit bepaalt het Nmbrs-bedrijf. Wisselt iemand van positie naar een andere entiteit, dan maakt Talentech een nieuw contract en volgt in Nmbrs een uitdienst bij het ene en een indienst bij het andere bedrijf.
- Talentech slaat nationale identiteitsnummers op met het land erbij. KoppelHet neemt alleen het nummer met land Nederland als BSN; een Zweeds of Noors persoonsnummer gaat niet naar Nmbrs.
- Medewerkers in Talentech kunnen kenmerken van externe systemen krijgen. KoppelHet schrijft het Nmbrs-personeelsnummer daar terug, zodat een tweede ronde of een herstart nooit een dubbele werknemer in Nmbrs maakt.
- Een ontslagaanvraag in Talentech heeft een ontslagdatum, een laatste werkdag en een einddatum van het dienstverband. Nmbrs krijgt de einddatum van het dienstverband als datum uit dienst; de laatste werkdag blijft in Talentech.
- Talentech heeft geen vast veld voor een bankrekening. Een IBAN kan in een eigen veldsectie per medewerker staan; anders vult het salarisbureau het in Nmbrs aan. Een positie kan wel een cao hebben, en die naam geeft KoppelHet mee als controle voor het bureau.
- Elke API van Talentech vraagt eigen scopes, en klanten vragen API-toegang aan via hun accountmanager; Talentech meldt dat sommige API's extra kosten. Voor deze koppeling vragen we alleen leesrechten op medewerkers, posities, contracten, salarissen en ontslagen, plus schrijfrechten voor het externe kenmerk.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Welk Talentech-product is dit?
De HR-module met medewerkers, posities, contracten en salarissen, die Talentech via de PeopleCore API ontsluit. Recruitment in Talentech staat los van deze koppeling.
Wat blijft bij het salarisbureau?
Loonheffingskorting, pensioen, de cao-inrichting en de loonrun. De koppeling levert de mutaties en overschrijft die instellingen niet.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Talentech wordt gelezen via de PeopleCore API (https://api.talentech.io/peoplecore) met een JWT van auth.talentech.io/connect/token (client credentials). Endpoints GET /v1/Employees (HasResigned, nationalIds, externalSystemIdentifiers), /v1/Positions (organizationInformation.legalEntityId, collectiveAgreement), /v1/Contracts (contractType, startDate, endDate, indefinite, weeklyHours, fullTimeEmployment, isForFuture), /v1/Salaries (amount, currency, effectiveDate; gepagineerd), /v1/EmployeeResignApplications (resignationDate, lastDayOfWork, employmentEndDate) en /v1/LegalEntities. Terugschrijven via PUT /v1/Employees/{employeeId}/externalSystemIdentifiers.
- Scopes onder meer peoplecore-employees:read en :write, peoplecore-positions:read, peoplecore-contracts:read, peoplecore-salaries:read, peoplecore-resignations:read en peoplecore-organization:read.
- Naar Nmbrs schrijven we via de Nmbrs REST API met OAuth 2.0 en een login op werkgeversniveau. De SOAP API stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Talentech | Veld in Nmbrs | Toelichting |
|---|---|---|
Medewerker-id en externe kenmerken | Personeelsnummer | Nmbrs-nummer terug als extern kenmerk |
Persoonsgegevens (voornaam, achternaam, geboortedatum, geslacht) | Persoonsgegevens | |
Privéadres | Adres | |
Nationaal id met land NL | BSN | |
Juridische entiteit van de positie | Nmbrs-bedrijf | Via een vertaaltabel |
Contract (contractType, startDate, endDate, indefinite) | Dienstverband en contract | |
weeklyHours | Rooster en uren per week | |
Salaris (amount, currency, effectiveDate) | Salaris met ingangsperiode | |
Ontslag (employmentEndDate) | Datum uit dienst |
Gerelateerd
Recruitee → Talentech
Recruitee Talentech koppeling: aangenomen kandidaten met contract op een positie in Talentech
Talentech → Active Directory
Talentech Active Directory koppeling: accounts in je eigen domein vanuit PeopleCore
Talentech → ADP iHCM
Talentech ADP iHCM koppeling: salarissen en ontslagaanvragen uit PeopleCore naar de Nederlandse ADP-payroll
Talentech → AFAS Profit
Talentech AFAS koppeling: medewerkers, contracten en salarissen uit Talentech PeopleCore in AFAS