DocuSign API：如何使用“复合模板”来合并多个 PDF？

导航 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 操作。