DocuSign API：如何通过 JSON 设置“提醒”和“到期”？

理解 DocuSign API 用于信封管理

在电子签名解决方案的竞争格局中，DocuSign 的 API 仍是开发者将自动化工作流集成到业务流程中的基石。随着公司扩展其数字运营，提醒和到期功能在确保文档及时完成而无需人工监督方面发挥着关键作用。本文探讨如何通过 JSON 在 DocuSign API 中配置这些设置，参考官方文档和实际实施见解。从业务角度来看，掌握这些 API 元素可以优化合同周期、减少行政负担，并在高容量环境中提升合规性。

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

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

👉 开始免费试用

在 DocuSign API 中设置提醒和到期：逐步指南

DocuSign 的 eSignature API 允许开发者将提醒和到期规则直接嵌入信封创建请求中。这些功能对于业务自动化至关重要，因为它们自动化跟进并防止文档无限期挂起，这可能会占用销售、HR 或法律团队的资源。提醒会在文档未签名的情况下以设定间隔通知签名者，而到期则会在指定时期后使信封无效，确保工作流效率。

API 集成的先决条件

在深入 JSON 负载之前，请确保您拥有：

• 一个具有 API 访问权限的 DocuSign 开发者账户（可通过开发者中心获取）。
• 使用 OAuth 2.0 或 JWT 设置的身份验证，用于安全的 API 调用。
• 熟悉 Envelopes: create 端点（POST /accounts/{accountId}/envelopes）。

API 使用 RESTful 端点，所有配置均通过请求的 JSON 正文中传递。API 使用定价属于 DocuSign 的开发者计划，从入门级别的 600 美元/年起开始，包括适合初始测试的基本信封配额。

通过 JSON 配置提醒

提醒在信封定义中的 reminders 对象中定义。该对象指定频率、首次提醒前的延迟以及尝试次数。企业经常使用此功能在客户合同或员工入职等场景中督促签名者，降低放弃率。

以下是信封创建请求的示例 JSON 片段：

{
  "status": "sent",
  "emailSubject": "Please sign this document",
  "documents": [
    {
      "documentBase64": "BASE64_ENCODED_DOCUMENT_CONTENT",
      "name": "Sample Agreement",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "reminders": {
    "reminderDelay": 2,  // Days before first reminder (e.g., 2 days after sending)
    "reminderFrequency": "daily",  // Options: daily, weekly, monthly
    "reminderOffset": 1,  // Number of days between reminders
    "reminderMaxAttempts": 5  // Total reminders sent (e.g., 5 attempts)
  }
}

• reminderDelay：设置初始等待期（以天为单位）。对于时间敏感的交易，1-3 天的值很常见。
• reminderFrequency：规定间隔——紧急事项使用 daily，标准合同使用 weekly。
• reminderOffset：提醒之间的间隙，与业务节奏一致。
• reminderMaxAttempts：限制总数以避免垃圾信息；DocuSign 根据信封量推荐 3-7 次。

要实施，请通过 POST 请求将此 JSON 发送到 Envelopes API。例如，使用 cURL：

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '@envelope.json'

在实践中，高级 API 计划（5760 美元/年）的企业受益于更高的配额，允许在批量发送中实现强大的提醒逻辑。在沙箱环境中测试确保配置符合合规需求，例如受监管行业的审计跟踪。

通过 JSON 实施到期

到期会在截止日期后自动拒绝未签名的信封，释放 API 配额并防止资源浪费。这在高速度销售管道中特别有价值，在那里文档可能否则会滞留。

expireAfter 和 expireNotify 设置嵌套在信封的顶级属性下，或在特定收件人的配置中以实现细粒度控制。

到期示例 JSON：

{
  "status": "sent",
  "emailSubject": "Action Required: Review and Sign",
  "documents": [
    // ... (same as above)
  ],
  "recipients": {
    "signers": [
      // ... (same as above)
    ]
  },
  "expireAfter": "30",  // Days until expiration (e.g., 30 days from send date)
  "expireNotify": true  // Whether to email the sender upon expiration (true/false)
}

• expireAfter：以天为单位指定（1-9999）。企业为紧急协议设置较短时期（7-14 天）以保持势头。
• expireNotify：默认为 false；启用它会警报发送者进行跟进行动，与 CRM 系统无缝集成。

对于收件人级别的到期（在多签名者工作流中有用），将其嵌入签名者对象中：

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "expireAfter": "15",  // Per-signer expiration
    "expireNotify": "1"  // Notify sender (1 = yes, 0 = no)
  }
]

结合提醒和到期可以创建全面的生命周期管理策略。例如，30 天到期加上 5 天后的每日提醒可以根据行业基准将完成率提高 20-30%。请注意，这些设置会消耗信封配额——标准计划限制为 ~100 个信封/用户/年，因此中间级别的 API 用户（3600 美元/年）获得自动化工作流的灵活性。

最佳实践和常见陷阱

从商业角度来看，过度配置提醒可能会增加 SMS/附加费用（按消息计费），而宽松的到期会占用基于座位的定价模型中的座位。始终使用 DocuSign 的 Swagger 文档验证 JSON 是否符合 API 模式。陷阱包括时区不匹配——全球团队使用 UTC——以及忽略拒绝原因，这些原因可以自定义以获得更好的分析。

在亚太地区，时延和合规性增加了复杂性，API 集成必须考虑区域附加功能，如 SMS 交付，这可能会提高成本。在生产部署前，在 DocuSign 沙箱中使用示例负载进行测试是可取的。

此 API 功能突显了 DocuSign 在开发者友好工具方面的优势，尽管企业应评估总成本，包括自动化上限（~10 个/用户/月）。

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

随着电子签名成为数字转型的核心，比较 DocuSign 与 Adobe Sign、eSignGlobal 和 HelloSign（现为 Dropbox Sign）等替代品揭示了不同的优势。DocuSign 在全球 API 稳健性方面表现出色，但其定价可扩展性面临审查，尤其是对于 API 密集型用户。Adobe Sign 与 Adobe 生态系统深度集成，适合创意工作流。eSignGlobal 针对亚太地区提供本地化合规性，而 HelloSign 为 SMB 提供简单性。

主要玩家的概述

DocuSign：市场领导者，具有全面的 API 功能，包括上述提醒和到期。其优势在于企业级安全性和集成，但基于座位的定价可能会为团队升级。平台在更高级别支持无限信封，尽管自动化发送受限。

Adobe Sign：Adobe 的解决方案强调与 PDF 工具和 Acrobat 的无缝集成，适合文档密集型行业。它提供类似的 API 控制，用于提醒（通过“notification”设置）和到期（最多 999 天），JSON 负载镜像 DocuSign 的结构。定价从个人 10 美元/用户/月开始，扩展到企业自定义报价。它在美国合规性方面特别强大，但高级 API 使用可能产生附加费用。

eSignGlobal：此亚太地区专注的提供商支持 100 个主流全球国家和地区的合规性，在亚太地区具有显著优势。该地区的电子签名格局碎片化，具有高标准和严格法规——与美国/欧盟的框架式 ESIGN/eIDAS 形成对比。亚太地区要求“生态系统集成”方法，需要与政府数字身份（G2B）的硬件/API 级深度对接，远超西方常见的电子邮件验证或自我声明模型。eSignGlobal 在全球范围内与 DocuSign 和 Adobe Sign 直接竞争，包括美洲和欧洲，通过成本效益计划。其 Essential 版本仅需 16.6 美元/月（年度），允许最多 100 个文档签名、无限用户座位和访问代码验证——所有这些基于合规、高价值基础。它与香港的 iAM Smart 和新加坡的 Singpass 无缝集成，解决区域痛点，如数据驻留和时延。

HelloSign (Dropbox Sign)：被 Dropbox 收购，它优先考虑用户友好界面和文件存储协同。API 支持通过 JSON 实现提醒和到期，具有更简单的配额（例如，免费级别的 20 个信封/月）。定价从 Essentials 的 15 美元/月开始，吸引小团队，但与 DocuSign 相比，对于企业 API 需求的可扩展性较差。

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

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

👉 开始免费试用

Markdown 比较表格

此表格突显中性权衡：DocuSign 用于深度，Adobe 用于集成，eSignGlobal 用于区域价值，HelloSign 用于可访问性。

电子签名选择的最终思考

总之，通过 JSON 在 DocuSign 的 API 中配置提醒和到期可以简化业务运营，但选择正确的平台取决于规模、地区和预算。对于寻求 DocuSign 替代品的用户，eSignGlobal 以其区域合规性和强大的全球影响力脱颖而出。