#docusignapi
#docusignapi
Вопрос:
Я хотел бы создавать конверты для встроенных / зависимых получателей, используя вызовы API на основе SOAP, и генерировать токен, с помощью которого получатель может подписать конверт сразу после его создания. Я следил за вашей документацией, но не могу создать токены для встроенных подписчиков. Я могу создать конверт, но при создании токенов я получаю сообщение об ошибке «Неверные учетные данные подписи».
Согласно вашей документации, при создании конверта с невольным получателем мне нужно передать clientuserid для получателя. Мне нужно каждый раз использовать один и тот же clientuserid для одного и того же получателя. Похоже, я, возможно, раньше создавал конверт с невольным получателем, но я не использую правильную комбинацию..Имя получателя, адрес электронной почты и clientuserid каждый раз, когда я создаю конверт с зависимыми получателями.
1) Есть ли способ переназначить clientuserid получателю?
2) Есть ли способ получить clientuserid для получателя?
3) Из учетной записи DocuSign, как мы можем проверить, был ли создан конверт с зависимыми получателями?
4) Должны ли мы включать какие-либо настройки в нашей учетной записи DocuSign для создания конвертов с зависимыми получателями?
Ответ №1:
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.
Комментарии:
1. Спасибо за ваш подробный ответ. Нужно ли мне использовать один и тот же clientuserid для одного и того же получателя каждый раз, когда я добавляю этого получателя в качестве основного получателя? Должна ли быть включена моя демо-учетная запись DocuSign для использования неуправляемых получателей?
2. @user2858740 На вашем демо-аккаунте включен «режим всех функций», поэтому он уже настроен для этого. Использование одного и того же clientUserId позволит подписывающему лицу не вводить новую подпись каждый раз, когда они подписывают. Так что это зависит от рабочего процесса. Большинство интеграций, которые я вижу, имеют рандомизированный clientUserId.
3. Спасибо за ваш отзыв. При создании конверта в моей демо-учетной записи DocuSign я получаю сообщение об ошибке «Неверные учетные данные подписи». Я могу создать конверт с удаленными получателями нормально. Как мне исправить эту ошибку?
4. Начните новый вопрос для этого с вашего образца запроса, его сложно расшифровать без всех данных. Также отметьте ответ Эргина как принятый, если это ответило на этот вопрос 🙂