DocuSign с использованием REST API для установки группы подписи как получателя

Question

Я пытаюсь отправить конверт с получателем, являющимся Подписной группой, используя API REST.

Вот пример кода XML, который я POST:

<?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> 

Так шаблон Role # 1 Я пытаюсь назначить тест Подписывая группу для тестирования Имя роли и для шаблона Роль # 2 Я могу назначить Стандартная роль для группы без подписания, по электронной почте test@example.com. Поскольку я исключил электронное письмо для роли шаблона №1, я получаю сообщение об ошибке «Недопустимый адрес электронной почты для получателя. Идентификатор получателя». Мне интересно, как я могу назначить поля, потому что группа подписи для нескольких писем, возможно, подпишет.

Причина, по которой я хочу использовать API для установки группы подписи в качестве получателя, заключается в том, что в зависимости от переменных я изменю, какая группа подписи назначена роли шаблона №1, которая вычисляется в предыдущем внешнем процессе.

Answer 1

Если вы укажете подписьGroupId, тогда имя/email @ не станет обязательным. Вам нужно будет использовать идентификатор группы, а не имя. Вы можете запросить signinGroupId из конечной точки/accounts/{accountId}/signature_groups.

обновление Sample конверт вызов создания:

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

Documentation ссылка Re: signingGroupId: