
Recruitment naar HR
Bullhorn Nmbrs koppeling: plaatsingen met uurloon en einddatum in de verloning
Met een koppeling tussen Bullhorn en Nmbrs wordt een nieuwe plaatsing in Bullhorn een medewerker met dienstverband in Nmbrs, met startdatum, uurloon of salaris, uren per dag en, bij een tijdelijke opdracht, de einddatum. Zo verloont het payrollteam in Nmbrs precies wat de recruiter in Bullhorn heeft afgesproken, zonder overtypen.
Wat de koppeling doet
Organisaties die mensen via Bullhorn plaatsen en de verloning in Nmbrs doen, krijgen van de recruiter een mail of formulier per plaatsing en zetten uurloon, uren en looptijd met de hand in Nmbrs. Een verlengde of vervroegd beëindigde opdracht komt vaak pas na de salarisrun bij payroll aan.
- De recruiter legt de plaatsing in Bullhorn vast met start, eventueel einde, uurloon en uren per dag.
- KoppelHet leest de nieuwe plaatsing uit de eventwachtrij en controleert het soort medewerker.
- KoppelHet kiest het Nmbrs-bedrijf dat bij de plaatsing hoort.
- In Nmbrs staan daarna medewerker, dienstverband, contract, loon en rooster.
- Payroll vult BSN en loonheffingsgegevens aan voordat de medewerker in de run komt.
Waar je op let bij Bullhorn en Nmbrs
- Een Placement in Bullhorn heeft een einddatum die bij een vaste plaatsing leeg is. KoppelHet maakt daarom in Nmbrs een contract voor bepaalde tijd als er een einddatum is, en een contract voor onbepaalde tijd als die ontbreekt.
- Bullhorn kent op de plaatsing zowel een uurtarief voor de kandidaat als een salaris met een eenheid per jaar of per uur. KoppelHet zet het uurtarief als uurloon in Nmbrs en rekent een jaarsalaris om, zodat het payrollteam niet hoeft te raden welk bedrag geldt.
- De plaatsing bevat het aantal uren per dag. Daarmee vult KoppelHet het rooster in Nmbrs, zodat vakantie-uren en parttimepercentage vanaf de eerste periode kloppen.
- Bullhorn heeft een veld payGroup voor de betaalfrequentie, bedoeld voor payrollkoppelingen. KoppelHet gebruikt het om het juiste Nmbrs-bedrijf te kiezen, bijvoorbeeld een aparte omgeving voor weekverloning van flexkrachten.
- In Nmbrs hoort een medewerker bij één bedrijf en wordt hij per bedrijf aangemaakt. Krijgt een kandidaat een tweede plaatsing in hetzelfde bedrijf, dan zoekt KoppelHet de bestaande medewerker op in plaats van een tweede aan te maken.
- Plaatsingen van zzp'ers of andere soorten die niet via Nmbrs worden verloond, filtert KoppelHet op het soort medewerker van de Placement. Die komen nooit in de salarisadministratie terecht.
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
Gaat een verlenging van de opdracht ook naar Nmbrs?
Niet in de eerste versie. Een nieuwe einddatum of een beëindiging doorgeven kan later als uitbreiding, met dezelfde eventwachtrij.
Wat doet ons payrollteam nog zelf?
BSN, loonheffingskorting en de cao-gegevens aanvullen, en de nieuwe medewerker controleren voor de run.
Werkt dit met meerdere Nmbrs-bedrijven?
Ja. Per betaalgroep in Bullhorn leggen we vast in welk Nmbrs-bedrijf de medewerker komt.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Bullhorn wordt gelezen via de REST API (OAuth 2.0, daarna REST-login met BhRestToken en een eigen basis-URL). Een subscription op entity Placement met eventTypes INSERTED vult de wachtrij; GET /event/subscription met maxEvents leest die uit. Velden via GET entity/Placement (dateBegin, dateEnd, employeeType, payRate, salary, salaryUnit, hoursPerDay, payGroup) en entity/Candidate.
- Naar Nmbrs schrijven we via de Nmbrs REST API met OAuth en de toestemming van het bedrijf in Nmbrs; eerst de medewerker per bedrijf, daarna adres, dienstverband, contract, rooster en loon. De SOAP API stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Bullhorn | Veld in Nmbrs | Toelichting |
|---|---|---|
Candidate.firstName en lastName | Voornaam, tussenvoegsel en achternaam | |
Candidate.dateOfBirth | Geboortedatum | |
Candidate.address | Adres | countryID bepaalt of het een buitenlands adres is |
Placement.dateBegin | Begindatum dienstverband | |
Placement.dateEnd | Einddatum contract | Leeg bij een vaste plaatsing: dan een contract voor onbepaalde tijd |
Placement.payRate | Uurloon | Alleen als het soort medewerker uurloon heeft |
Placement.salary en salaryUnit | Salaris | Bij een jaarbedrag omgerekend naar de periode van het Nmbrs-bedrijf |
Placement.hoursPerDay | Rooster | |
Placement.payGroup | Nmbrs-bedrijf | Via een vertaaltabel |
Gerelateerd
Bullhorn → AFAS Profit
Bullhorn AFAS koppeling: eerste plaatsing van een consultant start de onboarding
Bullhorn → BambooHR
Bullhorn BambooHR koppeling: eerste plaatsing als medewerker met statusregel in BambooHR
Bullhorn → Dayforce
Bullhorn Dayforce koppeling: eerste plaatsing van een werknemer als medewerker in Dayforce
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel