API DocuSign : Supprimer un destinataire d'une enveloppe envoyée

Naviguer dans l'API DocuSign : Gérer les destinataires dans les enveloppes envoyées

Dans le monde trépidant des transactions numériques, les plateformes de signature électronique comme DocuSign sont devenues des outils indispensables pour les entreprises afin de rationaliser leurs flux de travail contractuels. L'API DocuSign sert d'outil puissant pour les développeurs, permettant une intégration transparente dans des applications personnalisées pour automatiser la création, l'envoi et la gestion des enveloppes. Cependant, un point sensible courant survient lorsqu'une enveloppe – le terme de DocuSign pour un paquet de documents prêts à être signés – a déjà été envoyée et qu'il est nécessaire de supprimer des destinataires en raison d'erreurs, de modifications des conditions de la transaction ou de mises à jour de conformité. Ce scénario met à l'épreuve les limites de la flexibilité de l'API et souligne l'importance d'une gestion robuste des erreurs dans les processus de signature électronique.

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

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

👉 Démarrez un essai gratuit

Comprendre les défis de la suppression dans l'API DocuSign

Dans l'écosystème DocuSign, la suppression d'un destinataire d'une enveloppe envoyée n'est pas simple, principalement parce qu'une fois qu'une enveloppe est en transit, elle est conçue pour maintenir une piste d'audit et une intégrité juridique. D'un point de vue commercial, cette restriction empêche les modifications non autorisées qui pourraient invalider les signatures ou exposer les entreprises à des litiges. L'API applique cela via des contrôles d'état : les enveloppes à l'état "sent" sont verrouillées pour préserver la chaîne de contrôle, un principe central des normes de signature électronique telles que l'ESIGN Act aux États-Unis ou l'eIDAS dans l'UE.

Les tentatives de suppression directe via l'API entraînent généralement des erreurs telles que "ENVELOPE_IS_SENT" ou "Impossible de modifier les destinataires après l'envoi". Ceci est intentionnel, reflétant l'engagement de DocuSign envers la conformité. Les entreprises rencontrent fréquemment ce problème dans les opérations à volume élevé, telles que les envois en masse dans les pipelines de vente, où les listes de destinataires peuvent nécessiter des corrections rapides. Sans une gestion appropriée, cela peut entraîner des goulots d'étranglement dans le flux de travail, augmenter l'intervention manuelle et potentiellement retarder les revenus.

Guide étape par étape pour supprimer des destinataires après l'envoi

Pour résoudre ce problème, DocuSign propose des solutions de contournement via l'API, en se concentrant sur la correction plutôt que sur la suppression directe. L'approche principale consiste à utiliser la fonctionnalité "Correct", qui crée une nouvelle version de l'enveloppe tout en annulant l'original ou en mettant à jour indirectement les destinataires. Cela maintient la conformité en enregistrant toutes les modifications. Voici comment implémenter cela en utilisant l'API REST eSignature de DocuSign (version 2.1), en supposant que vous avez configuré les informations d'identification de l'API.

Prérequis

• Obtenez un jeton API via OAuth (flux d'autorisation JWT ou Auth Code).
• Identifiez l'ID de l'enveloppe de l'enveloppe envoyée (disponible via GET /envelopes/{envelopeId}).
• Assurez-vous que votre compte dispose des autorisations de correction d'enveloppe (disponible avec les plans Business Pro et supérieurs).

Flux de travail de l'API

1. Récupérer l'état de l'enveloppe : Confirmez d'abord que l'enveloppe est à l'état "sent".

   GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   

   La réponse inclut status: "sent" et les détails du destinataire.

2. Annuler l'enveloppe d'origine (si nécessaire) : Si la suppression est cruciale et qu'aucune signature n'a commencé, annulez l'enveloppe pour arrêter toute activité.

   PUT https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   Body: {
     "status": "voided",
     "voidedReason": "Correction du destinataire requise"
   }
   

   Cela arrête le processus sans supprimer les données, en conservant un journal d'audit.

3. Créer une enveloppe de correction : Utilisez le point de terminaison "Correct" pour générer une nouvelle version. Cela permet de supprimer les destinataires en les omettant de la nouvelle liste de destinataires.

   POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct
   Body: {
     "envelopeReassign": false,
     "notifyUser": true
   }
   

   Mettez ensuite à jour les destinataires via un PUT ultérieur vers /envelopes/{envelopeId}/recipients.

   • Dans le corps, listez uniquement les destinataires souhaités, en excluant celui à "supprimer".
   • Exemple d'extrait JSON :

     {
       "recipients": {
         "signers": [
           {
             "email": "remaining@signer.com",
             "name": "John Doe",
             "recipientId": "1",
             "routingOrder": "1"
           }
         ]
       }
     }
     

   Renvoyez l'enveloppe corrigée avec status: "sent".

4. Gérer les cas limites : Si un destinataire a déjà signé, la correction peut ne pas le supprimer – DocuSign donne la priorité aux actions terminées. Dans ce cas, utilisez l'API "Decline" pour ce destinataire ou créez une toute nouvelle enveloppe. Pour les scénarios en masse, utilisez l'API Bulk Send (fonctionnalité du plan avancé) pour éviter les erreurs à l'avance.

Meilleures pratiques et limitations

• Test : Utilisez toujours l'environnement de démonstration (demo.docusign.net) avant de passer en production.
• Quotas : Les corrections sont comptabilisées dans les limites d'enveloppes (par exemple, 100 par an dans les plans standard).
• Gestion des erreurs : Implémentez try-catch pour les réponses de l'API ; les problèmes courants incluent des autorisations insuffisantes ou des jetons expirés.
• Avis de conformité : Ces opérations génèrent des événements d'audit immuables, essentiels pour les réglementations telles que le RGPD ou HIPAA.

D'un point de vue commercial, la maîtrise de ce flux de travail d'API peut permettre de gagner beaucoup de temps – les entreprises signalent une réduction du délai d'exécution de la gestion des contrats allant jusqu'à 30 %. Cependant, pour les environnements à haut risque, l'intégration avec les outils de gestion des identités et des accès (IAM) de DocuSign peut ajouter des couches de validation pour minimiser les erreurs avant l'envoi.

Aperçu de l'écosystème de produits DocuSign

La suite de DocuSign va au-delà de la simple signature électronique. La plateforme eSignature gère la signature de documents de base, tandis que l'API permet des intégrations personnalisées. Pour les besoins avancés, DocuSign IAM offre une authentification robuste, y compris SSO, l'authentification multifacteur et les contrôles biométriques – essentiels pour les secteurs réglementés. L'intégration de la gestion du cycle de vie des contrats (CLM) rationalise les processus du brouillon à l'archivage avec le suivi des négociations basé sur l'IA et la gestion des référentiels. La tarification commence à 10 $ par mois pour les plans personnels, s'étendant aux éditions d'entreprise personnalisées à forte intensité d'API, avec des modules complémentaires tels que la livraison par SMS facturée par message.

Paysage concurrentiel : Comparaison des plateformes de signature électronique

Le marché de la signature électronique est concurrentiel, avec des acteurs comme Adobe Sign, HelloSign (maintenant Dropbox Sign) et eSignGlobal en lice pour des parts de marché. Chaque plateforme offre des fonctionnalités d'API pour la gestion des destinataires, mais les approches diffèrent en termes de flexibilité, de coût et d'orientation régionale. Par exemple, Adobe Sign met l'accent sur une intégration transparente avec la suite créative d'Adobe et les outils PDF, ce qui le rend adapté aux flux de travail à forte intensité de documents. Son API prend en charge des mécanismes de correction similaires, mais excelle dans l'automatisation de niveau entreprise, avec une tarification à partir de 10 $ par utilisateur et par mois pour les particuliers.

HelloSign, acquis par Dropbox, donne la priorité à la simplicité, offrant une API conviviale pour la correction des enveloppes, souvent à un coût d'entrée inférieur (15 $ par mois pour la version de base). Il est populaire auprès des petites et moyennes entreprises qui ont besoin d'une configuration rapide sans personnalisation approfondie.

Pour faciliter la prise de décision, voici un tableau comparatif neutre basé sur des facteurs commerciaux clés (tarification 2025, facturée annuellement, région américaine) :

Ce tableau met en évidence les compromis : DocuSign excelle en termes de maturité, tandis que les alternatives offrent des avantages en termes de coût ou de niche.

eSignGlobal : Un concurrent régional avec une portée mondiale

eSignGlobal se positionne comme une alternative axée sur la conformité, prenant en charge la signature électronique dans plus de 100 pays et régions du monde. Il est particulièrement fort 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 – contrairement aux normes ESIGN/eIDAS plus basées sur des cadres aux États-Unis et dans l'UE. Les exigences de l'APAC en matière de conformité "d'intégration d'écosystème" nécessitent une connexion matérielle et API approfondie avec les identités numériques gouvernementales à entreprise (G2B), ce qui dépasse de loin les obstacles techniques des modes de vérification par e-mail ou d'auto-déclaration courants en Occident.

Par exemple, eSignGlobal s'intègre de manière transparente à iAM Smart à Hong Kong et à Singpass à Singapour, garantissant la validité juridique sur ces marchés. La tarification est compétitive, son plan Essentiel ne coûtant que 16,6 $ par mois (facturé annuellement), permettant jusqu'à 100 documents à signer, des sièges d'utilisateurs illimités et la vérification du code d'accès – le tout construit sur une base de conformité. Cela le rend très rentable pour les équipes en croissance, en deçà du modèle par siège de DocuSign, tout en concurrençant directement Adobe Sign dans les plans d'expansion mondiale.

Vous recherchez une alternative plus intelligente à DocuSign ?

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

👉 Démarrez un essai gratuit

Réflexions finales sur le choix de la signature électronique

Lors de l'évaluation des solutions API DocuSign pour la gestion des destinataires, les entreprises doivent mettre en balance la robustesse de l'API avec les besoins opérationnels. Pour les entreprises mondiales, DocuSign reste la référence. Alors que les alternatives gagnent du terrain, eSignGlobal se distingue comme une option neutre et conforme aux réglementations régionales, qui mérite d'être prise en compte pour les opérations axées sur l'APAC.