Docusign 签名 url - 显示复合模板的文档 1

Question

使用 docusign rest api 我想创建一个包含 2 个文档的信封。然后，我将使用 Post Recipient view 将文档 1 显示给第一个收件人（在 iframe 中），并在签名后将同一个信封中的文档 2 显示给另一个收件人。

我创建了具有不同 tempalteRoles（不同名称，顺序 5 和 10）的模板。

根据我的理解，使用用户 ID 和我的文档签名帐户中的正确设置，我可以将文档 1 显示给收件人 1，然后将文档 2 显示给收件人 2。

当我尝试创建复合信封时，会显示整个文档。当我调用信封的收件人状态时，它只显示一个签名者。

我发现信封只有在 2 个模板角色具有相同的 clientUserId、用户名和电子邮件时才会创建，否则我会收到错误 "ONESIGNALLSIGN_NOT_SATISFIED"

这是我要通过

发送的信封

{
  "accountId": "ACCOUNT_ID",
  "emailSubject": "Email subject",
  "status": "sent",
  "templateId": "TEMPLATE_ID",
  "templateRoles": [
    {
      "roleName": "PDS Customer",
      "email": "pds@example.com",
      "name": "TestFirstName TestSurname",
      "clientUserId": "1",
      "tabs": {
        "textTabs": [
          {
            "tabLabel": "DocumentNumber",
            "value": "123456789",
            "locked": true,
            "documentId": 1,
            "pageNumber": 1
          }
          ...removed some
        ]
      }
    },
    {
      "roleName": "Customer",
      "email": "test@example.com",
      "name": "mrTestFirstName TestSurname",
      "clientUserId": "2",
      "tabs": {
        "textTabs": [
          {
            "tabLabel": "StorerEmail_LocalPart",
            "value": "test",
            "locked": true,
            "documentId": 2,
            "pageNumber": 1
          }
          ...removed some
        ]
      }
    }
  ],
  "compositeTemplates": [
    {
      "compositeTemplateId": 1,
      "serverTemplates": [
        {
          "sequence": 1,
          "templateId": "TEMPLATE_ID_2"
        }
      ]
    }
  ]
}

Answer 1

错误消息是由于启用了文档可见性。在那种情况下，每个签名者必须至少有一个选项卡。您的第二个签名者（嵌入式或非嵌入式）必须至少有一个标签。在这种情况下，它可能在第二个文档中。

你上面的 API 调用确实引用了第二个 documentId，所以你可能没问题。

我建议您不要将 "simple" 发送（在顶层使用 templateRoles）与复合模板混合使用。相反，将内联模板添加到包含所有收件人信息的 compositeTemplates 结构。由于混合这些，您可能会看到一些奇怪的行为。

最后，只有当收件人在该文档上有一个选项卡时，默认的文档可见性配置才会向收件人显示该文档。如果您的第二个签名者应该看到所有文档，那么您必须在每个文档上为他们添加一个选项卡或明确设置每个文档的可见性。

Docusign 签名 url - 显示复合模板的文档 1

Docusign signing url - Showing document 1 of a composite template

docusignapi

docusigncompositetmplts