Docusignapi 将模板与文档混合并匹配

我有以下要求：

我的五个文档是从我们的系统动态生成的。第六份文件是附录。它只是一个静态pdf文件。那个附录有55页长

到目前为止，我一直在用五个文档创建信封，然后从服务器上的共享文件夹中提取附录，然后将其发送到docusign。附录占用了大约一半的上传时间

如果我在Docusign上有一个只包含附录的模板，然后我调用它并添加我的五个文档，那么效率会更高。我关注的是：

• 是否支持将模板与独立文档混合和匹配
• 根据我们的业务规则，收件人数量和签名标记会动态变化。模板需要在模板上预定义角色和标记。有没有办法向使用模板的信封中注入更多的收件人和标记

在创建信封API请求中使用“复合模板”结构将允许您使用来自DocuSign模板的文档和运行时通过API请求指定的文档的组合来创建信封，并使您能够相当动态地控制收件人。有关在创建信封API请求中使用复合模板的更多信息，请在API指南（REST或SOAP）中搜索“复合”

在创建信封请求中使用复合模板时，请求中的每个复合模板对象必须提供完整信封所需的信息（即，至少1个收件人和1个文档…或定义文档和/或收件人的服务器模板）。然后DocuSign基本上将请求中所有复合模板对象中的所有收件人和文档信息组合在一起，形成信封。在下面的示例JSON请求中，生成的信封包含：

• 3个收件人（通过API请求动态填充：1-Abby、2-Bob、3-Charlie）
• 3个文档（第一个通过API请求指定，第二个通过API请求指定，第三个通过DocuSign模板指定）

职位

使用复合模板有点棘手（而且没有很好的文档记录），因此，可能需要一些尝试和错误，才能让事情完全按照您的要求运行——但希望这个示例能够说明如何使用复合模板从DocuSign模板和通过API请求动态指定的文档的组合中创建信封。

使用“复合模板”创建信封API请求中的结构将允许您使用来自DocuSign模板的文档和运行时通过API请求指定的文档的组合来创建信封，并使您能够相当动态地控制收件人。有关在创建信封API请求中使用复合模板的更多信息，请在API指南（REST或SOAP）中搜索“复合”

在创建信封请求中使用复合模板时，请求中的每个复合模板对象必须提供完整信封所需的信息（即，至少1个收件人和1个文档…或定义文档和/或收件人的服务器模板）。然后DocuSign基本上将请求中所有复合模板对象中的所有收件人和文档信息组合在一起，形成信封。在下面的示例JSON请求中，生成的信封包含：

• 3个收件人（通过API请求动态填充：1-Abby、2-Bob、3-Charlie）
• 3个文档（第一个通过API请求指定，第二个通过API请求指定，第三个通过DocuSign模板指定）

职位

使用复合模板有点棘手（而且没有很好的文档记录），因此，可能需要一些尝试和错误，才能让事情完全按照您的要求运行——但希望这个示例能够说明如何使用复合模板从DocuSign模板和通过API请求动态指定的文档的组合中创建信封。

使用“复合模板”创建信封API请求中的结构将允许您使用来自DocuSign模板的文档和运行时通过API请求指定的文档的组合来创建信封，并使您能够相当动态地控制收件人。有关在创建信封API请求中使用复合模板的更多信息，请在API指南（REST或SOAP）中搜索“复合”

在创建信封请求中使用复合模板时，请求中的每个复合模板对象必须提供完整信封所需的信息（即，至少1个收件人和1个文档…或定义文档和/或收件人的服务器模板）。然后DocuSign基本上将请求中所有复合模板对象中的所有收件人和文档信息组合在一起，形成信封。在下面的示例JSON请求中，生成的信封包含：

• 3个收件人（通过API请求动态填充：1-Abby、2-Bob、3-Charlie）
• 3个文档（第一个通过API请求指定，第二个通过API请求指定，第三个通过DocuSign模板指定）

职位

使用复合模板有点棘手（而且没有很好的文档记录），因此，可能需要一些尝试和错误，才能让事情完全按照您的要求运行——但希望这个示例能够说明如何使用复合模板从DocuSign模板和通过API请求动态指定的文档的组合中创建信封。

使用“复合模板”创建信封API请求中的结构将允许您使用DocuSign模板中的文档组合创建信封

X-DocuSign-Authentication: {"Username":"YOUR_USER_NAME","Password":"YOUR_PASSWORD","IntegratorKey":"YOUR_INTEGRATOR_KEY"}
Content-Type: multipart/form-data; boundary=MY_BOUNDARY
Accept: application/json

--MY_BOUNDARY
Content-Type: application/json
Content-Disposition: form-data

{
"status" : "sent",
"emailSubject" : "Test Envelope",
"compositeTemplates": [
{
    "inlineTemplates": [
    {
        "sequence" : 1,
        "recipients": {
            "signers" : [{
                "email": "abbysEmailAddr@outlook.com",
                "name": "Abby Abbott",
                "recipientId": "1"
            },                                    {
                "email": "bobsEmailAddr@outlook.com",
                "name": "Bob Burns",
                "recipientId": "2",
                "routingOrder":"2"
            },
            {
                "email": "charliesEmailAddr@outlook.com",
                "name": "Charlie Carlson",
                "recipientId": "3",
                "routingOrder":"3"
            }]
        }
    }],
    "document": {
        "documentId": 1,
        "name": "Customer Agreement",
        "fileExtension": "pdf"
    }
},
{
    "inlineTemplates": [
    {
        "sequence" : 2,
        "recipients": {
            "signers" : [{
                "email": "abbysEmailAddr@outlook.com",
                "name": "Abby Abbott",
                "recipientId": "1"
            }]
        }
    }],
    "document": {
        "documentId": 2,
        "name": "Test File",
        "fileExtension": "pdf"
    }
},
{
    "serverTemplates": [
    {
        "sequence" : 1,
        "templateId": "YOUR_TEMPLATE_ID"
    }],
    "inlineTemplates": [
    {
        "sequence" : 2,
        "recipients": {
            "signers" : [{
                "email": "abbysEmailAddr@outlook.com",
                "name": "Abby Abbott",
                "recipientId": "1",
                "roleName": "Customer",
                "routingOrder":"1"
            }
            ]
        }
    }]
}
]}

--MY_BOUNDARY
Content-Type: application/pdf
Content-Disposition: file; filename="CustomerAgreement.pdf"; documentid="1"

**pdf bytes removed for brevity**
--MY_BOUNDARY
Content-Type: application/pdf
Content-Disposition: file; filename="TestFile.pdf"; documentid="2"

**pdf bytes removed for brevity**
--MY_BOUNDARY--