DocuSign API：如何在发送后添加“Carbon Copy”收件人？

理解 DocuSign 中的碳拷贝收件人

在电子签名领域，DocuSign 的 API 提供了强大的工具来自动化文档工作流程，但是在信封创建后添加收件人可能会很棘手。“碳拷贝”（CC）收件人是一种非签名角色，他们会收到已签名文档的副本，用于查看或记录保存，而无需签名或批准。从业务角度来看，此功能对于合规团队、法律部门或销售经理来说非常宝贵，他们需要通知而无需更改签名链。然而，DocuSign 的 API 在信封发送后对修改有限制，我们将详细探讨这些限制。

本文深入探讨了通过 DocuSign eSignature API 在发送信封后添加 CC 收件人的实际步骤。我们将涵盖先决条件、API 调用、潜在陷阱和最佳实践，参考官方文档和实际实施见解。对于集成 DocuSign 的企业来说，理解这些细微差别可以防止工作流程中断，并确保审计就绪的流程。

DocuSign API 收件人管理基础

在发送后添加 CC 收件人之前，理解 DocuSign 的信封生命周期至关重要。信封代表文档包，一旦“发送”，它们就处于活动状态，此时更改受到限制，以保护签名者体验和法律完整性。eSignature REST API（v2.1）管理这些交互，需要通过 JWT 或 OAuth 进行身份验证以实现安全访问。

关键概念：

• 收件人：包括签名者、审批者和 CC。CC 通过收件人对象中的 carbonCopies 数组添加。
• 信封状态：发送后，信封处于“sent”或“delivered”状态。修改有限制；您不能添加需要行动的签名者，但 CC 是允许的，因为它们不会更改签名顺序。
• API 端点：使用 /envelopes/{envelopeId}/recipients 进行更新。

从商业角度来看，DocuSign 的 API 定价从 Starter 计划的每年 600 美元起，支持每月最多 40 个信封，适合小型集成，但高容量需求会增加成本。

逐步指南：在发送后添加 CC 收件人

在发送后添加 CC 需要使用 correct 模式或 void-and-resend 变通方法，因为直接发送后添加并不总是直截了当。DocuSign 推荐提前规划收件人，但对于动态场景（例如，根据条件业务逻辑添加经理），请按照以下步骤操作。此过程假设您拥有开发者帐户和 API 访问令牌。

先决条件

1. API 设置：集成 DocuSign SDK（适用于 Java、.NET、PHP 等）或使用原始 REST 调用。使用您的集成密钥和用户 ID 进行身份验证。
2. 信封 ID：从初始发送响应中检索 ID（例如，通过 /envelopes POST）。
3. 权限：确保您的帐户允许信封更正（在 Admin 设置下的“Features”中启用）。
4. 信封状态检查：查询 /envelopes/{envelopeId} 以确认它是“sent”状态，并且没有签名者完成锁定更改的行动。

业务提示：对于企业，Advanced API 计划（每年 5,760 美元）解锁了 Bulk Send 和 webhook 等功能，这些功能可以在完成时自动通知 CC。

方法 1：使用信封更正（推荐用于小更改）

DocuSign 的“Correct”功能允许在进度中进行修改，而无需 void 信封，适合添加 CC。

1. 启动更正：

   • PUT 到 /envelopes/{envelopeId}/correct，主体为：

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

     这会暂时暂停信封。

2. 添加 CC 收件人：

   • POST 到 /envelopes/{envelopeId}/recipients，带有 CC 详细信息：

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // 例如，“CC1”
           "routingOrder": 0  // CC 不影响顺序
         }
       ],
       "resendEnvelope": false  // 暂不重新发送通知
     }
     

     • recipientId 必须唯一；避免与现有收件人冲突。
     • 可选：添加 accessControl 以实现密码保护的 CC 访问。

3. 重新发送或通知：

   • 再次 PUT 到 /envelopes/{envelopeId}/correct 以恢复：

     {
       "resendEnvelope": true  // 触发新 CC 的电子邮件
     }
     

     一旦信封完成或按请求，CC 将收到副本。

潜在陷阱：如果信封已“completed”，则无法更正——使用 webhook 通过 Connect 功能（Advanced 计划）监控状态。

方法 2：Void 并重新发送（适用于复杂场景）

如果更正不可行（例如，由于签名者行动），则 void 信封并使用新 CC 重新创建它。

1. Void 信封：

   • PUT 到 /envelopes/{envelopeId}：

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

2. 使用 CC 重新创建：

   • POST 到 /envelopes，带有原始负载，加上 recipients 对象中的 CC：

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

3. 通知原始签名者：为每个签名者使用 /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend 以恢复。

业务观察：此方法会产生额外的信封使用成本（例如，Business Pro 每年每用户 ~100 个信封，480 美元/用户/年），因此适合低容量更正。通过 API 使用仪表板跟踪配额以管理。

最佳实践和限制

• 错误处理：常见错误包括 400（无效收件人）或 403（权限不足）。始终先使用 /envelopes/{envelopeId}/recipients GET 验证。
• 测试：使用 DocuSign 的 Developer Sandbox（免费）模拟，而不消耗生产信封。
• 合规性：CC 添加维护审计跟踪，符合 ESIGN/UETA 标准，但记录原因以避免争议。
• 自动化替代方案：对于频繁的发送后需求，集成 webhook（Advanced 计划）以触发外部通知，而不是 API 修改。

在实践中，企业报告通过 SDK 脚本这些操作可获得 20-30% 的效率提升，但对于高规模操作，请考虑 Enterprise 自定义计划以实现无限调整。

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

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

👉 开始免费试用

将 DocuSign 与关键竞争对手比较

为了提供平衡观点，让我们将 DocuSign 的 API 功能与 Adobe Sign、eSignGlobal 和 HelloSign（现为 Dropbox Sign）等替代方案进行比较。此表格基于 2025 年公开数据，突出定价、收件人管理和区域优势，帮助企业在供应商选择中做出决策。

此比较显示 DocuSign 在成熟 API 深度方面表现出色，但成本更高，而竞争对手为特定细分市场提供灵活性。

Adobe Sign 焦点

Adobe Sign 是 Adobe Document Cloud 的一部分，提供无缝 API 用于收件人管理，包括通过其“Amend” API 端点更容易的发送后 CC 添加。定价具有竞争力，基础版每月 10 美元/用户，扩展到 Enterprise 自定义。它适合已在 Adobe 套件中的企业，提供强大的 PDF 处理和全球合规性，尽管 APAC 延迟可能是个问题。

eSignGlobal 焦点

eSignGlobal 将自己定位为全球玩家，在 100 多个主流国家合规，尤其在亚太 (APAC) 地区具有强大优势。APAC 的电子签名景观碎片化，具有高标准和严格法规——不同于美国/欧盟的框架式 ESIGN/eIDAS，APAC 需要“生态系统集成”解决方案。这意味着与政府数字身份 (G2B) 的深度硬件/API 级对接，这是一个远超西方常见电子邮件验证或自我声明模式的的技术障碍。eSignGlobal 通过香港的 iAM Smart 和新加坡的 Singpass 等原生集成解决此问题，确保法律有效性而无需额外成本。

定价实惠，其 Essential 计划每年每月 16.6 美元，允许最多 100 个文档签名、无限用户席位，以及通过访问代码验证。此合规性导向的价值使其在与 DocuSign 和 Adobe Sign 的竞争中具有竞争力，尤其适合寻求更低 TCO 的跨境团队。

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

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

👉 开始免费试用

电子签名选择的最终思考

对于导航 API 驱动工作流程的企业来说，DocuSign 仍是可靠的选择，尽管发送后修改需要仔细规划。随着替代方案的兴起，请考虑区域需求——eSignGlobal 作为 APAC 导向操作的中立、合规导向选项脱颖而出。根据您的容量、集成和地理位置进行评估，以实现最佳匹配。