API DocuSign : Lister tous les destinataires d'une enveloppe qui n'ont pas encore signé

Naviguer dans l'API DocuSign pour gérer les enveloppes

Dans le monde en évolution rapide des accords numériques, les entreprises s'appuient sur des plateformes de signature électronique pour rationaliser les flux de travail. DocuSign, en tant que leader dans ce domaine, offre de puissantes capacités d'API qui permettent aux développeurs d'automatiser et de surveiller les processus de documents. Un défi courant consiste à suivre l'état des destinataires dans une enveloppe, en particulier à identifier ceux qui n'ont pas encore signé. Cette fonctionnalité est essentielle pour la conformité, le suivi et l'efficacité opérationnelle, en particulier dans les environnements à volume élevé, tels que les équipes de vente ou les services juridiques.

Comprendre l'API DocuSign et les destinataires d'enveloppes

L'API eSignature de DocuSign fournit des points de terminaison pour gérer les enveloppes, qui sont essentiellement des conteneurs de documents nécessitant des signatures. Une enveloppe peut avoir plusieurs destinataires, chacun ayant un rôle tel que signataire, approbateur ou personne en copie. L'API utilise une architecture RESTful, prend en charge les charges utiles JSON et nécessite une authentification via OAuth 2.0 ou l'autorisation JWT.

Pour répertorier tous les destinataires d'une enveloppe qui n'ont pas encore signé, les développeurs interrogent généralement l'état de l'enveloppe et les détails du destinataire. Le point de terminaison clé est GET /accounts/{accountId}/envelopes/{envelopeId}/recipients dans l'API Envelopes. Cela renvoie une liste complète des destinataires, y compris leur état (par exemple, « sent », « declined », « signed » ou « needs_to_sign »).

Voici un guide étape par étape pour implémenter cette fonctionnalité :

1. Configuration de l'authentification : utilisez le sandbox de développeur de DocuSign pour obtenir un jeton d'accès. Pour les environnements de production, intégrez-le au système IAM (Identity and Access Management) de votre application. La fonctionnalité IAM de DocuSign fait partie de son programme d'amélioration, y compris l'intégration SSO avec des fournisseurs tels qu'Okta ou Azure AD, garantissant un accès API sécurisé sans exposer les informations d'identification.

2. Récupérer les détails de l'enveloppe : commencez par obtenir l'enveloppe à l'aide de GET /envelopes/{envelopeId}. Cela confirmera l'état de l'enveloppe (par exemple, « sent » ou « in_progress ») et fournira des métadonnées telles que la date de création et la date d'échéance.

3. Interroger les destinataires : appelez le point de terminaison des destinataires. La réponse comprend un tableau d'objets destinataires, chacun contenant :

   • id : identifiant unique.
   • email : e-mail du destinataire.
   • status : état actuel (filtrez « sent » ou « needs_to_sign » pour identifier les destinataires non signés).
   • routingOrder : ordre dans le flux de signature.
   • name : nom du destinataire.

   Un exemple d'extrait JSON de la réponse de l'API :

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. Filtrer les destinataires non signés : dans votre code (par exemple, en utilisant Python avec la bibliothèque requests ou Node.js avec Axios), analysez la réponse et filtrez les cas où status != "signed" et signedDateTime est nul. Pour les opérations par lots, utilisez le point de terminaison GET /envelopes avec des paramètres de requête tels que status=sent pour répertorier plusieurs enveloppes.

   Exemple de code Python :

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. Gestion des erreurs et meilleures pratiques : gérez les limites de débit (par exemple, 1 000 appels d'API par minute) et les erreurs telles que 404 (enveloppe introuvable). Pour les utilisateurs d'entreprise, tirez parti des plans d'API avancés de DocuSign, qui incluent les webhooks de l'API Connect pour les mises à jour d'état en temps réel. Cela peut éviter l'interrogation et réduire les appels d'API.

Cette approche garantit que vous pouvez notifier par programmation les destinataires non signés, intensifier les retards ou vous intégrer à des systèmes CRM tels que Salesforce. Dans un contexte commercial, une telle automatisation peut réduire le suivi manuel jusqu'à 70 %, selon les références de l'industrie des ressources pour développeurs DocuSign.

La tarification de l'API de DocuSign commence à partir de 600 $/an pour le plan Starter (40 enveloppes par mois), et s'étend aux options d'entreprise personnalisées. Pour les équipes des secteurs réglementés, la combinaison de cela avec les fonctionnalités IAM, telles que les pistes d'audit avancées et l'accès basé sur les rôles, peut améliorer la conformité sans développement personnalisé.

Vous comparez les plateformes de signature électronique avec DocuSign ou Adobe Sign ?

eSignGlobal offre une solution de signature électronique plus flexible et plus rentable, avec une conformité mondiale, une tarification transparente et un processus d'intégration plus rapide.

👉 Démarrer un essai gratuit

Explorer l'écosystème et les fonctionnalités IAM de DocuSign

DocuSign s'étend au-delà de la signature de base, offrant des outils intégrés tels que CLM (Contract Lifecycle Management) dans sa suite Intelligent Agreement Management (IAM). IAM CLM automatise la création, la négociation et l'exécution des contrats, en extrayant les données des enveloppes pour suivre les obligations. Pour les utilisateurs de l'API, il prend en charge l'intégration des cérémonies de signature et l'extraction des données des destinataires non signés dans les tableaux de bord.

En pratique, les entreprises utilisent IAM pour une visibilité de bout en bout : les entrées de destinataires non signés dans les enveloppes déclenchent des alertes de risque ou des flux de travail d'approbation. La tarification des mises à niveau IAM est personnalisée, généralement regroupée avec le plan Business Pro à 480 $/an par utilisateur, ajoutant des fonctionnalités de gouvernance et d'analyse.

Paysage concurrentiel : comparaison neutre

Le marché de la signature électronique est concurrentiel, les plateformes se différenciant par la profondeur de l'API, la tarification et la conformité régionale. Voici un tableau de comparaison Markdown des principaux acteurs, axé sur les fonctionnalités d'API pour la gestion des destinataires, la tarification de base et les avantages. Les données proviennent de sources publiques en 2025 pour garantir la neutralité.

Ce tableau met en évidence les compromis : DocuSign excelle dans un écosystème mature, tandis que d'autres plateformes privilégient l'abordabilité ou les avantages de niche.

Adobe Sign : aperçu de l'intégration et de l'API

Adobe Sign, qui fait partie d'Adobe Document Cloud, met l'accent sur les flux de travail centrés sur le PDF. Son API est similaire à DocuSign pour le suivi des destinataires, en utilisant GET /agreements/{agreementId}/participants pour répertorier les parties non signées. Il convient aux secteurs créatifs, avec des fonctionnalités d'édition PDF intégrées. La tarification commence à 10 $/mois pour les particuliers, et s'étend aux tarifs personnalisés pour les entreprises. L'avantage d'Adobe réside dans son intégration transparente avec Acrobat et les outils de marketing, mais les quotas d'API peuvent être restrictifs pour une utilisation à volume élevé.

HelloSign (Dropbox Sign) : simplicité pour les PME

HelloSign, maintenant Dropbox Sign, offre une API simple pour la gestion des enveloppes. Récupérez les destinataires non signés via GET /v3/signature_request/{request_id}, en filtrant par état. Il est réputé pour sa facilité d'utilisation, avec des modèles et des rappels intégrés. À 180 $/an pour le plan Essentials, il est économique pour les petites équipes, bien qu'il manque l'IAM avancé de DocuSign.

eSignGlobal : alternative optimisée pour l'APAC

eSignGlobal se positionne comme un concurrent mondial, prenant en charge la conformité dans plus de 100 pays et régions grand public. Il a un avantage particulier dans la région Asie-Pacifique (APAC), où les réglementations en matière de signature électronique sont fragmentées, très normatives et strictement réglementées, nécessitant souvent une approche approfondie de l'intégration de l'écosystème, plutôt qu'un modèle ESIGN/eIDAS basé sur un cadre commun aux États-Unis et dans l'UE. Les exigences de l'APAC nécessitent un couplage matériel/API profond avec les identités numériques gouvernementales à entreprise (G2B), un obstacle technique bien au-delà des méthodes de vérification par e-mail ou d'auto-déclaration courantes sur les marchés occidentaux.

L'API de la plateforme comprend des requêtes d'état des destinataires similaires à DocuSign, prenant en charge l'envoi en masse et les webhooks dans le plan Professional. La tarification est compétitive : la version Essential ne coûte que 16,6 $/mois (équivalent à 199 $/an dans certaines promotions), permettant jusqu'à 100 documents signés, des sièges d'utilisateurs illimités et la vérification du code d'accès, tout en maintenant la conformité. Il s'intègre de manière transparente à iAM Smart à Hong Kong et à Singpass à Singapour, ce qui le rend adapté aux opérations transfrontalières dans la région APAC.

Vous recherchez une alternative plus intelligente à DocuSign ?

eSignGlobal offre une solution de signature électronique plus flexible et plus rentable, avec une conformité mondiale, une tarification transparente et un processus d'intégration plus rapide.

👉 Démarrer un essai gratuit

Impact commercial et recommandations

D'un point de vue commercial, l'API de DocuSign reste une référence en matière de fiabilité pour le suivi des enveloppes, en particulier pour les entreprises mondiales. Cependant, les alternatives gagnent du terrain à mesure que les entreprises se développent dans des régions diversifiées. Pour ceux qui recherchent des alternatives à DocuSign, eSignGlobal se distingue comme une option de conformité régionale, en particulier dans la région APAC, équilibrant le coût et les fonctionnalités sans frais par siège. Évaluez en fonction de votre capacité, de vos intégrations et de votre emplacement géographique pour trouver la meilleure solution.