Een synchronisatie met de loonadministratie is mislukt

De knop Fout bekijken op Sync jobs, de zeven uitleggen die Morris bij een mislukte opdracht geeft, en waarom een mislukte sync nooit vanzelf opnieuw gaat.

Wanneer gebruik je dit

Op Personeel › Sync jobs staat een regel met een rood knopje Fout bekijken, of je kreeg een melding dat er een synchronisatie is mislukt.

Het dossier in Morris is niet aangetast. Een mislukte synchronisatie betekent dat de loonadministratie de wijziging niet heeft overgenomen; in Morris staat alles gewoon zoals je het hebt opgeslagen. Je kunt de opdracht opnieuw aanbieden zonder dat je iets opnieuw hoeft in te typen.

Het omgekeerde is wel de moeite waard om te weten: een mislukte opdracht wordt nooit uit zichzelf opnieuw geprobeerd. Hij blijft op fout staan tot jij er iets mee doet. Je merkt het dus niet vanzelf een dag later; je moet zelf terugkomen.

De fout lezen

Klik op Fout bekijken. Onder de regel klapt een rood vlak open met twee delen:

• Uitleg — wat Morris van de fout maakt, in het Nederlands. Dit is het deel waar je iets aan hebt.
• Technische fout — de melding zoals de loonadministratie hem teruggaf. Neem die over als je het meldt.

Nog een keer op de knop klikt het vlak weer dicht.

De zeven uitleggen

Nmbrs weigert deze write met rechten/toegang. Meestal mist de OAuth/API-gebruiker rechten op dit onderdeel of bestaat de gebruikte Nmbrs-referentie niet in dit bedrijf.

De verbinding werkt, maar de gebruiker waarmee Morris inlogt mag dit onderdeel niet wijzigen. Laat de rechten van die gebruiker bij de loonadministratie nakijken, en controleer of Morris aan het juiste bedrijf gekoppeld is.

De OAuth refresh token is verlopen of ingetrokken. Koppel Nmbrs OAuth opnieuw voor dit filiaal.

De toegang is verlopen. Dit is de meest voorkomende van de zeven, want zo'n toegang heeft een houdbaarheidsdatum. Ga naar Instellingen › Koppelingen en maak de koppeling voor dit filiaal opnieuw. Let op dat het per filiaal gaat.

Zolang dit speelt, mislukt elke opdracht voor dat filiaal. Herstel de koppeling eerst, en bied de mislukte opdrachten daarna opnieuw aan.

De medewerker of gekoppelde Nmbrs employee-id is niet gevonden. Controleer of Morris aan de juiste Nmbrs-omgeving en medewerker is gekoppeld.

Morris zoekt de medewerker aan de andere kant en vindt hem niet. Dat gebeurt als de medewerker daar nog niet bestaat, als hij daar verwijderd is, of als Morris aan een andere omgeving hangt dan je denkt.

Morris kon de bestaande Nmbrs-historie niet veilig uitlezen. De write is daarom geblokkeerd om dubbele historie te voorkomen.

Voordat Morris een loonmutatie wegschrijft, leest hij wat er al staat. Lukt dat niet, dan schrijft hij niets — anders zou er een tweede loonregel naast de bestaande kunnen ontstaan. Dat is een bewuste rem, geen storing. Probeer het later opnieuw; blijft het zo, meld het dan.

Nmbrs accepteerde de loonmutatie, maar Morris kon de wijziging direct daarna niet teruglezen in de Nmbrs-historie. Daarom staat deze oude losse job op fout. Verjaardagsopslag hoort voortaan in de maandelijkse Nmbrs-mutatiebatch: pas na handmatig akkoord wordt die batch gesynchroniseerd.

Hier is de mutatie waarschijnlijk wél aangekomen; alleen de controle achteraf mislukte. Kijk aan de kant van de loonadministratie of de wijziging er staat voordat je hem opnieuw aanbiedt — anders staat hij er straks twee keer. Deze uitleg hoort bij oude losse opdrachten; nieuwe verjaardagsopslagen lopen via de maandbatch.

Er ontbreekt verplichte data voor deze sync. Vul het dossier aan en probeer daarna opnieuw.

Er mist iets in het dossier dat de loonadministratie verplicht stelt. Kijk in de technische fout welk veld genoemd wordt, vul het aan in het dossier en bied de opdracht opnieuw aan.

Onbekende syncfout. Gebruik de technische fout hieronder als startpunt voor diagnose.

Morris herkent de melding niet. De regel onder Technische fout is dan alles wat je hebt; neem hem volledig over als je het meldt.

"Geen foutmelding opgeslagen bij deze job."

De opdracht staat op fout, maar er is geen tekst bewaard. In het technische vlak staat dan Geen last_error opgeslagen.

Er is dan niets uit deze regel te halen. Bied de opdracht opnieuw aan; mislukt hij weer, dan is er meestal wél een melding.

"Sync gestart - Controleer jobs pagina"

Deze melding krijg je na de knop Sync naar Nmbrs in een dossier. Lees hem letterlijk: hij zegt dat de opdracht is aangenomen, niet dat er iets is gelukt — en zelfs niet dat er iets is gestart.

Wat er werkelijk gebeurt: de synchronisatie wordt klaargezet in de maandbatch en wacht daar op je akkoord. Staat de koppeling uit voor het filiaal van deze medewerker, dan wordt er zelfs helemaal niets klaargezet, en zie je dezelfde groene melding.

Wat je doet: kijk het na. Op Nmbrs maandelijkse mutaties zie je of de regel er staat, en op Sync jobs wat ervan geworden is nadat je akkoord hebt gegeven.

"Sync error: …"

Ging het al mis bij het aannemen van de opdracht, dan kom je terug in het dossier met deze melding en de reden erachter. Er is dan niets klaargezet — ook geen mutatie in de maandbatch.

De redenen die je hier tegenkomt gaan over het dossier zelf (het bestaat niet meer) of over een verbinding die wegviel. Probeer het opnieuw; blijft het misgaan, noteer dan de hele regel.

De melding in je Meldingen

Mislukt een opdracht terwijl hij draait, dan zet Morris er een melding bij in de Meldingen-feed:

Nmbrs-sync mislukt: voornaam en achternaam van de medewerker

Met de technische fout eronder en een verwijzing naar Sync jobs. Zo blijft een mislukte opdracht niet onopgemerkt in een lijst hangen.

Er komt één melding per mislukking. Blijft de oorzaak staan en mislukken er tien opdrachten, dan krijg je die niet allemaal apart — er komt geen tweede melding met dezelfde titel zolang de eerste nog openstaat.

Opnieuw proberen

Er is geen knop Opnieuw op een mislukte regel. Wat je doet:

1. Neem de oorzaak weg — herstel de koppeling, vul het dossier aan, laat de rechten aanpassen.
2. Open het dossier en klik op Sync naar Nmbrs, of sla een wijziging op en antwoord de synchronisatievraag met OK.
3. Geef akkoord op de maandbatch.

De oude, mislukte regel blijft op Fout bekijken staan. Op Sync jobs staat daarom ook de link Clear niet-afgehandelde jobs voor dit filiaal, met de vraag Weet je zeker dat je alle niet-afgehandelde sync jobs voor dit filiaal wilt verwijderen?. Die haalt alle opdrachten weg die nog in de wachtrij staan, bezig zijn of op fout staan — dus ook opdrachten van collega's die nog moesten lopen. Gebruik hem alleen om echt schoon schip te maken, niet om één regel op te ruimen.

Twee velden komen sowieso niet door

Ook bij een geslaagde synchronisatie zijn er twee velden die niet aankomen:

• Nationaliteit wordt door de loonadministratie geaccepteerd maar niet bewaard. Er is geen weg omheen; dat veld moet daar met de hand worden ingevuld.
• Geboortedatum komt bij het aanmaken van een medewerker niet altijd goed door. Morris herstelt dat zelf, verderop in dezelfde synchronisatie, met een aparte stap. Zie je daar toch een onmogelijke datum staan, dan is die stap misgegaan.

Let op

• Kijk naar de kolom Actie om te zien waar een opdracht over ging. Die staat er in het Nederlands: Handmatige sync, Loon aanpassen, Functie aanpassen, Verjaardagsopslag per …, of Dossiergegevens aanpassen: maandsalaris per ….
• Sync jobs toont maar één filiaal. Boven de tabel staat welk filiaal je ziet, met de regel Toont alleen sync jobs voor het geselecteerde filiaal. Mis je een opdracht, wissel dan eerst van filiaal.
• Een geslaagde opdracht komt in het maandrapport dat naar de boekhouder gaat. Een mislukte niet.

Bijgewerkt op 26 augustus 2026