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, als eerste blok bovenaan.

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 instellingenscherm met een melding als:

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

Kijk naar status, niet naar ok. Het veld ok staat op waar zodra de dienst überhaupt antwoordt; een verkeerde sleutel levert ok: true met status: 401 op. Alleen status: 200 betekent dat de sleutel werkt.

Is er nog niets ingevuld voor de vestiging die bovenin gekozen staat, dan krijg je geen melding maar een foutpagina met Fout: integration_not_configured. Staat de sleutel of het serveradres niet ingevuld, dan leest die pagina Fout: docuseal_missing_base_or_key.

Na de test kom je terug op het eerste tabblad, Bedrijfsgegevens. Klik links weer op Koppelingen om verder te gaan.

Let op

• Laat de webhook-sleutel niet leeg. Staat er niets, dan slaat Morris de controle helemaal 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.
• 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 pakt Morris zonder te kijken de eerste de beste rij. Vul de koppeling dus op één vestiging in en laat hem bij de andere leeg — twee verschillende invullingen leveren onvoorspelbaar gedrag op.
• 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.

Bijgewerkt op 26 augustus 2026