问题描述

使用C#DocuSign API SDK 4.5.2

我将3份文件放在同一个信封中发送以供签名。每个文档将使用相同的服务器模板(它只是使用锚标记将签名元素放置在文档上)。我可以发送信封，然后从DocuSign收到电子邮件，以查看/签署文档。

我遇到的问题是，当我去签名时，我必须对每个文档签名3次--总共9次--然后我才能单击Finish按钮。每个文档上只有一个地方可以签名，但我必须单击三次签名按钮才能接受它。如果我有两个收件人，他们每个人的情况都是一样的。如果我将代码更改为仅发送1个文档，则它工作正常，因此很明显信封请求中没有正确生成某些内容。

我还尝试为每个收件人分配不同的ID号，即使只有2个角色和2个不同的名称/电子邮件地址。

就在我调用API以实际发送文档之前，出于调试目的捕获了JSON：

{
  "compositeTemplates": [
    {
      "compositeTemplateId": "1",
      "document": {
        "documentBase64": "---Document 1 Bytes---",
        "documentId": "1",
        "fileExtension": "pdf",
        "name": "MultiDocument1"
      },
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": "client@gmail.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@gmail.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "2"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "99321CB1-A3E8-44A0-BDF4-D4F20069BC7B"
        }
      ]
    },
    {
      "compositeTemplateId": "2",
      "document": {
        "documentBase64": "---Document 2 Bytes---",
        "documentId": "2",
        "fileExtension": "pdf",
        "name": "MultiDocument2"
      },
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": "client@gmail.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@gmail.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "2"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "99321CB1-A3E8-44A0-BDF4-D4F20069BC7B"
        }
      ]
    },
    {
      "compositeTemplateId": "3",
      "document": {
        "documentBase64": "---Document 3 Bytes---",
        "documentId": "3",
        "fileExtension": "pdf",
        "name": "MultiDocument3"
      },
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": "client@gmail.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@gmail.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "2"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "99321CB1-A3E8-44A0-BDF4-D4F20069BC7B"
        }
      ]
    }
  ],
  "emailSubject": "Multiple Documents for Signature",
  "status": "Sent"
}

这是我正在使用的一个文档。另外两个是相似的--不同的文本，但使用相同的锚标记。

我还尝试用我在测试中成功使用的另一个文档替换Document 1--它完全不同，但仍然使用相同的锚标记。我得到了相同的结果--每个签名都必须签名3次。

有人看到我做错了什么吗？如果您需要更多信息，请让我知道。

谢谢， 兰迪

更新：按照Inbar和Larry的建议，我联系了DocuSign支持，并将"；锚定人员范围设置从"；信封"；更改为"；文档"；。不幸的是，这让事情变得更糟。我仍然需要多次单击签名元素才能签名，但只有第一个文档可以签名。其他文档没有附加任何签名元素。

更新#2：我想知道我使用模板的方式是否会令人困惑并导致这些问题。我可能应该解释得更清楚些。我正在使用的服务器模板有一个虚拟的Word文档，该文档只包含一组用于签名和日期的公共锚标记。我将其作为模板上传，并将签名和日期UI元素分配给锚标记。但是，当我从应用程序发送请求时，我使用的是我在运行时选择/生成的不同文档。该文档替换了模板中的虚拟Word文档，但具有相同的锚标记，因此所有签名和日期元素都会在实际文档中找到它们的位置。这在仅发送1个文档时非常有效，但我无法为多个文档工作。

更新#3：要求--我们正在向我们的网站(ASP.NET、WinForms)添加数字签名功能。我们已经有了一个页面，Advisor可以在其中打印出用于物理签名的文档，或者使用DocuSign启动数字签名流程。我们的所有文档都来自MS Report Server，因为它们需要包含我们数据库中的客户数据。我们目前不发送任何静态文档。在页面后面的代码中，我从报表服务器获取PDF字节，并将其(作为文档)添加到要发送到DocuSign的复合模板中。它还包含对Word文档(如下所示)的My Account中的服务器模板的引用，该文档包含要覆盖在报表服务器文档上的锚标记和签名元素(在更新#2中提到)。实际情况是，报表服务器文档替换了Word模板的文本(如表单背景)，并且因为我使用与锚标记相同的文本，所以Word模板上的签名元素在报表服务器文档上找到它们的匹配项，并移动到文档上它们的位置。我最后包括1个或多个客户的姓名/电子邮件地址，通常还有2个其他所需的签名者(顾问和经理)。然后发送给DocuSign(SDK接口)开始签名过程。使用单个文档，这很好地工作。我们正在准备何时我们将需要发送一个以上的文件给客户，我们希望在一个单一的请求。如果您需要更多信息，请让我知道。

推荐答案

DocuSign客服帮我联系了一位非常耐心和乐于助人的开发人员支持代表。我解释了我试图做的事情，他提出了一个很容易集成到我现有代码库中的解决方案。

要让它工作，您需要2块拼图。上面提到了第一项：您必须将帐户中的Anchor Population Scope值设置为&Quot；Document&Quot；。此操作必须由DocuSign客户服务代表完成，因为用户无法访问该设置。

第二项是导致所有签名标记都堆叠在第一个文档上的原因。在您的复合模板中，内部模板必须具有"；1"；序列号，而服务器模板必须使用"；2"；序列号。一旦这两个项目都就位，我就可以向单个信封中的多个签名者发送多个文档，每个文档都使用相同的服务器模板(以定义AutoPlace标记和角色)。

以下是适用于我的示例JSON：

  {
  "compositeTemplates": [
    {
      "compositeTemplateId": "1",
      "inlineTemplates": [
        {
          "documents": [
            {
              "documentBase64": "<PDF Bytes>",
              "documentId": "1",
              "fileExtension": "PDF",
              "name": "MultiDocument1"
            }
          ],
          "recipients": {
            "signers": [
              {
                "email": "client@email.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@email.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "1"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "2",
          "templateId": "1234xxxx-xxxx-xxxx-xxxx-xxxxxxxx5678"
        }
      ]
    },
    {
      "compositeTemplateId": "2",
      "inlineTemplates": [
        {
          "documents": [
            {
              "documentBase64": "<PDF Bytes>",
              "documentId": "2",
              "fileExtension": "PDF",
              "name": "MultiDocument2"
            }
          ],
          "recipients": {
            "signers": [
              {
                "email": "client@email.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@email.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "1"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "2",
          "templateId": "1234xxxx-xxxx-xxxx-xxxx-xxxxxxxx5678"
        }
      ]
    },
    {
      "compositeTemplateId": "3",
      "inlineTemplates": [
        {
          "documents": [
            {
              "documentBase64": "<PDF Bytes>",
              "documentId": "3",
              "fileExtension": "PDF",
              "name": "MultiDocument3"
            }
          ],
          "recipients": {
            "signers": [
              {
                "email": "client@email.com",
                "name": "Client Name",
                "recipientId": "1",
                "roleName": "Signer1"
              },
              {
                "email": "advisor@email.com",
                "name": "Advisor Name",
                "recipientId": "2",
                "roleName": "Advisor"
              }
            ]
          },
          "sequence": "1"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "2",
          "templateId": "1234xxxx-xxxx-xxxx-xxxx-xxxxxxxx5678"
        }
      ]
    }
  ],
  "emailSubject": "Multiple Documents for Signatures",
  "status": "Sent"
}

如果您有任何问题，请告诉我。感谢拉里·K和英巴尔·加齐特的助攻！

这篇关于DocuSign API：在同一信封中发送多个文档的签名问题的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持编程学习网！