DocuSign API：使用伺服器端文件建立複合範本

高效文檔工作流程的 DocuSign API 導航

在數字協議不斷演變的格局中，DocuSign 的 API 作為一款強大的工具脫穎而出，專為開發者和企業設計，用於自動化電子簽名。複合模板尤其允許可重用的文檔結構，從而簡化重複的簽名流程。這種方法對於處理高容量合同的企業特別有價值，一致性和效率可以顯著降低營運成本。透過利用伺服器端文檔，團隊可以預填充和自訂模板，而無需依賴客戶端上傳，從而提升安全性和控制力。

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

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

👉 開始免費試用

揭秘 DocuSign API 中的複合模板

DocuSign API 中的複合模板是一種強大的功能，用於將多個文檔、收件人和簽名字段組合成交一個單一的可重用信封。與基本模板不同，複合模板允許將伺服器託管的文檔與動態元素合併，非常適合 HR 入職或銷售協議等場景，其中文檔需要透過程式方式組裝。這種伺服器端方法確保文檔透過 API 呼叫安全儲存和存取，最大限度地減少與使用者上傳相關的暴露風險。

從業務角度來看，採用複合模板可以透過減少手動干預來優化工作流程。例如，一家金融服務公司可能使用它們來捆綁貸款申請與披露表格，從 CRM 系統預填充收件人資料。API 的靈活性支持可擴展性，但需要圍繞認證、信封創建和錯誤處理進行仔細規劃，以避免合規陷阱。

逐步指南：使用伺服器端文檔創建複合模板

要使用 DocuSign 的 API 和託管在您伺服器上的文檔創建複合模板，開發者通常會與 eSignature REST API（2.1 版或更高）進行互動。此過程涉及透過 OAuth 2.0 進行認證、模板定義和信封組裝。下面，我們概述了關鍵步驟，參考官方 DocuSign 文檔以及企業實施中的最佳實踐。

步驟 1：設置認證和 API 存取

首先，透過 DocuSign 開發者中心獲取 API 憑證。使用 JWT Grant 或 Authorization Code Grant 進行安全的令牌檢索。對於伺服器端操作，JWT 是首選，因為它允許自動化、非互動式認證。安裝 DocuSign SDK（適用於 Node.js、Python、Java 等）以簡化 HTTP 請求。

使用 DocuSign SDK 的 Node.js 示例：

const dsApi = require('docusign-esign');
const apiClient = new dsApi.ApiClient();
apiClient.setBasePath('https://demo.docusign.net/restapi'); // 生產環境使用生產 URL
const accessToken = await getJwtToken(); // 您的 JWT 函數
apiClient.addDefaultHeader('Authorization', `Bearer ${accessToken}`);
const envelopesApi = new dsApi.EnvelopesApi(apiClient);

這種基礎設置確保所有後續呼叫都經過認證，這是維護業務環境中資料完整性的關鍵步驟。

步驟 2：上傳並引用伺服器端文檔

伺服器端文檔被上傳到 DocuSign 的臨時儲存或透過 URL/位元組流直接引用。對於複合模板，在信封定義中使用 compositeTemplates 陣列。首先，使用 uploadDocument 方法上傳您的文檔，或將其作為 base64 編碼的位元組提供。

關鍵考慮因素：文檔必須採用支持的格式（PDF、DOCX）。為確保安全，避免暴露敏感文件；使用 DocuSign 的文檔上傳 API 處理傳輸。

上傳文檔的示例請求主體：

{
  "fileName": "Agreement.pdf",
  "documentBase64": "JVBERi0xLjQK..." // 伺服器文件的 Base64 編碼
}

上傳後，為其分配 documentId（例如，“1”）以在複合模板中引用。

步驟 3：定義複合模板結構

複合模板將內聯文檔（伺服器端）與現有模板結合。在 EnvelopeDefinition 中的 compositeTemplates 屬性下建構其結構。

基本元素：

• ServerTemplate：透過 ID 引用預先存在的 DocuSign 模板，用於可重用組件，如簽名標籤。
• InlineTemplate：嵌入伺服器端文檔並動態定義收件人/標籤。
• Sequence：排序複合模板（例如，伺服器的文檔 1，然後是模板 2）。

示例信封定義 JSON：

{
  "status": "sent",
  "compositeTemplates": [
    {
      "compositeTemplateId": "1",
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "your-template-guid",
          "sharedTemplateInstanceRoleName": "Sender"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "2",
          "recipients": {
            "signers": [
              {
                "email": "recipient@example.com",
                "name": "John Doe",
                "recipientId": "1",
                "tabs": {
                  "signHereTabs": [
                    {
                      "xPosition": "100",
                      "yPosition": "200",
                      "documentId": "1",
                      "pageNumber": "1"
                    }
                  ]
                }
              }
            ]
          },
          "documents": [
            {
              "documentId": "1",
              "name": "ServerDoc.pdf",
              "documentBase64": "JVBERi0xLjQK...", // 您的伺服器文檔
              "fileExtension": "pdf"
            }
          ]
        }
      ]
    }
  ]
}

這將伺服器文檔與模板合併，透過標籤放置簽名字段。業務觀察者指出，精確的標籤定位（使用錨字符串或座標）對於專業輸出至關重要，可防止多頁文檔中的錯位。

步驟 4：創建並發送信封

在 EnvelopesApi 上呼叫 createEnvelope 方法：

const envelope = new dsApi.EnvelopeDefinition();
envelope.setCompositeTemplates([compositeTemplate]); // 來自步驟 3
const results = await envelopesApi.createEnvelope('accountId', { envelopeDefinition: envelope });
console.log('Envelope ID:', results.envelopeId);

透過 webhook 或輪詢監控狀態。對於生產環境，集成錯誤處理以應對配額限制（例如，API 計劃從每年 600 美元起，支持每月 40 個信封）。

步驟 5：最佳實踐和故障排除

• 安全性：使用信封加密和基於角色的存取控制。伺服器端處理符合美國 ESIGN Act 等標準，確保法律可執行性。
• 可擴展性：對於高容量使用，選擇高級 API 計劃（每年 5,760 美元），支持批量發送。
• 常見問題：無效的 base64 編碼（驗證伺服器文件）；模板 ID 不匹配（透過 GET /templates 驗證）。
• 測試：使用 DocuSign 的沙盒迭代，而無需產生成本。

在商業應用中，此方法已證明可將簽名週期縮短高達 70%，根據行業報告，儘管 API 複雜性可能需要開發者資源。

探索 DocuSign 的更廣泛產品套件

DocuSign 超越核心電子簽名，提供集成解決方案，如智能協議管理 (IAM) 和合同生命週期管理 (CLM)。IAM 利用 AI 進行合同分析、風險評估和自動化，幫助企業從協議中提取洞見。CLM 作為企業級的一部分，提供端到端的合同管理，從起草到續訂，具備條款庫和談判追蹤等功能。這些工具通常針對大型組織進行自訂，提升合規性和效率，但價格高昂，沒有公開定價——通常基於容量談判。

電子簽名的定價從個人版（每月 10 美元，5 個信封）開始，擴展到商業專業版（每使用者每月 40 美元），包括批量發送。API 存取需要單獨的開發者計劃，強調 DocuSign 的基於座位的模式，這可能使成長型團隊的成本上升。

競爭格局：中立比較

電子簽名市場有強大的參與者，每個都有獨特的優勢。DocuSign 在全球採用率和 API 深度方面領先，Adobe Sign 在 PDF 集成方面表現出色，eSignGlobal 專注於亞太地區 (APAC) 合規性，HelloSign（現為 Dropbox Sign）優先考慮中小企業的簡單性。下面是一個基於關鍵業務因素的 Markdown 比較表格：

此表格突出了權衡：DocuSign 的深度適合複雜工作流程，而替代方案提供成本或區域優勢。

Adobe Sign 與 Adobe Document Cloud 集成，為 PDF 密集型使用者提供無縫體驗。它支持條件欄位和移動簽名，定價與 DocuSign 類似，但受益於 Adobe 的分析工具。然而，其 API 雖然強大，但經常被批評在自訂集成中的學習曲線比 DocuSign 的 SDK 更陡峭。

eSignGlobal 將自身定位為涵蓋 100 個主流國家的合規替代方案，在亞太地區 (APAC) 具有特別優勢。APAC 的電子簽名格局以碎片化、高標準和嚴格法規為特徵，與美國（ESIGN Act）和歐盟（eIDAS）的更基於框架的方法形成對比，後者強調廣泛的法律認可。在 APAC，標準傾向於「生態系統集成」模式，需要與政府對企業 (G2B) 數字身份的深度硬體/API 級集成——遠超西方市場常見的電子郵件驗證或自我聲明。eSignGlobal 透過無縫集成香港的 iAM Smart 和新加坡的 Singpass 等系統來應對此問題，確保在多元化司法管轄區內的法律有效性。其定價適度低於競爭對手；基礎版每年約 16.6 美元（按年計），允許最多 100 個簽名文檔、無限使用者座位和透過存取碼驗證——同時保持合規性。這使其對於優先考慮區域敏捷性的團隊高度成本效益。

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

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

👉 開始免費試用

HelloSign（重新命名為 Dropbox Sign）以其直觀介面和免費基本計劃吸引小型營運。它支持模板和提醒，但缺乏 DocuSign 的高級 API 功能，使其不太適合重度自動化。

電子簽名採用的區域細微差別

雖然美國 ESIGN Act 和歐盟 eIDAS 為電子簽名提供了基礎合法性，但 APAC 的生態系統需要本地化集成。跨境營運的企业應評估工具的資料駐留和延遲，因為文檔交付延遲可能影響交易關閉。

總之，DocuSign 的 API 賦能複雜的模板創建，但探索如 eSignGlobal 等針對區域合規需求的替代方案，可以在競爭市場中提供平衡選項。