DocuSign API：如何更新正在处理中的信封的到期日期？

在 DocuSign API 中理解信封管理

在数字协议快速发展的世界中，管理进行中（或“飞行中”）信封是电子签名工作流程的关键方面。企业经常面临需要调整信封过期日期的情景，这可能是由于签名人响应延迟、谈判延长或项目时间表变化。DocuSign 的 API 提供了强大的工具来实现这一点，允许开发者在不中断流程的情况下保持合规性和效率。本文探讨了如何使用 DocuSign API 更新飞行中信封的过期日期，同时从电子签名市场的商业角度提供平衡的视角，讨论其影响和替代方案。

为什么要在飞行中信封中更新过期日期？

DocuSign 信封上的过期日期作为一种保障措施，在设定周期后自动使未签名的文档失效，以保护敏感信息并确保及时完成。然而，在现实世界的业务运营中，严格的截止日期可能导致不必要的失效，需要重新发送，从而增加行政开销和潜在成本。从商业角度来看，通过 API 扩展这些日期的能力有助于优化资源分配，减少信封数量费用（未使用的信封仍计入配额），并提升签名人满意度——这些是房地产、人力资源和金融等高容量行业中的关键因素。

更新飞行中信封的过期日期并不总是直截了当的，因为 DocuSign 的设计优先考虑安全性和可审计性。创建后对核心信封属性的直接修改受到限制，以防止篡改。相反，API 支持间接方法，如更正或使之失效并重新创建。这种方法符合 DocuSign 对合规性的重视，例如遵守美国 ESIGN 法案和欧盟 eIDAS 标准，确保变更被记录以便法律辩护。

逐步指南：通过 DocuSign API 更新过期日期

要处理此问题，开发者通常使用 DocuSign eSignature REST API（版本 2.1 或更高），这需要通过 OAuth 2.0（JWT 或授权码授权）进行身份验证。假设您有一个具有 API 访问权限的开发者账户；定价从 Starter 计划的每年 600 美元起，包括每月约 40 个信封。以下是一个实用的演练：

1. 检索信封状态

首先，确认信封处于飞行中状态（状态：“sent” 或 “in progress”）。使用 GET /accounts/{accountId}/envelopes/{envelopeId} 端点。

示例请求 (cURL):

curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Accept: application/json"

响应片段:

{
  "status": "sent",
  "expireDateTime": "2025-01-15T12:00:00Z",
  "envelopeId": "abc123"
}

这会拉取当前的过期日期。如果状态为 “voided” 或 “completed”，则无法更新——需要重新创建信封。

2. 更正信封（适用于小幅变更的首选方法）

对于尚未有签名人操作的飞行中信封，使用 PUT /accounts/{accountId}/envelopes/{envelopeId} 结合更正请求。虽然不支持直接编辑单个字段来更新过期日期，但您可以使之失效并使用新日期重新发送，或者使用“更正”功能间接重置计时器。

DocuSign 的更正 API 允许在未发生签名的情况下修改某些属性，如过期日期。准备一个更正信封定义：

更正请求主体 (JSON):

{
  "status": "sent",
  "expireAfter": "30",  // 从现在起的天数；根据需要调整（最大 999 天）
  "expireDateTime": "2025-02-15T12:00:00Z"  // 或指定绝对日期
}

cURL 示例:

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "clientUserId": "signer1",
  "routingOrder": "1",
  "corrector": {
    "email": "admin@company.com",
    "userId": "{userId}"
  },
  "envelopeDefinition": {
    "expireAfter": "60"
  }
}'

这将过期日期延长 60 天。请注意：更正要求信封可更正（无已完成标签），并且可能通知签名人变更，从而保留审计轨迹。

3. 使之失效并重新发送（适用于复杂更新）

如果信封有部分进度或直接编辑被阻止，首先使之失效，然后使用更新的过期日期重新创建。这在企业工作流程中很常见，以避免合规风险。

步骤 3a: 使信封失效

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "status": "voided",
  "voidedReason": "Extending expiration for ongoing negotiations"
}'

步骤 3b: 使用新定义重新发送 使用 POST /accounts/{accountId}/envelopes 重新创建，复制原始文档和收件人，但设置新的 expireAfter 或 expireDateTime。

新信封请求主体:

{
  "emailSubject": "Updated Agreement",
  "documents": [ /* Original docs */ ],
  "recipients": [ /* Original signers */ ],
  "expireAfter": "90",  // 新 90 天过期
  "status": "sent"
}

cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{ /* Full envelope definition with updated expiration */ }'

4. 最佳实践和限制

• 配额和成本： 每个使之失效/重新发送都会计入您的信封限制（Business Pro 计划为每年每用户约 100 个，定价为每年每用户 480 美元）。通过 API 使用仪表板监控以避免超额。
• 错误处理： 常见问题包括 400 Bad Request（无效状态）或 401 Unauthorized。在代码中使用 try-catch（例如 Node.js 或 Python SDK）。
• 安全性： 所有变更都会记录在信封的审计轨迹中，支持 DocuSign 的 IAM 功能，如 SSO 和 Enhanced 计划中的高级访问控制。
• 测试： 沙盒环境（开发者免费）在生产前是理想选择。

从商业角度来看，此过程简化了运营，但突显了 API 定价层级——Advanced 计划（每年 5760 美元）解锁批量发送和 webhook 以实现自动化，减少手动干预。

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

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

👉 开始免费试用

DocuSign 的更广泛生态系统和 IAM 功能

DocuSign 的 eSignature 平台，包括其 API，与身份和访问管理 (IAM) 工具无缝集成，以增强安全性。DocuSign 中的 IAM 包括 SSO 集成（例如与 Okta 或 Azure AD）、基于角色的访问控制和多因素认证，这些对于企业级部署至关重要。这些功能可在 Enhanced 计划中获得（50+ 用户的自定义定价），确保像过期日期变更这样的 API 驱动更新符合全球标准，而不会暴露敏感数据。定价从 Personal 计划的每年 120 美元起，到企业自定义计划，DocuSign 强调可扩展性，但 SMS 交付或 ID 验证等附加功能可能产生额外费用。

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

电子签名市场竞争激烈，DocuSign 在全球采用方面领先，但区域需求推动了替代方案。以下是基于定价、功能和合规性的关键平台中立比较（2025 年数据；实际值可能有所不同）。

此表格强调了 DocuSign 在强大 API 功能方面的卓越表现，但对于成长中的团队可能更昂贵，而其他平台提供灵活性。

Adobe Sign：以 PDF 为中心的替代方案

Adobe Sign 是 Adobe Document Cloud 的一部分，以其与 Acrobat 等 PDF 工具的深度集成脱颖而出，非常适合文档密集型工作流程。它支持类似于 DocuSign 的 API 更新，具有用于协议修改的端点，尽管过期变更通常需要协议修订。定价具有竞争力，个人版每月 10 美元，扩展到企业自定义计划，具有条件字段和支付等功能。然而，它在创意行业中闪耀，但对于非 Adobe 用户可能感觉捆绑式。

HelloSign：适用于中小企业的简易性

HelloSign（现为 Dropbox Sign）优先考虑用户友好的界面，具有快速模板创建和高阶层的无限发送。其 API 允许信封更正，包括通过更新调用扩展过期日期，但缺乏 DocuSign 在批量操作方面的深度。入门价每月 15 美元，适合小企业，重点在于无缝 Dropbox 同步，而不是企业合规性。

eSignGlobal：区域合规领导者

eSignGlobal 将自己定位为全球竞争者，在超过 100 个主流国家和地区合规，并在亚太地区具有强大优势。该地区法规碎片化、标准高且监督严格——不同于美国/欧盟的框架式 ESIGN/eIDAS，亚太需要“生态系统集成”解决方案。这意味着与政府数字 ID (G2B) 的深度硬件/API 集成，远远超过西方常见的电子邮件验证或自我声明模式。eSignGlobal 在此领域表现出色，无缝集成香港的 iAM Smart 和新加坡的 Singpass 以实现具有法律效力的签名。

定价具有竞争力，其 Essential 计划仅需每年账单每月 16.6 美元，允许最多 100 个电子签名文档、无限用户座位和访问代码验证——所有这些都建立在合规基础上。这种无座位费用模型为团队提供高价值，并配备 AI 工具用于风险评估和翻译。随着其扩展到美国/欧盟，eSignGlobal 通过更低成本和更快的亚太性能挑战 DocuSign 和 Adobe Sign 等现有玩家，包括无需额外开发者计划的批量发送。

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

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

👉 开始免费试用

商业洞察和最终思考

通过 API 管理飞行中信封反映了电子签名领域的更广泛趋势：自动化推动效率，但合规性和成本决定了选择。DocuSign 的 API 对于更新非常强大，但其基于座位的模式和亚太挑战促使探索替代方案。

对于寻求 DocuSign 替代品的用户，eSignGlobal 作为中立、区域合规选项脱颖而出，特别是对于平衡全球需求与成本节约的亚太运营。根据您的工作流程量和地理位置进行评估。