Verlofaanvragen koppelen aan salarisadministratie: saldo en goedkeuring teruglezen

Je manager keurt twee dagen verlof goed. In de HR-app daalt het saldo, maar in het rooster blijft de medewerker ingepland en in payroll staat nog geen afwezigheid. Een groen vinkje in de koppeling vertelt je niet welke van die drie uitkomsten echt is opgeslagen.

Een controleerbare verlofroute verbindt één aanvraag aan een vaste medewerker, een verloftype, een goedkeuring, een roosterboeking en een salarisperiode. Eén systeem bezit de aanvraag en het saldo. De andere systemen ontvangen alleen de velden die ze nodig hebben. Voor de salarisrun lees je zowel de opgeslagen afwezigheid als het actuele saldo terug en verklaar je ieder verschil.

Begin met de grens van je huidige software. AFAS Profit brengt HR en Payroll in één systeem samen. De standaardkoppeling van Shiftbase met Nmbrs synchroniseert verlofsaldi niet; de connector verwerkt bepaalde uren en uitbetalingen en biedt een e-mailadres voor exportberichtgeving. De actuele HoorayHR-handleiding somt de Nmbrs-synchronisatievelden op, maar noemt een gewone aanvraag of saldo niet. De algemene HR-mutatieproef blijft nuttig voor de bronhouder en terugleescontrole in salarisadministratie, maar hier test je precies de verlofboeking, afwijzing, annulering en herstel.

Wat je nodig hebt voor één controleerbare verlofroute

Zet deze zeven dingen klaar:

• De exacte producten en modules. Noteer bijvoorbeeld AFAS Profit HRM & Payroll, Shiftbase Premium met App Center+, HoorayHR Plus of Nmbrs Payroll Essential. Schrijf ook de omgeving op: productie, Nmbrs-sandbox of testadministratie. Een leverancier kan een feature tonen die niet in jouw pakket, connector of API-rechten zit.
• Een medewerkerkaart met drie sleutels. Bewaar één intern nummer, zoals M-017, naast de ID’s uit HR, planning en payroll. De numerieke userId in HoorayHR, de Shiftbase-medewerker-ID en het Nmbrs-werknemernummer zijn niet vanzelf gelijk. Gebruik naam en e-mailadres alleen als extra controle.
• Een eigenaar per veld. Wijs aan wie de aanvraag, het besluit, het saldo, de gepubliceerde planning, de looncode en de salarisvrijgave beheert. Kies één saldo-eigenaar. Een saldo dat twee systemen zelfstandig opbouwen, is geen gedeeld saldo maar twee berekeningen die kunnen uiteenlopen. De bronhouder per veld, met sleutel, richting en herstelpad is de afspraak die je hier nodig hebt.
• Een verlofwoordenboek. Leg de code, eenheid, opbouwregel en geldigheidsperiode vast voor wettelijke vakantie, bovenwettelijke vakantie, ADV, tijd-voor-tijd, onbetaald verlof en eventueel betaald ouderschapsverlof. De wettelijke en bovenwettelijke uren hebben andere regels voor verval. Wettelijke uren uit 2026 vervallen normaal op 1 juli 2027, terwijl bovenwettelijke uren doorgaans vijf jaar meegaan. Bewaar daarom verloftype en opbouwjaar, niet alleen één totaalsaldo.
• Een minimale rechtenkaart. Geef een integratiegebruiker alleen de lees- en schrijfrechten voor de geteste medewerker, administratie en velden. Gebruik HoorayHR time_off_read om aanvragen te lezen. Gebruik geen beheerderstoken met alle medewerkers als een smallere scope volstaat. Houd toestemming, eigenaar en vervaldatum van elke sleutel bij.
• Een betaalperiode en een stopmoment. Zet de echte payroll-deadline en periode in het testblad. “Voor het einde van de maand” is geen datum. Noteer wie na de laatste correctie de run vrijgeeft en hoe je een wijziging na afsluiting behandelt.
• Een testset en kostenbasis. Neem één gewone aanvraag, één afgewezen aanvraag, één wijziging, één annulering en één bewuste mislukte overdracht op. Begroot licenties, koppeling, beheer en handmatige controle afzonderlijk. In de tabel staat een prijsvergelijking voor 25 gebruikers, gecontroleerd op 12 november 2026; een API-bouwprijs hangt af van je velden en foutafhandeling.

De juli 2026-consultatie over een nieuwe Verlofwet stelde een andere ordening voor, niet een directe wijziging van je inrichting. Het concept ordende verlof in drie pijlers en liet bestaande rechten grotendeels gelijk. Houd huidige verloftypen herkenbaar tot een nieuwe regel daadwerkelijk ingaat.

Een vrije tekst bij ziekte hoort niet in deze stroom. De Autoriteit Persoonsgegevens zegt dat een werkgever de aard of oorzaak van ziekte niet mag vastleggen, ook niet als de medewerker die zelf noemt. Bewaar alleen informatie die nodig is voor werkzaamheden en loondoorbetaling.

Concrete stappen: van verlofaanvraag naar teruggelezen salaris

De veilige volgorde is aanvraag, besluit, planning, payroll en terugleescontrole. Een afwijzing stopt vóór de planning en payroll. Een annulering na goedkeuring maakt een nieuwe, traceerbare wijziging. Verwerk geen tweede keer alleen omdat je eerste API-antwoord traag was.

1. Teken de route per gegeven

Maak een rij voor request_id, employee_key, leave_type, start, end, hours, approval_status, approver_id, balance_before, balance_after, payroll_period, target_record_id en last_readback_at. Zet per rij één bronhouder en één richting. Voor een eigen HoorayHR-koppeling heeft het huidige API-model bijvoorbeeld id, userId, start, end, leaveTypeId, status en userIdApproved op een time-off-record.

De huidige HoorayHR API biedt GET /time-off, PATCH /time-off/{id} en velden zoals status en userIdApproved. Een status is een getal; de openbare documentatie geeft geen vaste statuscode voor “goedgekeurd”. Lees daarom een aanvraag die een manager heeft goedgekeurd terug, noteer de statuscode en bevestig die met userIdApproved en de interface. Zet geen gok als status == 1 in productie. De statuswaarde is numeriek; koppel haar aan een statuslabel uit jouw workflow.

Controlepunt: je kunt voor één aanvraag tekenen welke opgeslagen waarde na elke stap verwacht wordt. Een workflow die alleen “HR naar payroll” zegt, is nog niet te testen.

2. Kies één saldo-eigenaar en richt de verloftypen in

Beslis eerst waar verlof wordt opgebouwd. Kies Shiftbase als bron wanneer de planner daar ook de aanvraag en het saldo beheert. Kies Nmbrs als bron wanneer medewerkers daar aanvragen en de salarisbeheerder daar de saldo-opbouw controleert. Kies een suite als één systeem de aanvraag, planning en payrollboeking al samen beheert.

Zet bij Shiftbase Instellingen > Afwezigheid een beleid per contracttype. De afwezigheidsinstellingen laten je kiezen tussen contracturen, geplande uren, geen saldo of een 13-weeks gemiddelde. Voor een werknemer die in uren werkt, laat je afwezigheid op de ingeplande dienst rekenen; bij verlof in dagen kies je bewust de conversie op contracturen of het 13-weeks gemiddelde. Je kunt ook een saldo niet aan een afwezigheidstype koppelen. Dat is nuttig als HoorayHR of Nmbrs het enige saldo beheert en Shiftbase alleen de roosterblokkade toont. De operationele rooster- en HR-koppeling van Shiftbase vraagt daarom om een ander ontwerp dan een tweede saldo-eigenaar.

Nmbrs Payroll kan verlof automatisch op basis van een rooster berekenen of per maand opbouwen op basis van een percentage of gewerkte uren. Nmbrs waarschuwt dat een beginsaldo plus een periodieke opbouw dubbel verlof kan opleveren. Kies één berekeningsmethode en houd de andere uit. Als beide systemen een saldo tonen, leg vast of het tweede saldo een gecontroleerde spiegel is of een zelfstandige berekening.

Controlepunt: geef een testmedewerker een bekend saldo en controleer dat één verlofuur maar één keer wordt afgetrokken. Vergelijk wettelijk en bovenwettelijk apart.

3. Maak testtoegang aan die je na de proef kunt intrekken

Een beheerder maakt in HoorayHR via Mijn instellingen > API keys een sleutel aan. Kies time_off_read, geef de sleutel een naam en zet een vervaldatum. De HoorayHR API-instellingen laten scopes en einddatum per sleutel kiezen. De sleutel wordt één keer getoond. De scopes en vervaldatum zijn daarna niet aanpasbaar. Een fout gekozen scope betekent dus een nieuwe sleutel maken en de oude intrekken.

Voor Shiftbase vraag je de Public API-token aan via Instellingen > App center > Public API; de Public API kan afwezigheid, verlof, roosters en uren uitwisselen. Voor Nmbrs gebruik je REST met OAuth 2.0. De Payroll API-handleiding is bijgewerkt op 10 augustus 2026. Nmbrs beschrijft REST-toegang om afwezigheden te lezen of te wijzigen, payrollrapporten op te halen en de SOAP-stop per 1 maart 2027. Shiftbase vraagt nu Employee Service-rechten met legacy methodenamen. Dat suggereert een migratierisico; vraag vóór een nieuwe koppeling schriftelijk hoe die na 1 maart 2027 werkt. Bouw nieuw Nmbrs-werk op de REST API en lees het doelrecord terug.

De Nmbrs-sandbox bevat een aparte kopie van gegevens van de vorige dag. Geef de integratie geen recht om een salarisrun goed te keuren.

Controlepunt: een testgebruiker kan de afgesproken afwezigheid lezen en schrijven, maar kan geen betaling vrijgeven. Je kunt de API-toegang na de proef uitzetten.

4. Maak één aanvraag met vaste datum, medewerker en eenheid

Gebruik in de proef een medewerker met een vast werkpatroon en één toekomstig verlofblok. Leg datum en uren apart vast. Als je API-tijden uitwisselt, gebruik ISO 8601 met Europe/Amsterdam als tijdzone. Zet “twee dagen” niet in een opmerking; twee dagen kunnen acht, zestien of een wisselend aantal werkuren betekenen.

Lees de aanvraag eerst uit het bronsysteem. Voor HoorayHR kan de integratie GET /time-off?timeOffType=LEAVE lezen. Vergelijk het record met de aanvraag in de interface: medewerker, verloftype, start, eind, uren, aanvraag-ID en goedkeurende manager. Als de aanvraag nog openstaat of is afgewezen, markeert de verwerking het record als niet_verwerken en verstuurt geen rooster- of payrollmutatie.

Controlepunt: één request-ID verwijst naar één medewerker en één verlofperiode. De aanvraag bevat geen vrije medische toelichting. Een dubbele naam met een andere personeels-ID blokkeert de test.

5. Laat de bevoegde manager beslissen vóór je schrijft

De integratie mag een aanvraag niet goedkeuren. De manager doet dat in het bronsysteem. De koppeling leest daarna de opgeslagen goedkeuring en start pas dan de planning- en payrollstap. Een afgewezen of nog open verzoek maakt dus geen roosterblokkade, verlaagt geen saldo en schrijft geen salarisrecord.

Als je AFAS Profit gebruikt, komt de taak in InSite bij Mijn taken. De manager kan het verwachte saldo na de boeking bekijken en goedkeuren of afkeuren. Na goedkeuring maakt Profit van de aanvraag een verlofboeking, past het saldo aan en registreert de afwezigheid in de roosterkalender. Voor verlof in een volgend boekjaar verandert het saldo van het lopende jaar pas wanneer het verlof is genoten. Dat verschil kan dus juist zijn, geen synchronisatiefout.

HoorayHR zelf biedt verlofaanvragen, goedkeuring en budgetberekening per medewerker. De partnerfiche noemt profielen, werkroosters, contracten, salarissen, loonstroken, uurcodes en kostenplaatsen als synchronisatievelden, maar noemt geen gewone verlofaanvraag of saldo als standaardoverdracht. De uurcodes zijn dus geen bewijs van saldosynchronisatie. Vraag niet alleen “is HoorayHR gekoppeld?”, maar of precies jouw verloftype en saldo in beide richtingen gaan.

Controlepunt: voor de proef bestaat een manager-ID en een goedgekeurde bronversie. Bij afwijzing blijven rooster en payroll ongewijzigd.

6. Schrijf de afwezigheid naar planning en payroll

Maak de planningsboeking pas na goedkeuring. Bij Shiftbase configureer je de afwezigheid in Instellingen > Afwezigheid, koppel je haar aan het juiste contracttype en kies je de uren die uit het rooster moeten verdwijnen. Als HoorayHR het saldo beheert, koppel je in Shiftbase geen tweede balans aan dat afwezigheidstype. Je verstuurt alleen medewerker, aanvraag-ID, verloftype, datums en ingeplande uren.

Voor payroll map je de verlofcode naar de juiste Nmbrs-urencomponent. Shiftbase vraagt om alle gebruikte urencomponenten aan een extern Nmbrs-component te koppelen. De Nmbrs-API kan personeelsgegevens, uren en afwezigheden lezen of wijzigen en kan rapporten zoals looncomponenten ophalen. Laat de salarisadministrateur bepalen of normale vakantie als afwezigheid in payroll moet staan of dat alleen een bijzondere verwerking, zoals uitbetaling, een looncomponent hoort te krijgen.

Bij Shiftbase stel je bij de Nmbrs-koppeling een e-mailadres in voor exportberichtgeving. De handleiding zegt niet welke foutcodes of afgewezen regels in dat bericht staan. Gebruik het daarom als signaal, niet als bewijs van een juiste boeking. Laat in de proef één export met een bewust niet-gekoppelde urencomponent stranden en noteer of de melding per e-mail, in de Shiftbase-rapportage of in Nmbrs verschijnt. Controleer daarna in Nmbrs of voor de medewerker en periode een regel is aangemaakt en of de component en uren kloppen.

De grens is belangrijk. De standaardkoppeling van Shiftbase met Nmbrs kan uit te betalen vakantie-uren verwerken, maar synchroniseert geen verlofsaldi van of naar Nmbrs. Urenexport is dus geen bewijs dat het saldo is meeverhuisd. Als hetzelfde saldo in payroll zichtbaar moet zijn, voeg dan een expliciete balansoverdracht toe en test die als een aparte mutatie. De basisuitleg over roosters, uren en payrollroutes helpt bij het plannen van bezetting; een bezettingsprognose vervangt geen goedgekeurde verlofboeking.

Controlepunt: planning toont de juiste uren afwezig en payroll heeft de juiste medewerker, periode, code en urenregel. Het bronsaldo heeft één eigenaar.

7. Lees het doelrecord terug vóór de salarisrun

Een HTTP 200, groene tegel of “verzonden” status kan betekenen dat een verzoek is ontvangen. Het is geen bewijs dat de juiste afwezigheid in de juiste salarisperiode staat. Lees na de schrijfopdracht het Nmbrs-doelrecord of de salarisrapportage opnieuw op en vergelijk medewerker-ID, periode, urencomponent, aantal uren en status met de goedgekeurde bronaanvraag.

HoorayHR beschreef een integratie-tag die aangeeft of een mutatie correct is ingeschoten in een update die op 1 juni 2022 werd gepubliceerd en op 30 oktober 2026 is bijgewerkt. Dat label is een nuttig eerste foutsignaal, maar bewijst niet dat Nmbrs de regel in de juiste periode heeft verwerkt. De actuele HoorayHR-activeringshandleiding somt geen gewone verlofaanvraag of saldo-overdracht op en documenteert geen vaste afwijzingstekst. Controleer in jouw proef daarom of het label bij een mislukte mutatie zichtbaar verandert, waar de foutdetails en eventuele herhaalactie staan, en of het Nmbrs-record echt bestaat.

Bewaar daarbij bronrequest-ID, bronversie, tijdstip, doel-ID, antwoord, salarisperiode en controleur. Als Nmbrs naast de bron een eigen verlofsaldo berekent, vergelijk je ook de saldo’s per verloftype en opbouwjaar. Laat verschillen staan als verschillen. Overschrijf ze niet automatisch voordat je weet of ze komen door een andere opbouwmethode, een boeking in een volgend jaar of een handmatige correctie.

Controlepunt: de salarisadministrateur kan het opgeslagen doelrecord openen en de aanvraag naar dezelfde medewerker en datum terugleiden. Zonder doel-ID of rapportregel staat de mutatie op onbevestigd.

8. Verwerk wijziging en annulering als nieuwe, zichtbare beslissingen

Na goedkeuring verwijder je een boeking niet stilzwijgend. Leg de wijziging of annulering vast met verwijzing naar de oorspronkelijke aanvraag, laat de bevoegde manager opnieuw beslissen en stuur een correctie naar elk systeem dat de eerste versie al heeft opgeslagen. Bij een API-route kun je PATCH /time-off/{id} gebruiken om de bronversie bij te werken. Controleer of de wijziging opnieuw goedkeuring vereist.

AFAS laat concreet zien waarom dit geen gewone delete is. Na goedkeuring wordt de aanvraag een boeking; de medewerker kan die niet verwijderen maar wel intrekken. Het intrekken start opnieuw een workflow die de manager moet afronden voordat een nieuwe boeking in dezelfde periode kan worden toegevoegd. Een specifieke boeking corrigeer je op die boeking. Als dat niet meer kan, gebruik je HRM > Medewerker > Verlofcorrectie. Een wijziging in een geaccordeerde periode kan een TWK-mutatie veroorzaken; in een geblokkeerde verlofperiode kun je geen correctie toevoegen.

Bij HoorayHR is uitbetaling van verlofuren een ander pad dan vakantie opnemen. De actuele handleiding zegt dat goedgekeurde uitbetalingsuren via een Nmbrs-uurcode kunnen worden verzonden, maar dat het HoorayHR-verlofbudget daarna niet automatisch daalt. De beheerder moet de betaalde uren apart als mutatie afschrijven. Een goedgekeurde loonregel zonder die saldo-mutatie laat twee verschillende waarheden achter.

Voor een gewone wijziging of intrekking van verlof tussen HoorayHR en Nmbrs beschrijven de actuele standaarddocumenten geen terugboekstatus. Test daarom in een proefadministratie een goedgekeurde mutatie en daarna een wijziging of intrekking. Noteer of het HoorayHR-integratie-tag verandert, controleer welke nieuwe of corrigerende regel Nmbrs toont en lees het saldo in HoorayHR opnieuw terug. Blijft het gedrag onduidelijk, zet de periode niet vrij.

Controlepunt: de oude versie blijft in het logboek, de nieuwe beslissing heeft een eigen status en het saldo is na wijziging of annulering opnieuw teruggelezen.

9. Herstel een mislukte overdracht met dezelfde aanvraag-ID

De foutmeldingen verschillen per route. De HoorayHR API-documentatie beschrijft 403 Forbidden als een token de benodigde scope mist. Dat geldt voor een eigen API-koppeling, niet als bewezen foutmelding van de standaardintegratie met Nmbrs. De Shiftbase-handleiding biedt een e-mailadres voor Nmbrs-exportberichtgeving, maar legt niet vast hoe een afgewezen component of mislukte export precies wordt gemeld. Ook de actuele HoorayHR-handleiding specificeert geen afwijzingscode voor gewone verlofmutaties.

Maak die onbekende uitkomst zichtbaar in je proef: verstuur één geldige mutatie en laat daarna een testmutatie bewust falen, bijvoorbeeld door bij een eigen HoorayHR API-proef de leesscope weg te laten of bij Shiftbase een benodigde componentmapping niet in te richten. Schrijf per poging op wat HoorayHR bij de mutatie toont, welke e-mail of rapportregel Shiftbase afgeeft, welke fouttekst zichtbaar is, waar je kunt herhalen en welk doel-ID Nmbrs terugleest. Controleer na herstel dat de afgewezen poging geen doelregel heeft achtergelaten en dat één retry niet dubbel boekt. Herhaal dezelfde proef met een wijziging en intrekking.

Een foutenwachtrij met aanvraag-ID, bronversie, fout, doelstatus en eigenaar is een ontwerp voor je eigen API-koppeling, geen aangetoond onderdeel van de standaardkoppelingen. Bouw die wachtrij zelf als je maatwerk gebruikt: laat de aanvraag op onbevestigd staan, lees met dezelfde aanvraag-ID of Shiftbase of Nmbrs al iets heeft opgeslagen en herstel alleen de ontbrekende velden. HoorayHR laat scopes van een bestaande API-sleutel niet aanpassen; maak dan een nieuwe sleutel met de minimale scope, test die en trek de oude in.

Als de salarisperiode intussen is gesloten, pauzeer de automatische schrijfactie. Laat de salarisadministrateur bepalen of een correctie of terugwerkende kracht nodig is. Nmbrs vereist voor een periode vóór de huidige periode de unprotected mode-vlag, anders volgt een TWK-fout. Gebruik die alleen na akkoord van de salarisbeheerder. AFAS kan een correctie in een geaccordeerde periode als TWK-mutatie verwerken.

Controlepunt: de fout heeft een eigenaar, er staat maximaal één doelmutatie voor dezelfde aanvraag en het saldo sluit opnieuw aan. Een onbekende uitkomst van de schrijfopdracht blokkeert de salarisrun.

Valkuilen: waar loopt de verlofroute vast?

Een verlofroute faalt meestal bij een verschil dat niet zichtbaar is in het groene synchronisatiescherm. Deze zeven fouten zijn concreet te testen voordat payroll wordt vrijgegeven.

Twee systemen bouwen hetzelfde verlofsaldo op

Nmbrs kan verlof berekenen op basis van een rooster of per periode laten opbouwen. Als HoorayHR of Shiftbase ook uren opbouwt en beide uitkomsten als leidend behandelt, kan een beginsaldo plus maandelijkse opbouw dubbel tellen. Kies één saldo-eigenaar. Zet de tweede berekening uit of behandel haar als gecontroleerde spiegel. Vergelijk beginstand, opbouw, gebruikt, vervallen en eindstand per verloftype.

Een goedgekeurde aanvraag als betaald uur behandelen

Een normale vakantiedag is niet automatisch een uitbetaling. De HoorayHR-documentatie over Nmbrs beschrijft specifiek uitbetaling van bovenwettelijke uren via een uurcode en een aparte saldo-mutatie. Gebruik dat pad alleen voor het uitbetalen van uren. Laat een gewone afwezigheidsboeking niet per ongeluk een extra loonregel maken.

Een verlofdag met het verkeerde aantal uren boeken

Bij Shiftbase kunnen afwezigheidsuren op contracturen, ingeplande uren of een 13-weeks gemiddelde worden gebaseerd. Een dag van een oproepkracht is niet altijd acht uur. Kies voor de vaste dienst van 8 uur het geplande rooster; kies voor dagen die wisselen alleen een gemiddelde als dat past bij de contract- en cao-regel. Controleer de berekende uren vóór goedkeuring.

Een geslaagde API-aanroep aanzien voor een payrollboeking

De bron kan de schrijfopdracht succesvol verzenden terwijl Nmbrs het doelrecord niet heeft aangemaakt, of de juiste medewerker maar de verkeerde looncode heeft gekozen. Lees altijd het doel-ID of payrollrapport terug. De bronstatus blijft onbevestigd totdat de medewerker, periode, code en uren matchen.

Een geannuleerd verzoek alleen in HR verwijderen

Als planning of payroll de eerste versie al heeft opgeslagen, verandert het verwijderen van de HR-aanvraag die doelen niet. Schrijf een intrekkings- of correctie-event met een verwijzing naar de oorspronkelijke aanvraag. In AFAS moet de workflow voor intrekking eerst zijn afgerond voordat een nieuwe boeking in dezelfde periode wordt toegevoegd.

Alle vakantiesaldi samenvoegen

Wettelijke en bovenwettelijke uren kunnen verschillende vervalregels hebben. Ook Nmbrs, Shiftbase en HoorayHR hebben hun eigen categorieën. Bewaar de soort, het jaar en de eenheid. De wettelijke uren die iemand in 2026 opbouwt, vervallen volgens de Rijksoverheid normaal op 1 juli 2027; bovenwettelijke uren hebben doorgaans een langere termijn.

Een ziekteomschrijving doorgeven aan payroll of planning

Een ziekmelding is geen verlofsoort met een vrij tekstveld. De Autoriteit Persoonsgegevens zegt dat een werkgever geen aard of oorzaak van ziekte mag vastleggen. Gebruik voor planning alleen de noodzakelijke status en uren. Medische informatie hoort niet in de roosterboeking of salarisexport.

Beslis-kader: welk model past bij jouw verlofroute?

Kies op drie vragen: moet hetzelfde verlofsaldo in alle systemen zichtbaar zijn, hoeveel handwerk kost het en kan iemand een uitzondering beheren? Mijn harde acceptatiegrens is nul onverklaarde verschillen op medewerker, datum, verloftype, periode en saldo. Een mismatch op een looncomponent blokkeert de run, ook bij een team van vijf.

Gebruik deze vier routes:

• Eén HR- en payrollsuite past als één systeem de aanvraag, managergoedkeuring, saldo, rooster en salarisverwerking bezit. AFAS Profit documenteert zo’n route. Kies hem wanneer je de workflows en roosterregels in hetzelfde pakket kunt inrichten en de totale pakketprijs past. De prijs van AFAS Profit hangt af van de organisatie; AFAS vraagt een prijsindicatie aan.
• Standaardconnector met aparte balanscontrole past als de koppeling aantoonbaar de benodigde aanvragen of uren naar payroll brengt en je accepteert dat één ander systeem het saldo bezit. HoorayHR met Nmbrs kan geselecteerde uitbetalingsuren sturen, maar vereist daarna een aparte saldomutatie. Shiftbase met Nmbrs synchroniseert verlofsaldi niet. Noem dit dus geen gedeelde balans.
• Handmatige overdracht met payroll-vrijgave past bij minder dan 10 aanvragen per maand en minder dan 2 uur kopieerwerk. Gebruik een vaste export, twee-persoonscontrole en een register met request-ID. De kleine hoeveelheid maakt een eigen koppeling niet vanzelf goedkoper.
• Maatwerk-API met herstelwachtrij past als dezelfde saldo- of correctiemismatch in twee salarisperioden terugkomt, je meer dan 10 aanvragen per maand verwerkt of je drie systemen op dezelfde aanvraag wilt laten reageren. Bouw dit alleen wanneer HoorayHR, planning en payroll de benodigde schrijf- en terugleesacties aanbieden en iemand eigenaar wordt van tokens, fouten en API-wijzigingen. Gebruik voor nieuwe Nmbrs-koppelingen REST, niet de SOAP-route die op 1 maart 2027 stopt.

Bereken de grens met je eigen tijd. In het voorbeeld verderop zijn dat 12 aanvragen per maand, 10 minuten kopieerwerk per aanvraag en €45 per uur. Dat is 2 uur per maand, 24 uur per jaar en maximaal €1.080 aan invoertijd. De controle door een salarisadministrateur blijft nodig en telt niet als besparing. Dit is een rekenvoorbeeld, geen marktbenchmark.

Uitgewerkt voorbeeld: één aanvraag met annulering en herboeking

Kade & Koel is fictief. Het bedrijf heeft 25 medewerkers en gebruikt AFAS Profit HRM & Payroll. De medewerkers dienen aanvragen in InSite in; managers keuren ze goed via hun takenlijst. Er zijn 12 verlofaanvragen per maand. De huidige administratieve kopie kost 10 minuten per aanvraag. Het team besteedt dus 12 × 10 = 120 minuten, of 2 uur per maand, aan overzetten. Bij 12 maanden is dat 24 uur per jaar. Met een fictief intern tarief van €45 per uur is de maximale besparing op alleen invoer 24 × €45 = €1.080 per jaar. De salariscontrole blijft bestaan.

Medewerker M-017 werkt 24 uur per week op maandag, dinsdag en donderdag, telkens 8 uur. Op 12 november 2026 staat het verlofsaldo voor het gekozen type op 48 uur. De medewerker vraagt maandag 23 en dinsdag 24 november vrij aan. De verwachte boeking is 2 × 8 = 16 uur. De aanvraag bevat verloftype Bovenwettelijke vakantie, de twee datums, de tijdelijke vervanger en het interne personeelsnummer. HR controleert dat dit nummer naar M-017 verwijst.

De manager opent de taak in InSite en ziet het saldo na de boeking. De manager keurt goed. Profit maakt de verlofboeking, zet twee afwezigheden in de roosterkalender en brengt het saldo van 48 naar 32 uur. De salarisbeheerder leest in Profit terug dat dezelfde medewerker, verlofsoort en twee datums in payroll staan. De maandelijkse basissalarisregel blijft ongewijzigd; er wordt geen uitbetalingscomponent voor gewone vakantie toegevoegd.

Op 16 november verandert de afspraak. M-017 wil dinsdag toch werken en vraagt de goedgekeurde boeking in te trekken. De medewerker kan de bestaande boeking niet verwijderen. De intrekking start een nieuwe workflow. De manager keurt die goed. Profit herstelt de 16 uur en de balans staat weer op 48. Pas nadat de intrekking is afgerond, voert HR in dezelfde periode een nieuwe aanvraag in voor maandag 23 november. De manager keurt die goed. Profit boekt nu 8 uur afwezigheid. Het eindsaldo is 48 − 8 = 40 uur en alleen maandag staat in de planning.

De uitzondering was dus geen aanpassing van 16 naar 8 uur op één onzichtbare regel. De eerste goedgekeurde boeking is ingetrokken en de vervangende boeking heeft een eigen besluit. Als de correctie na payrollafsluiting komt, gebruikt de salarisbeheerder de afgesproken TWK-route en leest die daarna opnieuw terug.

Met Shiftbase en Nmbrs voldoet de standaardroute niet aan dezelfde-saldo-eis: de connector synchroniseert geen verlofsaldi. Een afwezigheidsregel in Nmbrs bewijst dus niet dat payroll ook 32 uur toont. Gebruik een geïntegreerde suite of test de REST-saldo-overdracht vóór livegang.

Vergelijkingstabel: wat de leveranciers op 12 november 2026 documenteren

De prijzen zijn maandbedragen voor 25 gebruikers of actieve verloningen, waar gepubliceerd. Shiftbase is berekend op maandbetaling zonder 10% jaarbetaalkorting. Nmbrs telt medewerkers met een loonstrook in de periode; HoorayHR en Shiftbase rekenen per gebruiker. Dit is licentie-oriëntatie, geen gelijkwaardige offerte.

De maatwerkroute is alleen rationeel als de bestaande tools al voor andere processen nodig zijn, of als zij terugkerende saldo- en correctiefouten voorkomt. €1.080 per jaar aan invoertijd dekt geen nieuwe combinatie van systemen van €528,50 per maand. Vergelijk daarom extra kosten met extra besparing, niet met de totale licenties alsof je ze alleen voor verlof aanschaft.

Een aanvraag is pas afgehandeld als de medewerker, het besluit, de verlofsoort, de ingeplande afwezigheid en het opgeslagen salarisrecord dezelfde gebeurtenis aanwijzen. Een saldo dat niet kan worden teruggelezen is geen afgeronde overdracht. Houd de salarisrun tegen tot iemand het verschil kan verklaren.