DocuSign API：從帶有預填標籤的模板發送信封

使用 DocuSign API 簡化文件工作流程

在快節奏的數位業務營運世界中，像 DocuSign 這樣的電子簽名平台已成為自動化合約管理和減少文書工作的不可或缺工具。DocuSign API 以其在處理複雜工作流程方面的強大功能脫穎而出，特別是利用範本發送信封——DocuSign 對準備好簽名的文件包的稱呼——並帶有預填充標籤。此功能不僅節省時間，還在高容量環境中如銷售團隊或法律部門最小化錯誤。從業務角度來看，整合此類 API 可以帶來顯著的效率提升，研究顯示文件處理時間可減少高達 80%。

與 DocuSign 或 Adobe Sign 比較電子簽名平台？

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

👉 開始免費試用

掌握 DocuSign API：從範本發送信封

DocuSign eSignature API 是一個強大的開發者工具，允許企業將簽名功能直接嵌入其應用程式中。在其核心，一個「信封」是一個容器，用於一個或多個文件，可以路由用於簽名、批准或其他操作。DocuSign 中的範本預定義文件佈局、欄位（稱為標籤）和工作流程，使其非常適合重複任務，如入職或發票批准。

預填充標籤指的是在發送信封之前用資料填充這些欄位——如文字框、日期或複選框。這在收件人資訊已知的情況下特別有用，確保更順暢的簽名體驗。對於企業來說，此功能與 CRM 系統（如 Salesforce）或 ERP 工具無縫整合，實現自動化資料提取。

要透過 API 實現這一點，開發者通常使用 RESTful 端點，認證透過 OAuth 2.0 或 JWT 授權處理。DocuSign 的開發者沙箱提供免費測試環境，這對於迭代整合而無需產生生產成本的企業至關重要。

API 整合的先決條件

在深入程式碼之前，確保您有：

• 一個 DocuSign 開發者帳戶（免費註冊）。
• 用於認證的整合金鑰（應用程式 ID）和 API 權杖。
• 熟悉 JSON 負載，因為 API 使用此格式通訊。
• 您首選語言的 DocuSign SDK（例如 Java、.NET、Python），它簡化了 HTTP 請求。

企業還應考慮 API 定價層：Starter 計劃每年 600 美元，支持每月最多 40 個信封，適合小型整合，而 Advanced 計劃每年 5,760 美元解鎖批量發送和 webhook，適用於更大規模的操作。

帶預填充標籤發送信封的逐步指南

步驟 1：建立或擷取範本

首先，在 DocuSign Web 應用程式中上傳範本或透過 API。範本包括文件和放置在其上的標籤。標籤分類為：

• 文字標籤：用於姓名、地址等。
• 日期標籤：自動填充目前日期或自訂值。
• 複選框標籤：用於協議。
• 首字母/簽名標籤：用於簽名者操作。

使用 Templates API 列出現有範本：

GET /restapi/v2.1/accounts/{accountId}/templates

這將返回範本的 JSON 陣列。記下 templateId 以用於後續步驟。

步驟 2：準備信封定義

建構一個引用範本的信封物件。透過在負載中包含收件人資料和標籤值來預填充標籤。

以下是建立信封的範例 JSON（使用 Node.js 和 DocuSign SDK 進行說明）：

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'Please sign this document';
envelopeDefinition.status = 'sent'; // Options: 'created', 'sent', 'delivered'

// Reference the template
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // Matches template role
envelopeDefinition.templateReferences = [template];

// Define recipient and pre-fill tabs
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // For embedded signing if needed

// Pre-fill tabs (tabs from template)
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // Matches tab in template
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`Envelope ID: ${results.envelopeId}`);

此程式碼從範本建立信封，預填充「FullName」文字標籤為「John Doe」，並用今天的日期填充日期標籤。tabLabel 必須與範本中標籤分配的標籤完全匹配。

步驟 3：處理認證並發送

使用 JWT 或存取權杖進行認證。在生產環境中，根據您的帳戶區域使用 NA1（美國）或 EU1（歐洲）基礎路徑。使用以下方式發送信封：

const accessToken = await getJwtToken(); // Your auth function
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

對於批量情境，Advanced API 計劃支持每月最多 100 個信封，並從外部來源（如資料庫）預填充資料。

步驟 4：監控和擷取狀態

發送後，使用 webhook（Advanced 計劃中的 Connect 功能）或輪詢 /envelopes/{envelopeId} 端點來追蹤狀態。這對於業務工作流程至關重要，確保符合審計追蹤要求。

常見挑戰和解決方案

• 標籤匹配錯誤：確保標籤唯一且正確引用。首先使用 Template API 獲取標籤細節。
• 收件人路由：對於多簽名者信封，在範本中分配角色，並在 API 呼叫中映射它們。
• 限制：標準計劃將自動化發送限制在每年約 100 個/使用者；API 計劃有信封配額。
• 錯誤處理：API 回應包括錯誤程式碼（例如，400 表示無效標籤）；為暫態問題實現重試。

從商業角度來看，此 API 整合可以将手動資料輸入減少 70%，但企業必須權衡成本——API 附加元件如身份驗證會產生計量費用。

探索 DocuSign 的更廣泛生態系統

DocuSign 擴展超出基本電子簽名，提供如 Intelligent Agreement Management (IAM) CLM 等產品，這是一個合約生命週期管理解決方案。IAM CLM 自動化整個協議流程，從起草到談判和續訂，整合 AI 用於條款分析。它針對企業自訂定價，從 Enhanced 計劃開始，包括 SSO 和高級分析功能。這使其適合需要端到端合規的中大型企業。

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

電子簽名市場競爭激烈，DocuSign 在全球採用方面領先，但面臨提供專業優勢的競爭對手。Adobe Sign 強調與 Adobe 創意套件的無縫整合，適合文件密集型工作流程。它透過其 API 支持預填充表單，並符合美國 ESIGN/UETA 和歐洲 eIDAS。定價從個人每月 10 美元開始，擴展到企業自訂計劃，包括行動簽名和支付收集等功能。

eSignGlobal 將自己定位為區域強國，特別是在亞太地區 (APAC)，那裡電子簽名法規碎片化、高標準且嚴格監管。與美國 (ESIGN 法案) 或歐洲 (eIDAS) 的框架式標準不同，後者依賴電子郵件驗證或自我聲明，APAC 要求「生態系統整合」合規。這涉及與政府到企業 (G2B) 數位身份的深度硬體/API 級整合，將技術壁壘顯著提高到高於西方模型的水平。eSignGlobal 支持 100 個主流全球國家和地區的合規性，透過香港和新加坡的本地資料中心在 APAC 具有優勢。它與香港的 iAM Smart 和新加坡的 Singpass 原生整合，實現強大的身份驗證。定價更易獲取：Essential 計劃每月 16.6 美元，允許發送最多 100 個文件進行電子簽名、無限使用者席位，以及透過存取碼的文件/簽名驗證——在合規基礎上提供強大價值。eSignGlobal 正在全球擴展，包括美洲和歐洲，作為 DocuSign 和 Adobe Sign 的競爭替代品，具有略低成本和更快的區域性能。

HelloSign（現為 Dropbox 的一部分）專注於 SMB 的簡單性，提供類似於 DocuSign 的範本和預填充 API 支持，但入門成本更低（每月 15 美元/使用者）。它在與 Google Workspace 的整合方面表現出色，但在基礎計劃中缺乏高級企業功能，如批量發送。

此表格突出了中性權衡：DocuSign 用於規模，Adobe 用於設計工作流程，eSignGlobal 用於 APAC 效率，HelloSign 用於易用性。

全球電子簽名的監管細微差別

雖然標題重點關注 API 機制，但理解法規可以提升實施。在美國，ESIGN 法案和 UETA 為大多數商業交易提供與濕簽名等效的法律效力。歐洲的 eIDAS 框架要求合格電子簽名用於高保障需求。APAC 各不相同：新加坡的電子交易法案與 eIDAS 一致，但政府事務需要 Singpass，而香港的條例強調透過 iAM Smart 的安全認證。使用 DocuSign API 的企業必須配置標籤以符合合規欄位，如審計日誌，以滿足這些標準。

電子簽名選擇的最終思考

對於優先考慮 API 驅動自動化的企業，DocuSign 仍是堅實選擇，因為其成熟生態系統。然而，對於區域合規需求，特別是 APAC，eSignGlobal 等替代品提供量身訂做、成本效益高的選項，而不犧牲全球覆蓋。根據您的量級、整合和地理位置進行評估，以實現最佳匹配。