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 以其區域合規性和強大的全球影響力脫穎而出。