API DocuSign : Comment ajouter un destinataire "Copie Carbone" après l'envoi ?

Comprendre les destinataires en copie carbone dans DocuSign

Dans le domaine de la signature électronique, l'API de DocuSign fournit des outils puissants pour automatiser les flux de travail documentaires, mais l'ajout de destinataires après la création d'une enveloppe peut être délicat. Les destinataires en "copie carbone" (CC) sont des rôles non signataires qui reçoivent une copie du document signé à des fins de consultation ou d'archivage, sans avoir besoin de signer ou d'approuver. D'un point de vue commercial, cette fonctionnalité est inestimable pour les équipes de conformité, les services juridiques ou les responsables des ventes qui doivent être informés sans modifier la chaîne de signature. Cependant, l'API de DocuSign a des limitations sur les modifications une fois qu'une enveloppe est envoyée, que nous explorerons en détail.

Cet article examine en profondeur les étapes pratiques pour ajouter des destinataires CC après l'envoi d'une enveloppe via l'API eSignature de DocuSign. Nous aborderons les prérequis, les appels d'API, les pièges potentiels et les meilleures pratiques, en nous référant à la documentation officielle et aux informations issues de mises en œuvre réelles. Pour les entreprises qui intègrent DocuSign, la compréhension de ces nuances peut éviter les interruptions de flux de travail et garantir des processus prêts pour l'audit.

Bases de la gestion des destinataires de l'API DocuSign

Avant d'ajouter des destinataires CC après l'envoi, il est essentiel de comprendre le cycle de vie des enveloppes de DocuSign. Une enveloppe représente un paquet de documents, et une fois "envoyée", elle est active, ce qui limite les modifications afin de protéger l'expérience du signataire et l'intégrité juridique. L'API REST eSignature (v2.1) gère ces interactions, nécessitant une authentification via JWT ou OAuth pour un accès sécurisé.

Concepts clés :

• Destinataires : Incluent les signataires, les approbateurs et les CC. Les CC sont ajoutés via le tableau carbonCopies dans l'objet destinataire.
• État de l'enveloppe : Une fois envoyée, une enveloppe est dans un état "sent" ou "delivered". Les modifications sont limitées ; vous ne pouvez pas ajouter de signataires qui nécessitent une action, mais les CC sont autorisés car ils ne modifient pas l'ordre de signature.
• Points de terminaison de l'API : Utilisez /envelopes/{envelopeId}/recipients pour les mises à jour.

D'un point de vue commercial, la tarification de l'API de DocuSign commence à 600 $ par an pour le plan Starter, prenant en charge jusqu'à 40 enveloppes par mois, ce qui convient aux petites intégrations, mais les besoins en volume élevé augmentent les coûts.

Guide étape par étape : Ajouter des destinataires CC après l'envoi

L'ajout de CC après l'envoi nécessite l'utilisation du mode correct ou d'une solution de contournement consistant à annuler et à renvoyer, car l'ajout direct après l'envoi n'est pas toujours simple. DocuSign recommande de planifier les destinataires à l'avance, mais pour les scénarios dynamiques (par exemple, l'ajout de responsables en fonction d'une logique métier conditionnelle), suivez ces étapes. Ce processus suppose que vous disposez d'un compte développeur et d'un jeton d'accès API.

Prérequis

1. Configuration de l'API : Intégrez le SDK DocuSign (pour Java, .NET, PHP, etc.) ou utilisez des appels REST bruts. Authentifiez-vous avec votre clé d'intégration et votre ID utilisateur.
2. ID d'enveloppe : Récupérez l'ID de la réponse d'envoi initiale (par exemple, via un POST sur /envelopes).
3. Autorisations : Assurez-vous que votre compte autorise les corrections d'enveloppe (activées dans "Features" sous les paramètres d'administration).
4. Vérification de l'état de l'enveloppe : Interrogez /envelopes/{envelopeId} pour confirmer qu'elle est dans l'état "sent" et qu'aucun signataire n'a terminé d'action verrouillant les modifications.

Conseil commercial : Pour les entreprises, le plan Advanced API (5 760 $ par an) débloque des fonctionnalités telles que l'envoi en masse et les webhooks, qui peuvent notifier automatiquement les CC une fois terminé.

Méthode 1 : Utiliser la correction d'enveloppe (recommandée pour les petites modifications)

La fonctionnalité "Correct" de DocuSign permet des modifications en cours sans annuler l'enveloppe, ce qui est idéal pour l'ajout de CC.

1. Lancer la correction :

   • PUT sur /envelopes/{envelopeId}/correct avec le corps :

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     Cela suspend temporairement l'enveloppe.

2. Ajouter des destinataires CC :

   • POST sur /envelopes/{envelopeId}/recipients avec les détails du CC :

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // Par exemple, "CC1"
           "routingOrder": 0  // Les CC n'affectent pas l'ordre
         }
       ],
       "resendEnvelope": false  // Ne pas renvoyer les notifications pour l'instant
     }
     

     • recipientId doit être unique ; évitez les conflits avec les destinataires existants.
     • Facultatif : Ajoutez accessControl pour un accès CC protégé par mot de passe.

3. Renvoyer ou notifier :

   • PUT à nouveau sur /envelopes/{envelopeId}/correct pour reprendre :

     {
       "resendEnvelope": true  // Déclenche des e-mails pour le nouveau CC
     }
     

     Le CC recevra une copie une fois l'enveloppe terminée ou sur demande.

Piège potentiel : Si l'enveloppe est "completed", elle ne peut pas être corrigée - utilisez des webhooks via la fonctionnalité Connect (plan Advanced) pour surveiller l'état.

Méthode 2 : Annuler et renvoyer (pour les scénarios complexes)

Si la correction n'est pas possible (par exemple, en raison d'actions du signataire), annulez l'enveloppe et recréez-la avec le nouveau CC.

1. Annuler l'enveloppe :

   • PUT sur /envelopes/{envelopeId} :

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. Recréer avec CC :

   • POST sur /envelopes avec la charge utile d'origine, plus le CC dans l'objet recipients :

     {
       "emailSubject": "Updated Document",
       "documents": [/* documents originaux */],
       "recipients": {
         "signers": [/* signataires originaux */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. Notifier les signataires originaux : Utilisez /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend pour chaque signataire afin de reprendre.

Observation commerciale : Cette méthode entraîne des coûts d'utilisation d'enveloppes supplémentaires (par exemple, Business Pro ~100 enveloppes par utilisateur par an, 480 $/utilisateur/an), elle convient donc aux corrections à faible volume. Suivez les quotas via le tableau de bord ou via l'API pour gérer.

Meilleures pratiques et limitations

• Gestion des erreurs : Les erreurs courantes incluent 400 (destinataire non valide) ou 403 (autorisations insuffisantes). Validez toujours d'abord avec un GET sur /envelopes/{envelopeId}/recipients.
• Tests : Utilisez le Developer Sandbox de DocuSign (gratuit) pour simuler sans consommer d'enveloppes de production.
• Conformité : L'ajout de CC maintient les pistes d'audit, conformément aux normes ESIGN/UETA, mais enregistrez les raisons pour éviter les litiges.
• Alternatives d'automatisation : Pour les besoins fréquents après l'envoi, intégrez des webhooks (plan Advanced) pour déclencher des notifications externes au lieu de modifications de l'API.

En pratique, les entreprises signalent des gains d'efficacité de 20 à 30 % en scriptant ces opérations via des SDK, mais pour les opérations à grande échelle, envisagez des plans Enterprise personnalisés pour un réglage illimité.

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 une intégration plus rapide.

👉 Démarrez un essai gratuit

Comparaison de DocuSign avec les principaux concurrents

Pour fournir une perspective équilibrée, comparons les capacités de l'API de DocuSign avec des alternatives telles qu'Adobe Sign, eSignGlobal et HelloSign (maintenant Dropbox Sign). Ce tableau est basé sur des données publiques de 2025, mettant en évidence la tarification, la gestion des destinataires et les forces régionales pour aider les entreprises à prendre des décisions lors de la sélection des fournisseurs.

Cette comparaison montre que DocuSign excelle en termes de profondeur d'API mature, mais à un coût plus élevé, tandis que les concurrents offrent une flexibilité pour des segments spécifiques.

Focus sur Adobe Sign

Adobe Sign, qui fait partie d'Adobe Document Cloud, offre une API transparente pour la gestion des destinataires, y compris un ajout de CC après l'envoi plus facile via son point de terminaison d'API "Amend". La tarification est compétitive, à partir de 10 $/utilisateur/mois pour la version de base, et s'étend à une version Enterprise personnalisée. Il convient aux entreprises déjà dans la suite Adobe, offrant un traitement PDF robuste et une conformité mondiale, bien que la latence en APAC puisse être un problème.

Focus sur eSignGlobal

eSignGlobal se positionne comme un acteur mondial, conforme dans plus de 100 pays grand public, avec une forte présence en Asie-Pacifique (APAC). Le paysage de la signature électronique en APAC est fragmenté, avec des normes élevées et des réglementations strictes - contrairement aux cadres ESIGN/eIDAS de type "cadre" des États-Unis/UE, l'APAC nécessite des solutions d'"intégration d'écosystème". Cela signifie un couplage matériel/API profond avec les identités numériques gouvernementales (G2B), un obstacle technique bien au-delà des modes de vérification par e-mail ou d'auto-déclaration courants en Occident. eSignGlobal résout ce problème grâce à des intégrations natives telles que iAM Smart à Hong Kong et Singpass à Singapour, garantissant la validité juridique sans frais supplémentaires.

La tarification est abordable, avec son plan Essential à 16,6 $/mois par an, permettant jusqu'à 100 signatures de documents, des places utilisateur illimitées et une vérification par code d'accès. Cette valeur axée sur la conformité la rend compétitive par rapport à DocuSign et Adobe Sign, en particulier pour les équipes transfrontalières à la recherche d'un coût total de possession inférieur.

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 une intégration plus rapide.

👉 Démarrez un essai gratuit

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

Pour les entreprises qui naviguent dans les flux de travail basés sur l'API, DocuSign reste un choix solide, bien que les modifications après l'envoi nécessitent une planification minutieuse. Avec l'essor des alternatives, tenez compte des besoins régionaux - eSignGlobal se distingue comme une option neutre et axée sur la conformité pour les opérations axées sur l'APAC. Évaluez en fonction de votre capacité, de votre intégration et de votre emplacement géographique pour une adéquation optimale.