0

将 createEnvelope 文档与复合模板一起使用 https://docs.docusign.com/esign/restapi/Envelopes/Envelopes/create/ https://developers.docusign.com/esign-rest-api/guides/features/templates

当我们尝试将此 API 用于多个模板时，我们会收到类似于以下内容的错误

{\r\n  \"errorCode\": \"CANNOT_EXCLUDE_DOCUMENT\",\r\n  \"message\": \"This document cannot be excluded for this recipient. Recipient: Enbmgr Enbmgr cannot be excluded from Document:TalentEmploymentAgreemt_0617AqVT.pdf\"\r\n}"}}

当模板的顺序发生变化时，它工作正常。这可能是什么原因？

帐户设置了文档可见性：发件人可以设置“必须签名才能查看，除非发件人”

按以下顺序发送时出错：

  1. Templateid- f09dc354-efd6-437e-9410-5270b181a1f1 角色：Emp、Mgr（启用登录顺序）

  2. Templateid- 8c919c05-ee1f-42c4-b521-861c5f2949b 角色：Emp

  3. Templateid- 6b57ea78-5923-4c54-b4c1-15c8d5313e71 角色：Emp、Mgr（已启用登录顺序）

按以下顺序发送成功：

  1. Templateid- 6b57ea78-5923-4c54-b4c1-15c8d5313e71 角色：Emp、Mgr（已启用登录顺序）

  2. Templateid- f09dc354-efd6-437e-9410-5270b181a1f1 角色：Emp、Mgr（启用登录顺序）

  3. Templateid- 8c919c05-ee1f-42c4-b521-861c5f2949b 角色：Emp

请求给出错误：

    {
      "emailSubject": "DocuSign API - Composite Templates",
      "emailBlurb": "Composite Templates Sample 1",
      "status": "sent",
      "compositeTemplates": [
        {
          "serverTemplates": [
            {
              "sequence": "1",
              "templateId": "f09dc354-efd6-437e-9410-5270b181a1f1"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "2",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {}
                  },
                  {
                    "email": "ranjesh+mgr@enboarder.com",
                    "name": "Enbmgr Enbmgr",
                    "roleName": "OM",
                    "recipientId": "2",
                    "tabs": {}
                  }
                ]
              }
            }
          ]
        },
        {
          "serverTemplates": [
            {
              "sequence": "3",
              "templateId": "8c919c05-ee1f-42c4-b521-861c5f2949bf"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "4",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {
                      "textTabs": [
                        {
                          "tabLabel": "\\*Market",
                          "value": " "
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        },
        {
          "serverTemplates": [
            {
              "sequence": "5",
              "templateId": "6b57ea78-5923-4c54-b4c1-15c8d5313e71"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "6",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {}
                  },
                  {
                    "email": "ranjesh+mgr@enboarder.com",
                    "name": "Enbmgr Enbmgr",
                    "roleName": "OM",
                    "recipientId": "2",
                    "tabs": {}
                  }
                ]
              }
            }
          ]
        }
      ]
    }

请求给予成功：

    {
      "emailSubject": "DocuSign API - Composite Templates",
      "emailBlurb": "Composite Templates Sample 1",
      "status": "sent",
      "compositeTemplates": [
        {
          "serverTemplates": [
            {
              "sequence": "1",
              "templateId": "6b57ea78-5923-4c54-b4c1-15c8d5313e71"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "2",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {}
                  },
                  {
                    "email": "ranjesh+mgr@enboarder.com",
                    "name": "Enbmgr Enbmgr",
                    "roleName": "OM",
                    "recipientId": "2",
                    "tabs": {}
                  }
                ]
              }
            }
          ]
        },
        {
          "serverTemplates": [
            {
              "sequence": "3",
              "templateId": "f09dc354-efd6-437e-9410-5270b181a1f1"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "4",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {}
                  },
                  {
                    "email": "ranjesh+mgr@enboarder.com",
                    "name": "Enbmgr Enbmgr",
                    "roleName": "OM",
                    "recipientId": "2",
                    "tabs": {}
                  }
                ]
              }
            }
          ]
        },
        {
          "serverTemplates": [
            {
              "sequence": "5",
              "templateId": "8c919c05-ee1f-42c4-b521-861c5f2949bf"
            }
          ],
          "inlineTemplates": [
            {
              "sequence": "6",
              "recipients": {
                "signers": [
                  {
                    "email": "ranjesh+emp@enboarder.com",
                    "name": "Enbemp Enbemp",
                    "roleName": "Talent",
                    "recipientId": "1",
                    "tabs": {
                      "textTabs": [
                        {
                          "tabLabel": "\\*Market",
                          "value": " "
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }

我发现最后一个模板看起来像这个 模板定义，其中包含签名者的排除文档

如何在 Docusign 的应用程序中设置签名者的排除文档？

4

1 回答 1

0

我怀疑角色和选项卡是如何分布的，但我看不到您的模板或发送的 API Json。

  1. 您可以按照此 DocuSign 支持文章https://support.docusign.com/guides/ndse-user-guide- api-request-logging

  2. 以下是您需要了解的关于序列号和物理顺序的部分内容 - 在复合模板中，物理顺序优先于每个复合模板节点的“索引/序列”。索引是内部粘合，但实际上不是内存模型中的行顺序。我怀疑您真的想重新启动“复合模板”的每个节点中的序列号，因为您说我有“三个”文档和每个文档的 x 个功能和角色，因为工作和不工作都折叠到以下结构复合节点结构，除了看起来你有（现在更正）一个额外的“[”数组分组：

（现在在更新的问题中更正） 在此处输入图像描述

"compositeTemplates": [{
"serverTemplates": [{
"inlineTemplates": [{
"document": ....

或匹配您的：

"compositeTemplates": [
    {},
    {},
    {}
    ]

这一切都假设您想要三个文档，如果您想要一个文档，那么您将服务器模板保存在复合节点内的同一个数组集合中，以应用于贡献文档，一个具有最低序列号的文档。请记住，在 JSON/REST 中，如果 JSON 格式不正确，也就是包含超出需要的内容，API 会忽略它作为“客户端注释”并获取它可以使用的内容。

  1. 序列越低：服务器、内联和文档之间的文档节点（不是文档）为 0 是“PDF/DOC 字节”的确定方式，序列号越高，在一个模板中赢得又名 doc vis 的功能，与另一个或通知天数。

  2. 我可能不得不等待日志，但是我认为 doc vis 错误问题的线索是 "tabLabel": "\*Market" 在两个示例之间从中间到最后。锚字符串是信封宽的，所以我怀疑它“符合”该角色的功能所需的标准，这可能是每个模板所需的。您可以将所有角色放在最后一个内联模板节点的最后一个复合模板节点中，它将将它们应用于所有以前的复合模板节点，其中它们不是由内联模板提供的。

因此，我即将发布一个最佳实践文档，解释这个关于信封中复杂模板组装的内容，但是，希望这对现在有所帮助。

请附上您的日志，以便我们查看真实示例并确定您所描述的结果中的哪些因素。

于 2018-04-25T15:34:19.303 回答