Intégrations

eSignature

Demander la signature électronique d'un document Dokos avec DocuSign, depuis la barre latérale du formulaire.

eSignature

L'application eSignature envoie un document Dokos à la signature électronique. Le fournisseur de signature est DocuSign.

L'application est en développement et n'est pas prête pour la production. Dans la version actuelle, Dokos envoie les enveloppes à l'environnement de démonstration de DocuSign (demo.docusign.net). Les signatures n'ont donc pas de valeur légale. L'intégration Adobe Sign des anciennes versions a été retirée.

Ce que l'application permet

  • Demander la signature d'un ou plusieurs fichiers joints à un document, par exemple un devis ou un contrat.
  • Imprimer le document au format PDF et l'envoyer à la signature en une seule action.
  • Faire signer plusieurs personnes, dans un ordre imposé ou non.
  • Faire avancer le workflow du document quand un signataire a signé.
  • Sur le site e-commerce, faire signer un devis par le client avant de le transformer en commande.

Prérequis

  • L'application eSignature installée sur le site. Voir Installer une application.
  • Un compte développeur DocuSign, avec une application qui fournit une clé d'intégration et une clé secrète.
  • L'identifiant de compte API de DocuSign.

Configurer DocuSign

  1. Ouvrez Paramètres de signature électronique.
  2. Cochez Activé. Laissez Fournisseur sélectionné sur DocuSign.
  3. Dans l'onglet Authentification & Connexion, renseignez les champs suivants :
    ChampContenu
    Clé d'intégrationClé d'intégration de l'application DocuSign.
    Clé secrèteClé secrète de l'application DocuSign.
    Serveur d'authorisationAdresse du serveur OAuth de DocuSign, par exemple https://account-d.docusign.com pour un compte de démonstration.
  4. Dans l'onglet DocuSign, saisissez l'Identifiant de compte API.
  5. Dans la section Ancres, gardez ou modifiez l'Ancre de signature. La valeur par défaut est /sn1/. DocuSign place le champ de signature à l'endroit où ce texte apparaît dans le PDF. Ajoutez ce texte dans votre format d'impression, à l'endroit de la signature.
  6. Enregistrez. Dokos crée l'Application connectée et remplit l'URI de redirection.
  7. Dans DocuSign, ajoutez cette URI de redirection aux paramètres de votre application.
  8. Cliquez sur Se connecter à DocuSign et autorisez l'accès. Votre utilisateur devient l'Utilisateur par défaut.

Pour que DocuSign informe Dokos des signatures, déclarez dans DocuSign Connect l'URL suivante :

https://{votre_site}/api/method/esignature.esignature.doctype.esignature_settings.docusign.webhooks.register

Sans cette notification, Dokos met à jour chaque nuit le statut des enveloppes qui ne sont ni signées, ni terminées, ni annulées.

Demander une signature

  1. Ouvrez le document à faire signer, par exemple un devis.
  2. Dans la barre latérale, sous les pièces jointes, cliquez sur Demander une signature électronique.
  3. Choisissez les fichiers à signer. Pour ajouter le PDF du document, cliquez sur Imprimer ce document. Pour ajouter un autre fichier, cliquez sur Joindre un fichier.
  4. Dans le tableau Signataires, ajoutez une ligne par personne : Email, Nom complet et Rôle (Signataire ou Approbateur).
  5. Si le document a un workflow, cochez Validation de workflow pour le signataire dont la signature fait avancer le workflow.
  6. Cochez L'ordre de signature doit être respecté si les signataires doivent signer l'un après l'autre.
  7. Vérifiez le Sujet de l'email, puis cliquez sur Demander une signature électronique.

Dokos crée une Enveloppe de signature et DocuSign envoie l'email aux signataires. Le statut de l'enveloppe passe ensuite par Envoyé, puis Signé ou Complété. La barre latérale du document affiche les enveloppes et le lien vers le document signé.

Exemple

Exemple fictif : la société Menuiserie Élégante envoie le devis DEV-2026-0042 à son client. Le commercial clique sur Demander une signature électronique, puis sur Imprimer ce document. Il ajoute le client comme Signataire et coche Validation de workflow. Quand le client a signé, le workflow du devis passe à l'état suivant.