Everhour logoNmbrs logo

Verlof, verzuim en uren

Everhour Nmbrs koppeling: goedgekeurde uren van uurloners als variabele uren, verlof terug in de planning

Met een koppeling tussen Everhour en Nmbrs gaan de geklokte uren van uurloners na goedkeuring van de week automatisch als variabele uren naar Nmbrs, op de juiste uurcode en in de lopende periode van het bedrijf. Goedgekeurd verlof uit Nmbrs komt als time off in Everhour, zodat de capaciteitsplanning er rekening mee houdt.

Wat de koppeling doet

Organisaties die uren en klokken in Everhour bijhouden en in Nmbrs verlonen, vaak met een salarisbureau, maken voor uurloners elke maand een urenoverzicht dat het bureau in Nmbrs overneemt. Verlof wordt in Nmbrs goedgekeurd en is in Everhour niet te zien.

  1. Medewerkers klokken in Everhour en dienen hun week in.
  2. Een beheerder keurt de week geheel of deels goed.
  3. KoppelHet zoekt per Everhour-gebruiker de medewerker en het bedrijf in Nmbrs.
  4. De goedgekeurde werktijd komt als variabele uren op de afgesproken uurcode in Nmbrs.
  5. Goedgekeurd verlof uit Nmbrs verschijnt als time off in Everhour.
Everhour → KoppelHet → NmbrsBRONEverhourDOELNmbrsKoppelHetmapping · logging · monitoringEverhour → KoppelHet → NmbrsBRONEverhourDOELNmbrsKoppelHetmapping · logging · monitoring
Heen: Geklokte werktijd per goedgekeurde dag · Variabele uren per uurcode en periode · Verlofsaldo als allocatie (terug, optioneel)
Terug: Goedgekeurd verlof als time off · Verlofsaldo per soort als allocatie, als jullie dat willen

Waar je op let bij Everhour en Nmbrs

  • Nmbrs kent een medewerker per bedrijf, Everhour één gebruiker per persoon in het hele account. Werken uurloners voor meerdere BV's, dan legt KoppelHet per gebruiker vast in welk Nmbrs-bedrijf de uren horen, zodat ze niet bij de verkeerde werkgever op de loonstrook komen.
  • Everhour heeft geen goedkeuringsmelding, en een week kan deels goedgekeurd zijn. KoppelHet vraagt elke week de status op, neemt alleen de dagen die in de goedkeuringshistorie zijn goedgekeurd, en controleert voor de periodeafsluiting in Nmbrs nog eens op late goedkeuringen.
  • Nmbrs neemt variabele uren aan in de lopende periode van het bedrijf, of in een eerdere periode met de unprotected mode. Een week die over twee periodes valt, splitst KoppelHet op de dag, en uren uit een al gesloten periode gaan naar de lopende periode.
  • Een urenregel in Nmbrs heeft een opmerkingveld. KoppelHet zet daar de Everhour-week en de gebruiker in. Komt dezelfde week na een correctie opnieuw binnen, dan boekt de koppeling alleen het verschil en niet de hele week nog een keer.
  • Nmbrs bewaart verlof met een status en met begin- en einduren voor een deel van de dag. Alleen goedgekeurd verlof gaat naar Everhour. Een halve dag in Nmbrs wordt een halve dag time off; past het aantal uren niet in de dagdelen van Everhour, dan volgt een melding.
  • Nmbrs heeft vier verlofsoorten, Type1 tot Type4, met een saldo per soort. Everhour kent eigen time off types met allocaties. KoppelHet koppelt elke Nmbrs-soort aan een Everhour-type, zodat bijvoorbeeld bovenwettelijk verlof apart zichtbaar blijft in de planning.

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, architectuur en compliance

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.

Prijsindicatie · Basis

Laat je zakelijke e-mailadres achter, dan zie je de prijsindicatie direct.

We gebruiken je adres alleen om je vraag over deze koppeling op te volgen.

Veelgestelde vragen

Moeten medewerkers met een vast salaris ook klokken?

Nee. De koppeling stuurt alleen uren van gebruikers die als uurloner zijn aangewezen. De rest blijft in Everhour voor projecten en planning.

Gaan nieuwe medewerkers uit Nmbrs automatisch naar Everhour?

Nee. Everhour laat geen gebruikers aanmaken via de API. Je nodigt ze uit in Everhour; de koppeling vindt ze daarna op e-mailadres.

Technische details voor IT

Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.

  • Everhour via api.everhour.com met X-Api-Key. GET /timesheets?weekId= (approval.status, approval.history[].days), GET /timecards (workTime en breakTime in seconden), GET /users. Time off via POST /resource-planner/assignments/time-off (timeOffType, timeOffPeriod, status approved); saldi via de allocation-endpoints. Webhooks zijn niet ondertekend en kennen geen goedkeuringsevent. Limiet 100 verzoeken per 10 seconden.
  • Nmbrs via de REST API met OAuth 2.0 en een subscription key, per bedrijf. In de SOAP EmployeeService zijn dit HourComponentVar_Insert (Period, Year, UnprotectedMode, Comment) of HourComponentVar_InsertCurrent, Leave_GetList (NL-only; Status, Hours, StartHours, EndHours, Type) en LeaveBalance_GetPerType. De SOAP API stopt per 1 maart 2027.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in EverhourVeld in NmbrsToelichting
user (Everhour-id) en e-mailadresEmployeeId in NmbrsGekoppeld op het zakelijke e-mailadres
timecard.workTime (seconden)HoursOpgeteld per goedgekeurde dag
Soort urenHourCodeUurcode van het Nmbrs-bedrijf
weekId en gebruikerCommentReferentie om dubbel boeken te voorkomen
Datum van de dagPeriod en Year
Leave_GetList met Status Approved (terug)time-off met timeOffType en timeOffPeriod
LeaveBalance_GetPerType (terug)allocation per time off type

Gerelateerd

Welke systemen wil je koppelen?

Vertel welke systemen je gebruikt en wat er automatisch moet gebeuren. Samen bepalen we de kleinste werkende oplossing, met een helder ontwerp en een offerte vooraf.