Hoe de synchronisatie verloopt, en wat er misgaat

Na jouw akkoord pakt een achtergrondtaak de opdrachten één voor één op. Dit zijn de stappen die hij zet, welke gegevens er de deur uit gaan, en waarom een mislukte opdracht níét vanzelf opnieuw wordt geprobeerd.

Wanneer gebruik je dit

Je hebt de maandbatch goedgekeurd en wilt weten wat er nu gebeurt — of een opdracht staat op FAILED en je wilt weten waarom er niets meer gebeurt.

Eén opdracht tegelijk

Een aparte achtergrondtaak kijkt elke drie seconden of er een opdracht klaarstaat. Hij pakt er dan precies één op, de oudste, werkt die af en gaat weer kijken. Er lopen er nooit twee tegelijk, ook niet als er honderd klaarstaan.

Na afloop krijgt de opdracht één van twee uitkomsten:

SUCCESS — alle onderdelen zijn goed gegaan;
FAILED — er is iets misgegaan, met de foutmelding erbij.

Er wordt niet automatisch opnieuw geprobeerd. Een mislukte opdracht blijft op FAILED staan en gebeurt nooit meer, hoe lang je ook wacht. Wil je het opnieuw, dan zet je zelf een nieuwe synchronisatie klaar vanaf het dossier (Sync naar Nmbrs) en keur je die in de maandbatch opnieuw goed.

Je ziet de uitkomst onder Personeelsbeheer › Sync jobs.

De stappen die gezet worden

Een volledige synchronisatie loopt vast in deze volgorde. Elke stap is een apart bericht aan de salarisadministratie.

De medewerker opzoeken of aanmaken. Morris kijkt eerst of hij er al is, zowel op het bekende nummer als op voor- en achternaam. Alleen als hij nergens gevonden wordt, wordt er een nieuwe aangemaakt — met een personeelsnummer uit een vaste reeks (fulltimers krijgen een laag nummer, oproepkrachten een nummer boven de duizend). Direct na het aanmaken wordt ook de functie gezet.
Het adres: straat, huisnummer, postcode en plaats.
Het rekeningnummer.
De contracten. Vanaf de startdatum bouwt Morris jaarcontracten op: telkens één jaar min één dag. Zodra een contractperiode in de toekomst eindigt, stopt hij. Na drie jaarcontracten wordt het vierde een contract voor onbepaalde tijd. Bij een fulltimer gaan de uren per week apart mee.
De loonheffingskorting — aan of uit, zoals het op het dossier staat.
De verzekeringsgegevens (cao, zorgverzekeringswet, sociale verzekering).
De persoonsgegevens: voornaam, achternaam, geboortedatum, geslacht, zakelijk e-mailadres, telefoonnummer en zo nodig een gecorrigeerd personeelsnummer.
Het burgerservicenummer. Dit gaat bewust ná de persoonsgegevens, anders raakt het in de salarisadministratie uit beeld.
Het loon — het uurloon bij een parttimer, het maandloon bij een fulltimer.
De functie.
De terugleescontrole: Morris leest terug wat er nu staat en vergelijkt dat met het dossier.

Dat is de volledige lijst. Bij een deelwijziging is hij korter — zie hieronder.

Wat er níét opnieuw wordt weggeschreven

Voordat Morris iets wegschrijft, leest hij eerst de bestaande historie van die medewerker. Staat er al een contract met precies dezelfde begindatum, einddatum, urenaantal en soort? Dan wordt dat contract overgeslagen in plaats van nog een keer weggeschreven. Hetzelfde geldt voor het loon, het urenrooster en het rekeningnummer.

Dat scheelt dubbele regels in de historie van de salarisadministratie, en het maakt een tweede synchronisatie ongevaarlijk.

Lukt dat teruglezen niet, dan stopt de hele opdracht met een fout die begint met nmbrs_preflight_failed. Er wordt dan niets weggeschreven — bewust, want zonder te weten wat er al staat kan Morris niet bepalen wat er bij moet.

Bij een deelwijziging gaat alleen het gewijzigde mee

Wijzig je een paar velden op een dossier en vink je het synchroniseren aan, dan heet de mutatie details_update met de gewijzigde velden erachter. Morris verwerkt dan alleen de onderdelen waar die velden in zitten.

Wijzig je bijvoorbeeld alleen de postcode, dan gaat alleen het adres mee — geen contract, geen loon, geen burgerservicenummer. En bij zo'n deelwijziging wordt de terugleescontrole overgeslagen, want die vergelijkt het hele dossier.

Een loonwijziging is nog strenger: die gaat als loon-alleen de deur uit, om te voorkomen dat er nieuwe adres- of contracthistorie ontstaat bij een simpele loonaanpassing.

De periode waarin het geboekt wordt

Elke regel in de salarisadministratie hoort bij een loonperiode. Morris kiest die periode uit de ingangsdatum van de mutatie: bij een loonwijziging de ingangsdatum die jij invult, en anders de startdatum uit het dossier.

Morris vraagt daarnaast op welke periode er op dit moment openstaat en legt dat vast in het logboek. Is dat een andere periode dan waar geschreven wordt, dan staat dat er expliciet bij — handig als je later met je boekhouder moet uitzoeken waarom een mutatie in een andere maand landde dan verwacht.

De inloggegevens

De toegang tot de salarisadministratie verloopt na een uur. Morris houdt dat op twee manieren bij:

Elke 45 minuten loopt hij alle filialen met een koppeling langs en vernieuwt de toegang die binnen twintig minuten verloopt.
Vlak voor elke synchronisatie wordt het nog een keer gecontroleerd: verloopt de toegang binnen vijf minuten, dan wordt hij eerst vernieuwd.

Lukt vernieuwen niet, dan mislukt de opdracht met nmbrs_no_oauth_token. Dan moet de koppeling opnieuw ingelogd worden onder Instellingen › Koppelingen.

Wat je ziet als het misgaat

Niet elke fout is even zichtbaar. Er zijn twee soorten:

De medewerker kon niet worden aangemaakt. Dan komt er, naast de FAILED- status, een melding Nmbrs-sync mislukt: [naam] in Meldingen, met een link naar de jobs-pagina.
Een van de losse onderdelen ging mis — bijvoorbeeld het loon of het contract. De opdracht gaat op FAILED met een foutmelding die begint met nmbrs_partial_failure, gevolgd door de onderdelen die niet lukten. Hier komt géén melding van. Je ziet het alleen als je op de jobs-pagina kijkt.

Dat verschil is belangrijk: bij een gedeeltelijke mislukking is een deel van de gegevens wél weggeschreven en een deel niet.

Let op

De koppeling staat per vestiging aan of uit. Staat hij uit voor het filiaal van deze medewerker, dan wordt de opdracht overgeslagen — hij komt dan niet op FAILED maar op SUCCESS, met in het logboek de reden.
Een burgerservicenummer dat niet klopt volgens de elfproef gaat niet mee. De rest van de synchronisatie gaat gewoon door; alleen het burgerservicenummer ontbreekt dan bij de salarisadministratie.
Een onbekende vestiging laat de opdracht mislukken. Elke vestiging moet aan een bedrijf in de salarisadministratie gekoppeld zijn, en die koppeling ligt vast in de installatie — je kunt hem niet zelf in een instellingenscherm leggen. Staat jouw vestiging er niet bij, dan mislukt elke opdracht met de fout unknown_branch en moet die koppeling eerst gemaakt worden.
De jobs-pagina toont maar honderd opdrachten, van het geselecteerde filiaal, met de nieuwste bovenaan.
Controleer na een eerste synchronisatie van een nieuwe medewerker altijd even in de salarisadministratie zelf. De terugleescontrole van Morris meldt afwijkingen in het logboek, maar dat logboek heeft geen scherm.

Verwante artikelen

Was dit duidelijk?

Bijgewerkt op 26 augustus 2026