DocuSign API：如何使用「Composite Templates」來合併多個 PDFs？

導航 DocuSign API 以實現高效文件工作流程

在快節奏的數位業務營運世界中，像 DocuSign 這樣的電子簽名平台已成為簡化合約管理和減少文書工作的必不可少工具。從小型團隊到大型企業，這些工具實現了安全、合規的簽名流程。DocuSign API 生態系統中的一項關鍵功能是複合模板，它允許開發者將多個 PDF 合併到一個信封中進行簽名。這一功能對於處理複雜工作流程的企業特別有價值，例如多方協議或自動化文件組裝。本文將探討如何在 DocuSign API 中實現複合模板，參考官方文件和實際業務應用，同時保持對商業環境中其實用性的中立視角。

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

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

👉 開始免費試用

利用 DocuSign API 的複合模板進行 PDF 合併

什麼是複合模板？

DocuSign eSignature API 中的複合模板是一種強大的方法，用於在單個信封中組合多個文件和簽名配置。在 DocuSign 術語中，「信封」是一個或多個需要簽名的文件的容器。傳統的信封按順序處理文件，但複合模板支援並行組裝，允許您將不同的 PDF 附加到特定接收者，同時定義跨文件的標籤（簽名字段）。這非常適合像貸款申請這樣的場景，其中封面、條款 PDF 和披露表格需要由同一方簽名，而無需手動合併。

從業務角度來看，此功能減少了 API 呼叫、最小化了文件路由錯誤，並加速了周轉時間——這對銷售團隊關閉交易或人力資源處理入職包至關重要。根據 DocuSign 的開發者資源，複合模板可在 Intermediate 和 Advanced API 層級中使用，這些計劃的年費從約 3,600 美元起，適用於中等使用量。

使用複合模板的逐步指南

要使用複合模板合併多個 PDF，您將與 DocuSign REST API（版本 2.1 或更高）進行互動。前提條件包括 DocuSign 開發者帳戶（提供免費沙箱）和透過 OAuth 獲取的 API 憑據。以下是實際操作指南：

1. 準備您的文件和模板：

   • 將您的 PDF 上傳到 DocuSign 的臨時儲存，或透過 base64 編碼引用它們。例如，準備 pdf1.pdf（合約）和 pdf2.pdf（附錄）。
   • 如果可重用，在 DocuSign Web 應用中建立模板。每個模板可以包含預定義的標籤，如簽名、日期或文字欄位。從 DocuSign 儀表板記錄模板 ID。

2. 設定信封定義：

   • 使用 /envelopes 端點建立新信封。在 JSON 請求主體中結構化 compositeTemplates 陣列。
   • 關鍵元素：
     • document：內聯或遠端 PDF。
     • serverTemplates 或 inlineTemplates：連結到現有模板。
     • recipients：定義簽名者（例如，簽名者角色）並將它們附加到複合模板。

   示例 JSON 片段（使用 Node.js 或類似工具進行 API 呼叫）：

   {
     "status": "sent",
     "emailSubject": "Please sign the merged agreement",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Main Contract",
           "fileExtension": "pdf",
           "documentId": "1"
         },
         "serverTemplates": [
           {
             "sequence": "1",
             "templateId": "your-template-id-1"
           }
         ],
         "inlineTemplates": [
           {
             "sequence": "1",
             "recipients": {
               "signers": [
                 {
                   "email": "signer@example.com",
                   "name": "John Doe",
                   "recipientId": "1",
                   "tabs": {
                     "signHereTabs": [
                       {
                         "documentId": "1",
                         "pageNumber": "1",
                         "xPosition": "100",
                         "yPosition": "200"
                       }
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       {
         "compositeTemplateId": "template2",
         "document": {
           "documentBase64": "base64_of_pdf2",
           "name": "Addendum",
           "fileExtension": "pdf",
           "documentId": "2"
         },
         "serverTemplates": [
           {
             "sequence": "2",
             "templateId": "your-template-id-2"
           }
         ]
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "routingOrder": "1"
         }
       ]
     }
   }
   

   這將 pdf1 和 pdf2 合併到一個信封中。第一個複合模板將模板 1 附加到第一個 PDF 並添加簽名標籤；第二個透過模板 2 添加附錄。接收者在合併文件上簽名，而無需查看單獨的信封。

3. 處理合併邏輯：

   • 使用 documentId 唯一引用 PDF。來自模板的標籤適用於特定文件，但在統一視圖中顯示。
   • 對於批量合併，與 Bulk Send API 整合（Business Pro 或 Advanced 計劃），每年每用戶上限約 100 次發送。
   • 錯誤處理：驗證 base64 大小（每個文件上限 5MB）並確保 OAuth 範圍包括 signature。

4. 發送並監控信封：

   • POST 到 https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes。
   • 透過 /envelopes/{envelopeId} 擷取狀態。完成的信封透過 API 返回合併 PDF。
   • 業務提示：在生產環境中，使用 webhook（Advanced 計劃中的 Connect 功能）進行簽名完成的即時通知。

5. 測試和最佳化：

   • 沙箱測試不收取信封配額。在 API 儀表板監控使用量以避免超額——Starter 計劃限制為每月 40 個信封。
   • 對於複雜合併，與 PowerForms 結合用於面向公眾的模板，提升電子商務或合作夥伴入職的可擴展性。

根據行業基準，這種方法可以在高容量環境中將文件準備時間縮短 50-70%。然而，對於企業，自訂整合可能需要 Enterprise API 計劃，定價根據容量自訂。

與 DocuSign IAM CLM 的整合

DocuSign 的智能協議管理 (IAM) 和合約生命週期管理 (CLM) 擴展了複合模板的價值。IAM 提供 AI 驅動的風險評估和條款提取，而 CLM 提供端到端工作流程自動化，包括模板庫和分析。在 API 上下文中，這些與複合模板整合，用於動態 PDF 生成——例如，從 CRM 系統拉取資料填充合併文件。金融等受監管行業的企業受益於 IAM 的合規工具，如審計追蹤和 SSO，儘管像身份驗證這樣的附加功能會產生計量費用。

在競爭格局中評估電子簽名平台

隨著企業全球化，選擇電子簽名提供商需要平衡 API 靈活性、合規性和成本。DocuSign 以強大的 API 功能領先，如複合模板，但替代方案提供不同的優勢。Adobe Sign 在以 PDF 為中心的工作流程中表現出色，與 Adobe Acrobat 無縫整合，用於合併前的先進編輯。其 API 透過「協議」支援類似的複合結構，基本計劃從每月 10 美元/用戶起。

HelloSign（現為 Dropbox Sign）提供使用者友好的 API 用於簡單合併，強調 SMB 的易用性，其每月 15 美元/用戶計劃提供無限模板。它缺乏 DocuSign 在條件邏輯方面的深度，但與 Google Workspace 等工具的快速整合表現出色。

eSignGlobal 將自身定位為全球競爭者，支援 100 個主流國家和地區的合規性。它在亞太地區 (APAC) 具有優勢，那裡的電子簽名法規碎片化、高標準且嚴格監管——往往需要生態系統整合的方案，而不是美國和歐洲常見的基於框架的 ESIGN/eIDAS 模型。APAC 要求與政府到企業 (G2B) 數位身份的深度硬體/API 級對接，這提高了超出電子郵件驗證或自我聲明的技術門檻。eSignGlobal 與香港的 iAM Smart 和新加坡的 Singpass 無縫整合，提供 Bulk Send 和 AI 合約工具等功能。其 Essential 計劃年費 16.6 美元/月，允許 100 次文件發送、無限使用者席位和存取碼驗證——在合規基礎上提供強大價值，比競爭對手略有成本優勢。該平台正在積極擴展歐洲和美洲市場，以挑戰現有領導者。

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

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

👉 開始免費試用

競爭對手比較表

此表突出了中立的權衡：DocuSign 適合高容量 API 需求，而其他平台優先考慮可負擔性或區域適應性。

電子簽名選擇的最終思考

總之，DocuSign 的複合模板提供了一種可靠的方式，透過 API 合併 PDF，提升業務工作流程的效率。對於尋求替代方案的團隊，eSignGlobal 作為中立、區域合規選項脫穎而出，特別是針對 APAC 操作。