如何在DocuSign中通过UpdateEnvelope接口添加第二位签署人获取双电子签名？

初始信封创建要点 #

创建信封时必须将状态设为created（而非sent），仅添加第一位签署人的完整信息，确保信封处于可编辑状态。如果初始就设为sent，后续无法通过UpdateEnvelope修改收件人。

调用UpdateEnvelope接口添加第二位签署人 #

1. 请求配置

   • 请求方法：PUT
   • 请求路径：/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   • 请求头需携带有效的认证信息（如Bearer Token）

2. 请求体核心内容
   重点要包含recipients对象，添加第二位签署人，同时注意避免覆盖已有签署人：

   {
     "status": "created", // 若要直接发送可改为"sent"
     "recipients": {
       "signers": [
         {
           "recipientId": "2", // 需与第一位签署人的recipientId不重复
           "email": "second_signer@example.com",
           "name": "Second Signer",
           "tabs": {
             "signHereTabs": [
               {
                 "documentId": "1", // 对应信封内的文档ID
                 "pageNumber": "1",
                 "xPosition": "100",
                 "yPosition": "200"
               }
             ]
           }
         }
       ],
       "merge_recipients": true // 关键参数：设为true会合并新签署人到原有列表，而非覆盖
     }
   }
   

   • merge_recipients必须设为true，否则原有第一位签署人会被替换
   • 若后续无需再修改，可将status改为sent，触发发送流程

常见问题排查 #

• 接口调用失败：检查信封当前状态是否为created，已发送（sent）或已完成的信封无法修改收件人
• 原有签署人丢失：确认请求体中设置了merge_recipients: true，未设置的话会覆盖原有收件人列表
• 签名标签不显示：核对documentId、页码、坐标是否与实际文档匹配，确保标签位置有效
• 权限报错：确认API账号拥有编辑信封的权限，需包含envelopes:edit权限范围

内容的提问来源于stack exchange，提问作者sri ram