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 bewaard, dan testen

Bij DocuSeal, Nmbrs en Guestplan leest de testknop niet wat er in de velden staat, maar wat er bewaard is.

Die kaarten hebben geen knop Opslaan meer: een veld wordt bewaard zodra je het verlaat. Typ je een nieuwe server of sleutel en klik je meteen op Verbinding testen, dan begint het bewaren pas op dat moment en kan de test nog de oude waarden lezen. Klik daarom eerst buiten het veld, wacht tot onderin het scherm de melding Opgeslagen verschijnt, en klik dan pas op Verbinding testen.

Test je bij DocuSeal of Nmbrs een kaart die voor deze vestiging nog nooit is bewaard, dan komt er de melding Test <koppeling> mislukt: integration_not_configured. Dat betekent: voor deze koppeling en deze vestiging staat er nog niets in de opslag. Vul de kaart in en probeer opnieuw. Bij Guestplan staat er dan Er is geen Guestplan-koppeling ingesteld.

Drie andere kaarten werken andersom. WeFact (Verbinding testen), Keukenscherm (Test verbinding) en Pinautomaat (Test sleutel) testen wat er op dat moment in de velden staat. De pinautomaat staat sinds 17 oktober 2026 onder Instellingen › Kassa; na de test kom je daar ook terug. Zie De testknoppen gebruiken.

De uitkomst van een geslaagde test is systeemtekst

Na een test laadt de pagina opnieuw. Bij Nmbrs staat er sinds 15 oktober 2026 een gewone zin: Test nmbrs: gelukt. Verbonden met Nmbrs; 1 debiteur(en) zichtbaar voor deze inlog. of Test nmbrs: mislukt. met de reden erachter (inlog verlopen, sleutel geweigerd, geen toegang, te veel aanroepen, niet bereikbaar). Bij Guestplan ook, sinds 21 oktober 2026: de test haalt de reserveringen van vandaag op, net als het bijwerken, en zegt in gewone taal of dat lukte. Zie Guestplan koppelen en de restaurantnummers invullen.

Lukt de test bij DocuSeal, dan staat bovenaan een melding in deze vorm:

Test docuseal: {"provider":"docuseal","ok":true,"status":200}

Dat is geen fout. Het is een korte samenvatting die Morris van het antwoord maakt. Lees het zo:

• ok: staat alleen op true bij een antwoordcode tussen de 200 en 299. Een geweigerde sleutel 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.

Als de test zelf niet op gang komt

Een mislukte verbindingstest geeft een melding bovenaan: 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 bewaard. Zie hierboven.
• docuseal_missing_base_or_key: de kaart van de handtekeningdienst mist een server of een API-sleutel. Vul allebei in.
• nmbrs_missing_key: de kaart van de loonadministratie mist de abonnementssleutel (tot 15 oktober 2026 heette dit nmbrs_missing_base_or_key).
• internal_error: de test liep vast. Meestal kwam Morris niet eens bij de andere partij. Controleer 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 Nmbrs op Opnieuw inloggen. Er opent een nieuw tabblad bij de leverancier, 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 cookie van je browser. Start je het inloggen kort na elkaar voor twee vestigingen, dan telt de laatste, en kan het token bij de verkeerde vestiging landen. Rond het inloggen voor de ene vestiging af voordat je aan de volgende begint.
• Loop je weg terwijl er nog iets bewaard wordt, dan waarschuwt je browser. Dat geldt ook voor een klik op Verbinding testen: wacht dan even tot er Opgeslagen staat.
• De Google-koppeling bestaat niet. Land je op het terugkeeradres ervan, dan krijg je de tekst De Google-koppeling is niet beschikbaar. 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 16 oktober 2026