DocuSign API：从已发送的信封中删除收件人

导航 DocuSign API：管理已发送信封中的收件人

在数字交易快节奏的世界中，像 DocuSign 这样的电子签名平台已成为企业简化合同工作流程的必不可少工具。DocuSign API 作为开发者强大的工具，允许无缝集成到自定义应用程序中，实现自动化信封创建、发送和管理。然而，一个常见的痛点出现在信封——DocuSign 对待签名准备文档包的术语——已经发送后，需要由于错误、交易条款变更或合规更新而移除收件人。这种场景考验了 API 灵活性的极限，并强调了电子签名流程中稳健错误处理的重要性。

比较电子签名平台与 DocuSign 或 Adobe Sign？

eSignGlobal 提供更灵活且成本效益更高的电子签名解决方案，具备全球合规、透明定价和更快的入职流程。

👉 开始免费试用

理解 DocuSign API 中的删除挑战

在 DocuSign 生态系统中，从已发送信封中删除收件人并非直截了当，主要因为一旦信封处于传输状态，它就被设计为维护审计轨迹和法律完整性。从业务角度来看，这种限制可以防止未经授权的更改，从而避免使签名无效或使公司面临争议。API 通过状态检查来强制执行这一点：处于“sent”状态的信封被锁定，以保留保管链，这是美国 ESIGN 法案或欧盟 eIDAS 等电子签名标准的核心原则。

通过 API 尝试直接删除通常会导致错误，例如“ENVELOPE_IS_SENT”或“发送后无法修改收件人”。这是故意的，反映了 DocuSign 对合规的承诺。企业在高容量操作中经常遇到这种情况，例如销售管道中的批量发送，其中收件人列表可能需要快速更正。如果没有适当处理，这可能会导致工作流程瓶颈、增加手动干预以及潜在的收入延迟。

发送后删除收件人的逐步指南

为了解决这个问题，DocuSign 通过 API 提供变通方法，重点关注更正而非直接删除。主要方法涉及使用“Correct”功能，这会创建新信封版本，同时作废原始版本或间接更新收件人。这通过记录所有变更来维护合规。以下是如何使用 DocuSign eSignature REST API（版本 2.1）实现它，假设您已设置 API 凭据。

先决条件

• 通过 OAuth（JWT 或 Auth Code 授权流程）获取 API 令牌。
• 从已发送信封中识别信封 ID（可通过 GET /envelopes/{envelopeId} 获取）。
• 确保您的账户具有信封更正权限（适用于 Business Pro 及更高计划）。

API 工作流程

1. 检索信封状态：首先确认信封处于“sent”状态。

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

   响应包括 status: "sent" 和收件人详细信息。

2. 作废原始信封（如果需要）：如果删除至关重要且尚未开始签名，则作废信封以停止所有活动。

   PUT https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   Body: {
     "status": "voided",
     "voidedReason": "需要收件人更正"
   }
   

   这会停止流程而不删除数据，从而保留审计日志。

3. 创建更正信封：使用“Correct”端点生成新版本。这允许通过从新收件人列表中省略它们来移除收件人。

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

   然后，通过后续 PUT 到 /envelopes/{envelopeId}/recipients 更新收件人。

   • 在正文中，仅列出所需的收件人，排除要“删除”的那个。
   • 示例 JSON 片段：

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

   使用 status: "sent" 重新发送更正后的信封。

4. 处理边缘情况：如果收件人已经签名，更正可能无法移除他们——DocuSign 优先考虑已完成的操作。在这种情况下，使用该收件人的“Decline” API 或创建全新的信封。对于批量场景，利用 Bulk Send API（高级计划功能）来预先避免错误。

最佳实践和限制

• 测试：始终在使用生产环境之前使用 Demo 环境（demo.docusign.net）。
• 配额：更正计入信封限制（例如，标准计划每年 100 个）。
• 错误处理：为 API 响应实现 try-catch；常见问题包括权限不足或令牌过期。
• 合规注意：这些操作会生成不可变的审计事件，这对于 GDPR 或 HIPAA 等法规至关重要。

从商业角度来看，掌握此 API 流程可以节省大量时间——企业报告合同管理周期时间缩短高达 30%。然而，对于高风险环境，与 DocuSign 的身份和访问管理 (IAM) 工具集成可以添加验证层，以最小化发送前错误。

DocuSign 产品生态系统概述

DocuSign 的套件超越了基本的电子签名。eSignature 平台处理核心文档签名，而 API 启用自定义集成。对于高级需求，DocuSign IAM 提供强大的身份验证，包括 SSO、多因素认证和生物识别检查——这对于受监管行业至关重要。合同生命周期管理 (CLM) 集成 AI 驱动的谈判跟踪和存储库管理，从草稿到归档简化流程。定价从个人计划的每月 10 美元开始，扩展到 API 密集型自定义企业版，并有附加功能如 SMS 交付按消息收费。

竞争格局：电子签名平台比较

电子签名市场竞争激烈，像 Adobe Sign、HelloSign（现为 Dropbox Sign）和 eSignGlobal 等玩家争夺市场份额。每种平台都提供收件人管理的 API 功能，但方法在灵活性、成本和区域重点上有所不同。例如，Adobe Sign 强调与 Adobe 创意套件和 PDF 工具的无缝集成，使其适合文档密集型工作流程。其 API 支持类似更正机制，但在企业级自动化中表现出色，定价从个人每月 10 美元/用户开始。

HelloSign，由 Dropbox 收购，优先考虑简单性，提供用户友好的 API 用于信封更正，通常入门成本较低（基本版每月 15 美元）。它深受需要快速设置而无需深度自定义的中小型企业欢迎。

为了帮助决策，以下是基于关键业务因素的中立比较表（2025 年定价，年付，美国地区）：

此表突出了权衡：DocuSign 在成熟度上表现出色，而替代方案提供成本或利基优势。

eSignGlobal：区域竞争者具备全球影响力

eSignGlobal 将自己定位为合规替代方案，支持全球 100 多个主流国家和地区的电子签名。它在亚太 (APAC) 地区特别具有优势，那里的电子签名法规碎片化、高标准且严格监管——与美国和欧盟更基于框架的 ESIGN/eIDAS 标准形成对比。APAC 要求“生态集成”合规，需要与政府对企业 (G2B) 数字身份的深度硬件和 API 级对接，这远超西方常见的电子邮件验证或自我声明模式的技术障碍。

例如，eSignGlobal 无缝集成香港的 iAM Smart 和新加坡的 Singpass，确保这些市场的法律有效性。定价具有竞争力，其 Essential 计划仅需每月 16.6 美元（年付），允许最多 100 个待签名文档、无限用户座位和访问代码验证——所有这些都建立在合规基础上。这使其对成长型团队高度成本效益，低于 DocuSign 的按座位模式，同时在全球扩张计划中与 Adobe Sign 直接竞争。

正在寻找 DocuSign 的更智能替代方案？

eSignGlobal 提供更灵活且成本效益更高的电子签名解决方案，具备全球合规、透明定价和更快的入职流程。

👉 开始免费试用

电子签名选择的最终思考

在评估 DocuSign API 解决方案用于收件人管理时，企业应权衡 API 稳健性与运营需求。对于全球企业，DocuSign 仍是基准。随着替代方案获得牵引力，eSignGlobal 作为中立、区域合规选项脱颖而出，值得考虑用于 APAC 重点操作。