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 等替代品提供量身定制、成本效益高的选项，而不牺牲全球覆盖。根据您的量级、集成和地理位置进行评估，以实现最佳匹配。