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

时间:2016-01-19 23:31:48

标签: docusignapi

我正在尝试使用REST API发送信封,收件人是签名组。

以下是我发布的示例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,我尝试将测试签名组分配给测试角色名称和模板角色#2我可以将标准角色分配给非签名组,电子邮件为test@example.com。因为我排除了模板角色#1的电子邮件,所以收到错误消息“收件人的电子邮件地址无效。收件人ID跟随。”我想知道如何分配字段,因为签名组可能会有多封电子邮件可能签名。

我想使用API​​将签名组设置为收件人的原因是因为根据变量,我将更改将签名组分配给模板角色#1的内容,这是在早期的外部流程中计算出来的。

1 个答案:

答案 0 :(得分:3)

如果指定了signedGroupId,则不需要name / email @。您将需要使用组的ID而不是名称。您可以从/ accounts / {accountId} / signing_groups端点查询signinGroupId。

信封创建调用的示例更新:

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

Documentation引用re:signingGroupId: