DocuSign API — встроенные получатели

#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. Начните новый вопрос для этого с вашего образца запроса, его сложно расшифровать без всех данных. Также отметьте ответ Эргина как принятый, если это ответило на этот вопрос 🙂