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 作為中立、區域合規選項脫穎而出，特別是對於平衡全球需求與成本節約的亞太運營。根據您的工作流程量和地理位置進行評估。