DocuSign API：從已經發送的信封中刪除收件人

導航 DocuSign API：管理已發送信封中的收件人

在數碼交易快節奏的世界中，像 DocuSign 這樣的數碼簽署平台已成為企業簡化合約工作流程的必不可少工具。DocuSign API 作為開發者強大的工具，允許無縫整合到自訂應用程式中，實現自動化信封建立、發送和管理。然而，一個常見的痛點出現在信封——DocuSign 對待簽名準備文件包的術語——已經發送後，需要由於錯誤、交易條款變更或合規更新而移除收件人。這種場景考驗了 API 靈活性的極限，並強調了數碼簽署流程中穩健錯誤處理的重要性。

比較數碼簽署平台與 DocuSign 或 Adobe Sign？

eSignGlobal 提供更靈活且成本效益更高的數碼簽署解決方案，具備全球合規、透明定價和更快的入職流程。

👉 開始免費試用

理解 DocuSign API 中的刪除挑戰

在 DocuSign 生態系統中，從已發送信封中刪除收件人並非直截了當，主要因為一旦信封處於傳輸狀態，它就被設計為維護審計軌跡和法律完整性。從業務角度來看，這種限制可以防止未經授權的變更，從而避免使簽名無效或使公司面臨爭議。API 透過狀態檢查來強制執行這一點：處於“sent”狀態的信封被鎖定，以保留保管鏈，這是美國 ESIGN 法案或歐盟 eIDAS 等數碼簽署標準的核心原則。

透過 API 嘗試直接刪除通常會導致錯誤，例如“ENVELOPE_IS_SENT”或“發送後無法修改收件人”。這是有意的，反映了 DocuSign 對合規的承諾。企業在高容量操作中經常遇到這種情況，例如銷售管道中的批量發送，其中收件人列表可能需要快速更正。如果沒有適當處理，這可能會導致工作流程瓶頸、增加手動干預以及潛在的收入延遲。

發送後刪除收件人的逐步指南

為了解決這個問題，DocuSign 透過 API 提供變通方法，重點關注更正而非直接刪除。主要方法涉及使用“Correct”功能，這會建立新信封版本，同時作廢原始版本或間接更新收件人。這透過記錄所有變更來維護合規。以下是如何使用 DocuSign eSignature REST API（版本 2.1）實現它，假設您已設定 API 憑據。

先決條件

• 透過 OAuth（JWT 或 Auth Code 授權流程）獲取 API 令牌。
• 從已發送信封中識別信封 ID（可透過 GET /envelopes/{envelopeId} 獲取）。
• 確保您的帳戶具有信封更正權限（適用於 Business Pro 及更高計劃）。

API 工作流程

1. 檢索信封狀態：首先確認信封處於“sent”狀態。

   GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   

   回應包括 status: "sent" 和收件人詳細資訊。

2. 作廢原始信封（如果需要）：如果刪除至關重要且尚未開始簽名，則作廢信封以停止所有活動。

   PUT https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   Body: {
     "status": "voided",
     "voidedReason": "需要收件人更正"
   }
   

   這會停止流程而不刪除資料，從而保留審計日誌。

3. 建立更正信封：使用“Correct”端點產生新版本。這允許透過從新收件人列表中省略它們來移除收件人。

   POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct
   Body: {
     "envelopeReassign": false,
     "notifyUser": true
   }
   

   然後，透過後續 PUT 到 /envelopes/{envelopeId}/recipients 更新收件人。

   • 在正文中，僅列出所需的收件人，排除要“刪除”的那個。
   • 示例 JSON 片段：

     {
       "recipients": {
         "signers": [
           {
             "email": "remaining@signer.com",
             "name": "John Doe",
             "recipientId": "1",
             "routingOrder": "1"
           }
         ]
       }
     }
     

   使用 status: "sent" 重新發送更正後的信封。

4. 處理邊緣情況：如果收件人已經簽名，更正可能無法移除他們——DocuSign 優先考慮已完成的操作。在這種情況下，使用該收件人的“Decline” API 或建立全新的信封。對於批量場景，利用 Bulk Send API（高級計劃功能）來預先避免錯誤。

最佳實踐和限制

• 測試：始終在使用生產環境之前使用 Demo 環境（demo.docusign.net）。
• 配額：更正計入信封限制（例如，標準計劃每年 100 個）。
• 錯誤處理：為 API 回應實現 try-catch；常見問題包括權限不足或令牌過期。
• 合規注意：這些操作會產生不可變的審計事件，這對於 GDPR 或 HIPAA 等法規至關重要。

從商業角度來看，掌握此 API 流程可以節省大量時間——企業報告合約管理週期時間縮短高達 30%。然而，對於高風險環境，與 DocuSign 的身份和存取管理 (IAM) 工具整合可以添加驗證層，以最小化發送前錯誤。

DocuSign 產品生態系統概述

DocuSign 的套件超越了基本的數碼簽署。eSignature 平台處理核心文件簽名，而 API 啟用自訂整合。對於高級需求，DocuSign IAM 提供強大的身份驗證，包括 SSO、多因素認證和生物識別檢查——這對於受監管行業至關重要。合約生命週期管理 (CLM) 整合 AI 驅動的談判追蹤和儲存庫管理，從草稿到歸檔簡化流程。定價從個人計劃的每月 10 美元開始，擴展到 API 密集型自訂企業版，並有附加功能如 SMS 交付按訊息收費。

競爭格局：數碼簽署平台比較

數碼簽署市場競爭激烈，像 Adobe Sign、HelloSign（現為 Dropbox Sign）和 eSignGlobal 等玩家爭奪市場份額。每種平台都提供收件人管理的 API 功能，但方法在靈活性、成本和區域重點上有所不同。例如，Adobe Sign 強調與 Adobe 創意套件和 PDF 工具的無縫整合，使其適合文件密集型工作流程。其 API 支持類似更正機制，但在企業級自動化中表現出色，定價從個人每月 10 美元/用戶開始。

HelloSign，由 Dropbox 收購，優先考慮簡單性，提供使用者友好的 API 用於信封更正，通常入門成本較低（基本版每月 15 美元）。它深受需要快速設定而無需深度自訂的中小型企業歡迎。

為了幫助決策，以下是基於關鍵業務因素的中立比較表（2025 年定價，年付，美國地區）：

此表突出了權衡：DocuSign 在成熟度上表現出色，而替代方案提供成本或利基優勢。

eSignGlobal：區域競爭者具備全球影響力

eSignGlobal 將自己定位為合規替代方案，支持全球 100 多個主流國家和地區的數碼簽署。它在亞太 (APAC) 地區特別具有優勢，那裡的數碼簽署法規碎片化、高標準且嚴格監管——與美國和歐盟更基於框架的 ESIGN/eIDAS 標準形成對比。APAC 要求“生態整合”合規，需要與政府對企業 (G2B) 數碼身份的深度硬體和 API 級對接，這遠超西方常見的電子郵件驗證或自我聲明模式的技術障礙。

例如，eSignGlobal 無縫整合香港的 iAM Smart 和新加坡的 Singpass，確保這些市場的法律有效性。定價具有競爭力，其 Essential 計劃僅需每月 16.6 美元（年付），允許最多 100 個待簽名文件、無限使用者座位和存取碼驗證——所有這些都建立在合規基礎上。這使其對成長型團隊高度成本效益，低於 DocuSign 的按座位模式，同時在全球擴張計劃中與 Adobe Sign 直接競爭。

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

eSignGlobal 提供更靈活且成本效益更高的數碼簽署解決方案，具備全球合規、透明定價和更快的入職流程。

👉 開始免費試用

數碼簽署選擇的最終思考

在評估 DocuSign API 解決方案用於收件人管理時，企業應權衡 API 穩健性與營運需求。對於全球企業，DocuSign 仍是基準。隨著替代方案獲得牽引力，eSignGlobal 作為中立、區域合規選項脫穎而出，值得考慮用於 APAC 重點操作。