Een koppeling verbindt niet

Wat de knop Verbinding testen teruggeeft, waarom die uitkomst er zo technisch uitziet, en wat de meldingen op het tabblad Koppelingen betekenen — ook als de test zelf niet op gang komt.

Wanneer gebruik je dit

Je staat op Instellingen › Koppelingen, klikt op Verbinding testen bij een kaart, en er gebeurt iets anders dan een geruststellende bevestiging: een regel vol accolades, of een melding dat de test zelf niet lukte. Dit artikel legt uit wat je daar leest en wat je eraan doet.

Eerst opslaan, dan testen

De testknop leest niet wat er in de velden staat, maar wat er bewaard is.

Vul je een nieuwe server of sleutel in en klik je meteen op Verbinding testen, dan test Morris nog de oude waarden. Klik dus altijd eerst op Opslaan en pas daarna op Verbinding testen.

Test je een kaart die nog nooit is opgeslagen, dan komt er de melding Test <koppeling> mislukt: integration_not_configured. Dat betekent letterlijk: voor deze koppeling en deze vestiging staat er nog niets in de opslag. Vul de kaart in, sla op, en probeer opnieuw.

De uitkomst van een geslaagde test is ruwe systeemtekst

Lukt de test, dan verschijnt bovenin een melding in deze vorm:

Test guestplan: {"provider":"guestplan","ok":true,"status":200,"restaurants":4}

Dat is geen fout — het is het antwoord van de koppeling, letterlijk overgenomen. Lees het zo:

• ok — betrouwbaar: staat alleen op true bij een antwoordcode tussen de 200 en 299. Een geweigerde sleutel of een fout adres levert dus ook ok: false op.
• status — de antwoordcode van de andere kant. 200 is goed. 401 of 403 betekent dat het contact er wel is maar de sleutel wordt geweigerd; 404 dat het adres bij de andere kant niet bestaat.
• restaurants — alleen bij Guestplan: het aantal restaurants dat werd teruggegeven. Staat daar 0 terwijl je wel restaurants hebt, dan is er contact maar levert de sleutel niets op.

Kortom: ok klopt nu met wat er verder in de regel staat.

Als de test zelf niet op gang komt

Een mislukte verbindingstest geeft een nette melding bovenin: Test <koppeling> mislukt: …, met de reden erachter. Er is niets kapotgegaan en er is niets gewijzigd.

De tekst achter de dubbele punt zegt wat er misging:

• integration_not_configured — deze koppeling is voor deze vestiging nog nooit opgeslagen. Zie hierboven.
• guestplan_missing_base_or_key — de kaart Guestplan mist een server of een API-sleutel. Vul allebei in en sla op.
• docuseal_missing_base_or_key — hetzelfde voor de kaart van de handtekeningdienst.

Staat er een netwerkfout in plaats van een van deze woorden, dan kwam Morris niet eens bij de andere partij. Controleer dan het adres in het veld Server: het moet een volledig webadres zijn, inclusief https://.

"Nmbrs callback zonder code ontvangen"

Deze melding hoort bij het opnieuw inloggen op de loonadministratie.

Je klikt op de kaart van de loonadministratie op de knop om opnieuw in te loggen, je komt bij de leverancier terecht, en die stuurt je daarna terug naar Morris. In die terugkeer hoort een code te zitten. Ontbreekt die, dan zie je deze melding.

Meestal komt dat doordat de inlogpagina is afgebroken of doordat je een oud tabblad opnieuw hebt geladen. Begin gewoon opnieuw: klik op de kaart nogmaals op opnieuw inloggen.

Lukt de automatische terugkeer helemaal niet, dan is daar de losse kaart Nmbrs-code inwisselen voor: log bij de leverancier in, kopieer de code uit de adresbalk, plak hem in dat veld en klik op Inwisselen. Zie De kaarten DocuSeal en Nmbrs bij Koppelingen bekijken.

Let op

• De terugkeeradressen van de koppelingen zijn met opzet openbaar. Ze dragen geen sessie, want het verzoek komt van de leverancier en niet van jouw browser. Je hoeft daar niet voor ingelogd te zijn.
• De koppeling onthoudt bij het inloggen voor welke vestiging het was, in een kort cookie. Begin je het inloggen in het ene tabblad en maak je het af in het andere, dan kan het token bij de verkeerde vestiging landen. Doe het inloggen in één keer, in hetzelfde tabblad.
• De Google-koppeling bestaat niet. Land je op het terugkeeradres ervan, dan krijg je de tekst De Google-koppeling is niet beschikbaar. Dat is het eerlijke antwoord op een koppeling die nooit is afgebouwd — er is niets te repareren aan jouw kant.
• Een geslaagde test zegt niets over de inhoud. Hij controleert of er contact is en of de sleutel geaccepteerd wordt, niet of de gegevens die daarna heen en weer gaan kloppen.

Bijgewerkt op 28 augustus 2026