DocuSign API：如何從已簽署的文件中獲取「Tab Data」（表單資料）？

導航 DocuSign API 以提取表單數據：商業視角

在數字協議不斷演變的格局中，企業越來越依賴電子簽名平台如 DocuSign 來簡化工作流程並確保合規性。隨著組織規模的擴大，集成 DocuSign 的 API 對於自動化從已簽名文件中的提取數據變得至關重要。本文探討如何使用 DocuSign 的 API 檢索「Tab Data」——簽署過程中填充的表單欄位——為開發者和商業領導者提供實用見解。從商業角度來看，掌握此功能可以降低手動處理成本並提升數據分析能力，但需要理解 API 限制和最佳實踐，以避免集成陷阱。

正在比較帶有 DocuSign 或 Adobe Sign 的電子簽名平台？

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

👉 開始免費試用

DocuSign 中的 Tab Data 是什麼？

Tab Data 指的是 DocuSign 信封中表單欄位（或「標籤」）捕獲的結構化信息，例如由簽名者添加的文字框、複選框、日期或簽名。一旦文件被簽署，此數據代表完成的表單值，對於 CRM 更新、合規報告或發票生成等業務流程至關重要。在 DocuSign 的生態系統中，標籤透過平台的創作工具嵌入 PDF 文件中，並在完成後的伺服器端儲存其值。

從商業觀察來看，透過 API 提取 Tab Data 對於處理高容量協議的企業來說是一個變革性的功能。它使與 Salesforce 或 ERP 系統等工具的無縫集成成為可能，可能將數據輸入時間縮短 70-80%。然而，信封狀態（例如，已作廢或已拒絕）和數據序列化等方面的挑戰可能會使檢索複雜化，如果處理不當。

逐步指南：使用 DocuSign API 從已簽名文件中檢索 Tab Data

要在簽署後存取 Tab Data，您將使用 DocuSign 的 REST API（推薦使用 2.1 版以確保 2025 年的穩定性）。此過程假設您擁有開發者帳戶、API 憑據（集成金鑰、金鑰和用戶 ID）以及一個活躍的信封。API 端點透過 OAuth 2.0 進行安全保護，確保符合 ESIGN 和 eIDAS 等標準。

先決條件和設置

1. 獲取 API 存取權限：登入 DocuSign 開發者中心（developer.docusign.com）並創建應用。生成集成金鑰並啟用 JWT 或 Auth Code Grant 以進行身份驗證。對於生產環境，從沙箱切換到即時憑據。

2. 識別信封：確保信封處於「Completed」狀態。使用 GET /envelopes/{envelopeId} 端點進行驗證：

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

   這將返回信封詳細信息，包括狀態。

3. 身份驗證：實施 OAuth。對於 JWT，使用您的私鑰生成令牌：

   import requests
   from docusign_esign import ApiClient, EnvelopesApi
   
   api_client = ApiClient()
   api_client.host = "https://demo.docusign.net/restapi"
   api_client.request_header['Authorization'] = 'Bearer ' + access_token  # 來自 JWT 流程
   

商業提示：在高風險環境中，使用企業計劃以獲得更高的 API 配額（高級層自訂限制最高，起始價格為每年 5,760 美元），因為免費開發者沙箱每月上限為 25 個信封。

檢索 Tab Data：核心 API 調用

關鍵端點是 GET /envelopes/{envelopeId}/documents/{documentId}/form_data，但對於全面的 Tab Data，請將其與信封收件人和自訂欄位結合使用。以下是工作流程：

1. 列出信封中的文件： 首先獲取文件 ID，因為 Tab Data 與特定 PDF 相關聯。

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

   回應包括 documentId（例如，主要 PDF 的 1）。

2. 提取表單數據（標籤值）： 使用表單數據端點獲取所有填充的標籤：

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

   示例回應（JSON）：

   {
     "formData": [
       {
         "name": "customerName",
         "value": "John Doe",
         "pageNumber": 1,
         "xPosition": 100,
         "yPosition": 200,
         "width": 150,
         "height": 20
       },
       {
         "name": "signatureDate",
         "value": "2025-01-15",
         "recipient": "Signer1"
       }
     ]
   }
   

   這會捕獲文字、日期和其他欄位值。請注意：簽名本身不是「數據」，但可以透過 recipientId 引用。

3. 處理特定收件人的數據： 對於多簽名者信封，使用 GET /envelopes/{envelopeId}/recipients/{recipientId}/tabs 按收件人過濾。這將返回分配給該簽名者的標籤：

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

   回應包括 tabLabel（匹配您的表單欄位名稱）和 value。

4. 高級：自訂欄位和附件： 如果使用 Business Pro 功能如簽名者附件，請透過 GET /envelopes/{envelopeId}/custom_fields 檢索。對於完整審計追蹤（與合規相關），在信封查詢中附加 ?include=summary。

程式碼實現（Python 示例）

使用 DocuSign eSign SDK：

from docusign_esign import EnvelopesApi, EnvelopeFormData

envelopes_api = EnvelopesApi(api_client)
envelope_id = 'your-envelope-id'
account_id = 'your-account-id'
document_id = 1  # 主要文件

# 獲取表單數據
form_data_result = envelopes_api.get_form_data(account_id, envelope_id, document_id=document_id)
for fd in form_data_result.form_data:
    print(f"Field: {fd.name}, Value: {fd.value}")

此腳本輸出所有 Tab Data，準備導出到 CSV 或插入資料庫。

常見挑戰和最佳實踐

• 錯誤處理：API 速率限制（例如，中級計劃每小時 1,000 次調用，每年 3,600 美元）可能會限制大型查詢。實施帶有指數退避的重試機制。
• 數據隱私：透過在檢索後遮罩敏感欄位，確保 GDPR/eIDAS 合規性。
• 測試：使用沙箱信封模擬簽名而無需成本。對於批量場景，利用 Connect Webhooks 在完成事件上觸發數據拉取，減少輪詢開銷。
• 成本影響：API 調用計入信封配額（例如，標準計劃每月 100 個，每用戶每年 300 美元）。超額將產生計量費用，因此透過 API 使用中心監控。

從商業角度來看，此 API 集成可以透過自動化產生 ROI——企業報告合約週期加快 50%——但需要前期開發者時間（穩健設置需 2-4 週）。對於企業，DocuSign 的高級 API 層（每年 5,760 美元）解鎖批量發送和 webhook 功能，適合擴展。

DocuSign 的更廣泛產品套件

DocuSign 超越核心電子簽名，提供如 Intelligent Agreement Management (IAM) 等工具，該工具集成合約生命週期管理 (CLM) 以實現端到端工作流程。IAM CLM 自動化起草、談判和儲存，將 Tab Data 拉入分析儀表板進行風險評估。定價從增強計劃的自訂開始，強調 SSO 和大型團隊的治理。

競爭格局：電子簽名平台比較

在價值超過 50 億美元的電子簽名市場中，DocuSign 以強大的 API 能力領先，但替代方案在定價、合規性和區域焦點方面提供不同的優勢。以下是基於 2025 年公開數據的關鍵玩家的中立比較。

DocuSign 概述

DocuSign 在全球佔據主導地位，具有全面的 API 支持 Tab Data 提取，如前所述。其優勢在於企業級功能，如批量發送和身份驗證附加組件（計量費用）。然而，基於座位的定價對於大型團隊可能會急劇上升，並且亞太地區的延遲可能影響性能。

Adobe Sign 概述

Adobe Sign 與 Adobe Acrobat 生態系統集成，透過其 REST API（例如，GET /agreements/{agreementId}/formData）提供類似表單數據存取。它因無縫 PDF 處理和企業安全而受到讚譽，個人計劃起始價格為每月 10 美元/用戶。缺點包括高級自動化成本更高，以及與 DocuSign 相比自訂工作流程的靈活性較低。

eSignGlobal 概述

eSignGlobal 將自身定位為合規替代方案，支持全球超過 100 個主流國家的電子簽名。它在亞太地區表現出色，該地區電子簽名法規碎片化、高標準且嚴格監管——通常需要生態系統集成的途徑，如與政府數字身份的深度硬體/API 對接（G2B）。與美歐依賴電子郵件驗證或自我聲明的框架式 ESIGN/eIDAS 標準不同，亞太地區需要本地集成以確保法律有效性。eSignGlobal 的 Essential 計劃以每年 299 美元（約每月 24.9 美元，儘管促銷定價可降至相當於每月 16.6 美元）提供強大價值，允許最多 100 個簽名文件、無限用戶座位，並透過存取碼驗證。它無縫集成香港的 iAM Smart 和新加坡的 Singpass，使其成為無需額外費用的區域合規理想選擇。在全球範圍內，包括美國和歐盟，eSignGlobal 透過在成本上低於競爭對手的同時保持如 API 驅動表單數據檢索等功能來競爭。

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

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

👉 開始免費試用

HelloSign (Dropbox Sign) 和其他競爭對手

HelloSign，現為 Dropbox Sign，提供用於表單欄位提取的簡單 API（透過 GET /signature_request/{request_id}/details），針對小型團隊提供免費層。它對 SMB 友好，但缺乏 DocuSign 在自動化方面的深度。其他玩家如 PandaDoc 專注於帶有嵌入表單的提案，而 SignNow 強調移動優先體驗。

此表格突出了權衡：DocuSign 注重深度，eSignGlobal 注重亞太效率。

最終思考：選擇合適的方案

對於優先考慮 API 驅動數據提取的企業，DocuSign 仍是可靠選擇，因為其成熟生態系統。然而，隨著區域需求增長——特別是在合規密集領域——替代方案如 eSignGlobal 為尋求成本節省和本地化支持的 DocuSign 用戶提供平衡且區域優化的選項。根據您的容量和地理位置進行評估。