DocuSign eSignature REST API C＃客户端：同一模板角色可以在单个文档上执行多个签名步骤吗？

编程问答 2022-08-11

问题描述

版本

  • Docusign C＃客户端-DocuSign.eSign.dll v3.1.5

  • .NetFramework 4.7.1

我们的要求

我们需要实现一个签名工作流，其中相同的模板角色可以对同一文档执行多项操作。下面是一个简化的示例。

  • 单个模板（文档）
  • 分配了一个名为“客户”的角色
  • 第1步-客户必须签名
  • 第2步-其他人必须签名
  • 第3步-客户必须查看文档
  • 签名工作流程完成

下面是DocuSign eSignature管理控制台中的图表，其中“ CC”代表客户模板角色

DocuSign Signing Order Diagram For Template

某些示例代码

我们的应用程序使用C＃Docusign客户端（实质上是Http请求的包装，需要将其发送到Docusign API）告知DocuSign我们需要填充的模板（文档）的ID以及名称/电子邮件地址在签名工作流程中起作用的每个收件人的数量。

var envelope = new EnvelopeDeFinition
{
    AllowRecipientRecursion = "true",TemplateId = templateId,TemplateRoles = peopleWithRolesOnTheTemplate.Select(person => new TemplateRole
    {
        RoleName = person.Role,// e.g "Customer"
        Name = person.Name,Email = person.Email
        // etc etc
    }).ToList(),Status = "sent"
};

var envelopesApi = new EnvelopesApi(apiclient.Configuration);
var result = envelopesApi.CreateEnvelope(AccountId,envelope);

预期结果

  • 我们的应用程序已为“客户”模板角色指定了名称和电子邮件地址，并向DocuSign发送了创建信封的请求

  • 我们希望生成的DocuSign信封具有3个签名步骤，其中2个属于客户模板角色。

  • 我们希望属于客户角色的每一步都将使用我们在上面的代码段中指定的名称和电子邮件地址进行填充。

  • 我们希望“客户”角色将收到TWICE文档，一次签名，第二次查看文档，这是收件人在“签名”步骤2中进行了签名之后。

实际结果

  • 客户签名文档，第二个收件人签名文档，客户未发送文档进行查看（未执行步骤3）

  • 看一些DocuSign日志记录，信封中似乎只有两个签名步骤，而不是3。这几乎就像是因为两个签名步骤具有相同的角色名称，所以被合并到一个签名步骤中，沿着这些方向。

我的问题

  1. 有人知道上面的粗体语句是否正确吗？

  2. 是否可以使用此DocuSign C＃客户端创建一个信封，使SAME ROLE可以执行多个签名步骤？还是DocuSign中的每个签名步骤都必须属于一个单独的角色？

解决方法

您应该给客户两个角色名称：customerSigner和customerCC。

使用模板时，您将设置三个角色：

  • customerSigner
  • someoneElseSigner
  • customerCC

第一和第三角色的名称和电子邮件地址相同。

此外，DocuSign会自动（默认情况下）将完成的文档的副本发送给签名者，因此我不确定您是否甚至需要cc角色/步骤。

最后，你说的是

客户必须查看文档

为确保客户已在步骤3中看到文档，您可能希望使用经过认证的收货人。

c#c#docusignapi