Блог

Я хотел бы создавать конверты для встроенных / зависимых получателей, используя вызовы API на основе SOAP, и генерировать токен, с помощью которого получатель может подписать конверт сразу после его создания. Я следил за вашей документацией, но не могу создать токены для встроенных подписчиков. Я могу создать конверт, но при создании токенов я получаю сообщение об ошибке «Неверные учетные данные подписи».

Согласно вашей документации, при создании конверта с невольным получателем мне нужно передать clientuserid для получателя. Мне нужно каждый раз использовать один и тот же clientuserid для одного и того же получателя. Похоже, я, возможно, раньше создавал конверт с невольным получателем, но я не использую правильную комбинацию..Имя получателя, адрес электронной почты и clientuserid каждый раз, когда я создаю конверт с зависимыми получателями.

1) Есть ли способ переназначить clientuserid получателю?

2) Есть ли способ получить clientuserid для получателя?

3) Из учетной записи DocuSign, как мы можем проверить, был ли создан конверт с зависимыми получателями?

4) Должны ли мы включать какие-либо настройки в нашей учетной записи DocuSign для создания конвертов с зависимыми получателями?

1) Возможно, вы сможете использовать вызов исправления получателя для обновления clientUserId для данного получателя, но если это не сработает, вы всегда можете удалить получателя из конверта, а затем повторно добавить в качестве встроенного получателя.

2) Чтобы получить clientUserId значение и другую информацию для ваших получателей, вам необходимо выполнить следующий вызов API:

Получить статус получателя конверта

URI:

 /accounts/{accountId}/envelopes/{envelopeId}/recipients
 

Метод:

 GET
 

Пример ответа:

 {
  "recipientCount":"String content",
  "signers":[{
    "deliveredDateTime": "String content",
    "recipientAuthenticationStatus":{
      "(authentication status result)":
        "eventTimestamp":"String content"
        "status":"String content"
      }
    },
    "recipientId": "String content",
    "clientUserId": "String content",    
    "requireIdLookup": "String content",
    "roleName":"String content",
    "routingOrder": "String content",
    "signedDateTime": "String content",
    "status": "String content",
    "email": "String content",
    "name": "String content"  }]
  }]
}
 

3) Я не уверен, что вы можете проверить через консоль DocuSign, описанный выше вызов API укажет, является ли данный получатель зависимым или нет. Если у clientUserId них определено значение, они встроены — в противном случае они являются удаленным подписывающим лицом.

4) Да, это функция, которую при интеграции с API необходимо будет включить в свой план учетной записи. Для получения дополнительной информации обратитесь к своему менеджеру учетной записи DocuSign.