DocuSign使用REST将签名组设置为收件人

Question

我试图发送一个信封，接收者是使用REST的签名组。

下面是我发布的示例XML代码：

<?xml version="1.0" encoding="UTF-8"?>
<envelopeDefinition xmlns="http://www.docusign.com/restapi">
   <accountId>xxxxxx</accountId>
   <status>sent</status>
   <emailSubject>xxxxxxxxxxx</emailSubject>
   <templateId>xxxxxx-xxxx-xxxx-xxxxx-xxxxxxx</templateId>
   <templateRoles>
      <templateRole>
         <name>Test Signing Group</name>
         <roleName>Test Role Name</roleName>
      </templateRole>
      <templateRole>
         <name>Non Signing Group</name>
         <roleName>Standard Role</roleName>
         <email>test@example.com</email>
      </templateRole>
   </templateRoles>
</envelopeDefinition>

因此，对于模板角色#1，我尝试将test@example.com分配给Template，对于模板角色#2，我可以将标准角色分配给非签名组，电子邮件为test@example.com。因为我排除了模板角色#1的电子邮件，所以我得到了一条错误消息：“收件人的电子邮件地址无效。收件人Id如下。”

我想知道该如何分配字段，因为签名组可能需要多封电子邮件签名。

我想使用API将签名组设置为收件人的原因是，根据变量的不同，我将更改分配给模板角色#1的签名组，该角色在前面的外部进程中已经计算出来。

Answer 1

如果指定了signingGroupId，那么name/email@就不再是必需的了。您需要使用组的ID，而不是名称。您可以从/accounts/{accountId}/signing_groups端点查询signinGroupId。

对信封创建调用的示例更新：

  <templateRole>
     <signingGroupId>12345</signingGroupId>
     <roleName>Test Role Name</roleName>
  </templateRole>

文档参考re: signingGroupId：