De handtekeningdienst koppelen

Zonder deze koppeling verstuurt Morris geen enkel contract. Dit zijn de vier velden, wat de webhook-sleutel beschermt, en waarom je hem beter niet leeg laat.

Wanneer gebruik je dit

Morris laat contracten en loonheffingsverklaringen digitaal tekenen via DocuSeal. Voordat er ook maar één document de deur uit kan, moet Morris weten waar die dienst staat en met welke sleutel hij naar binnen mag.

Je vindt het blok onder Instellingen, links onder Systeem bij de ingang Koppelingen. Scrol langs de kaarten van andere koppelingen tot het blok DocuSeal.

De vier velden

Koppeling actief — de schakelaar bovenaan. Rechtsboven in de blokkop staat hetzelfde als bolletje: Actief of Uit. Staat hij uit, dan gaat er geen enkel document meer naar de handtekeningdienst — ook niet vanuit de automatiseringen. Het versturen loopt dan stuk.

Server — het adres van de dienst. Bij een verse installatie staat er https://api.docuseal.eu.

API-sleutel — de sleutel waarmee Morris zich meldt. Het veld is altijd leeg; rechts ernaast staat of er al een sleutel bewaard is. Laat je het veld leeg en sla je op, dan blijft de bestaande sleutel gewoon staan. Alleen als je er iets in typt, wordt hij vervangen. Er is geen manier om een sleutel weer weg te halen via dit scherm.

Webhook-sleutel — de tegenkant. Als een document getekend is, meldt de handtekeningdienst dat aan Morris. Deze sleutel is de waarde die de dienst daarbij meestuurt in de kopregel X-Webhook-Secret. Morris vergelijkt hem met wat hier staat en weigert het bericht als het niet klopt. Ook dit veld werkt volgens laat leeg om te behouden.

Klik daarna rechtsonder op Opslaan.

Wat er binnenkomt als een document getekend is

Zodra de melding binnenkomt en klopt, doet Morris drie dingen: hij legt de melding vast bij het dossier, hij haalt de getekende pdf op en zet die in de map van de medewerker, en bij een automatische verlenging zet hij de nieuwe start- en einddatum in het dossier.

Dat laatste is de reden dat de einddatum van een verlengd contract pas verspringt als er getekend is, en niet al bij het versturen.

Verbinding testen

De knop Verbinding testen vraagt de sjablonenlijst op bij de dienst. Je komt daarna terug op het tabblad Koppelingen met een melding als:

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

Het veld ok is sinds 28 augustus 2026 betrouwbaar: hij staat alleen op true bij een antwoord tussen de 200 en 299, dus bij een echt geslaagde test. Tot die datum stond ok al op true zodra de dienst überhaupt antwoordde — ook bij een verkeerde sleutel met status: 401 erbij. Moest je toen nog naar status kijken in plaats van naar ok, dat hoeft nu niet meer.

Is er nog niets ingevuld voor de vestiging die bovenin gekozen staat, dan krijg je sinds diezelfde datum een melding Test docuseal mislukt: integration_not_configured op ditzelfde tabblad. Staat de sleutel of het serveradres niet ingevuld, dan is die melding Test docuseal mislukt: docuseal_missing_base_or_key. Daarvóór eindigde zo'n mislukte test op een kale foutpagina met Fout: integration_not_configured (of docuseal_missing_base_or_key), zonder terugkeer naar het instellingenscherm.

Na de test — geslaagd of mislukt — kom je terug op ditzelfde tabblad, Koppelingen. Tot 28 augustus 2026 landde je hier altijd op het eerste tabblad, Bedrijfsgegevens, en moest je zelf weer naar Koppelingen klikken.

Let op

• Laat de webhook-sleutel niet leeg. Is er wél een koppeling ingericht maar staat de sleutel leeg, dan slaat Morris de controle over en accepteert hij élk bericht dat op het webhook-adres binnenkomt, van wie dan ook. Zo'n bericht kan een document als getekend markeren. Vul dus in beide systemen dezelfde sleutel in. (Is er helemaal geen koppeling ingericht, dan wordt het bericht wél geweigerd — er kan dan immers niets legitiems binnenkomen.)
• Er is in de praktijk één koppeling voor je hele bedrijf. Het scherm slaat de gegevens op bij de vestiging die bovenin gekozen staat, maar bij het versturen kiest Morris er zelf één uit: eerst een koppeling die aanstaat, dan een met een webhook-sleutel, dan de meest recent opgeslagene. Welke vestiging je bekijkt maakt daarbij niet uit. Vul de koppeling dus op één vestiging in en laat hem bij de andere leeg — twee verschillende invullingen zijn niet twee koppelingen, en je ziet op het scherm niet welke er gebruikt wordt.
• De schakelaar uitzetten breekt het versturen, niet het ontvangen. Een document dat al bij de medewerker ligt, kan nog steeds getekend terugkomen.
• Zonder e-mailadres in het dossier gaat er niets weg. De medewerker is de eerste ondertekenaar; ontbreekt zijn adres, dan weigert Morris het document op te maken.

Meer over Personeel & HR op morris-horeca.nl.

Bijgewerkt op 27 september 2026