FAQ Developeurs

Personnalisation : Comment personnaliser les e-mails et les langues ?

Vous pouvez configurer les modèles d’e-mails et les langues utilisées pour les signataires dans Datasure eSign.
📖 Consultez la section Paramètres du guide utilisateur pour plus d’informations : 🔗 Documentation Datasure eSign

Personnalisation : Comment personnaliser l’interface de Datasure eSign ?

Interface de signature (pour les signataires) :

• Personnalisable via la modification des modèles.

API REST : Tester et utiliser l’interface API

Datasure eSign offre une API REST pour l’intégration.

• 🔗 Documentation API : docs.datasure.net
• 📌 Postman est recommandé pour tester les appels API.

API : Puis-je préremplir des champs PDF ?

Oui, l’API permet de préremplir des champs de formulaire PDF.

Exemple de configuration pour le préremplissage des champs PDF :

"OverrideOptions": {
    "Name": "string",
    "MetaData": "string",
    "AddDocumentTimestamp": true,
    "ShareWithTeam": true,
    "LockFormFieldsOnFinish": true,
    "UnassignedElements": {
      "SequenceMode": "NoSequenceEnforced",
      "TextBoxes": [
        {
          "ElementId": "string",
          "Required": true,
          "Value": "string",
          "DocumentNumber": 0
        }
      ]
    }
}

API : Puis-je envoyer plusieurs documents dans une enveloppe ?

Oui, il suffit d’ajouter plusieurs documents dans la section Documents de l’appel API d’envoi d’enveloppe :

"Documents": [
    {
        "FileId": "3c816859-1234-1234-b5ef-3b52a3af1c77",
        "DocumentNumber": 1
    },
    {
        "FileId": "3c816859-1234-1234-b5ef-3b52a3af1c77",
        "DocumentNumber": 2
    }
]

Après cette configuration, vous pouvez envoyer l’enveloppe normalement avec plusieurs documents.

API : Intégration du Designer Datasure eSign dans une application

Étapes :

1️⃣ Créer un brouillon et activer le mode designer externe (allowAgentRedirect)
2️⃣ Configurer la liste blanche des iFrames

"AgentRedirectConfiguration": {
    "Policy": "None",
    "Allow": true,
    "IframeWhitelisting": [
      "https://yourapp.com"
    ]
}

3️⃣ Utiliser l’URL de redirection suivante pour intégrer le designer :

https://esign.datasure.net/AgentRedirect/index?draftid=#envelopeid#

💡 Une fois le brouillon finalisé, l’enveloppe peut être envoyée !

API : Désactiver l’envoi d’e-mails aux destinataires

Ajoutez la clé suivante dans la configuration JSON de l’enveloppe :

"DisableEmail": true

API : Fréquence de rappel de l’URL de callback

📌 Datasure eSign tente d’appeler l’URL de callback jusqu’à 30 fois.
Cela permet de garantir la livraison du callback même si le serveur destinataire est momentanément indisponible.

API : Modifier le contenu et la langue du message OTP SMS

Personnalisation viaActivityEngineCustomLocalizations

Étapes :

1️⃣ Téléchargez le fichier de configuration depuis les paramètres de l’organisation.
2️⃣ Renommez-le avec le code de langue cible (ex. : Localizations.de.custom.json pour l’allemand). 3️⃣ Modifiez uniquement les éléments nécessaires et supprimez les valeurs par défaut.

📖 Pour voir les langues disponibles :
🔗 Support des langues

API : Pourquoi une enveloppe reste "En cours" alors qu’elle est terminée ?

📌 Cause probable : Le post-traitement (callback) n’a pas reçu de réponse HTTP 200.
🔹 Datasure eSign réessaie l’appel jusqu’à 30 fois avant d’abandonner.

API : PourquoiworkstepRedirectionUrl est vide alors que l’enveloppe a démarré ?

📌 Cause probable : L’enveloppe est encore en statut "Démarrée", et le lien n’a pas encore été généré.

Solutions possibles :
1️⃣ Attendre que l’enveloppe passe en statut "En cours" (InProgress). 2️⃣ Désactiver l’envoi d’e-mails pour générer immédiatement le lien :

• Soit via "suppressEmails" pour un destinataire.
• Soit via l’option "Empêcher l’envoi d’e-mails" dans les paramètres de l’organisation.

API : Ajouter une tâche de lecture obligatoire avant signature

📌 Vous pouvez obliger le signataire à confirmer la lecture avant de signer.
📖 Consultez le guide des tâches de lecture : 🔗 docs.datasure.net

API : Stocker des métadonnées dans une enveloppe

📌 Les enveloppes peuvent contenir des métadonnées personnalisées.

{
  "Documents": [
    {
      "FileId": "string",
      "DocumentNumber": 0
    }
  ],
  "Name": "string",
  "MetaData": "string"
}

📌 Les métadonnées peuvent être utilisées pour l’archivage et récupérées via les callbacks.

Statuts disponibles pour les enveloppes

Autres fonctionnalités utiles

📌 Placer automatiquement un champ de signature dans un document
Ajoutez simplement le texte "sig" dans votre document PDF pour insérer un champ de signature automatiquement.

📌 Pourquoi Adobe Reader indique que le document n'est pas signé correctement ?
🔹 Vérifiez si Adobe Reader est à jour et mettez à jour la liste des certificats AATL/EUTL dans "Préférences" et "Gestionnaire d'approbations".

🚀 Datasure eSign est une plateforme flexible, offrant de nombreuses possibilités d’intégration et de personnalisation !
🔗 Documentation complète : docs.datasure.net