Множественные личные подписи в одном iframe

Question

Я пытаюсь понять, возможно ли, чтобы несколько человек подписывали документ в пределах одного iFrame или если новый токен должен быть сгенерирован (и новый iFrame создан) для каждого человека, который хочет знак.

В настоящее время в моем приложении я использую ID шаблона для создания нового конверта. Шаблон имеет 3 роли: Агент, Клиент1 и Клиент 2.

Затем я запрашиваю токен для конверта, чтобы его можно было просмотреть в iFrame. Появится экран, в котором говорится: «Крис, пожалуйста, дайте агенту управление клавиатурой и мышью», а затем этот человек заполнит документ ... После этого человек iframe перейдет в returnUrl.

Я ожидал, что после того, как агент закончит, он сказал бы: «Крис, пожалуйста, дайте Client1 управление клавиатурой и мышью» - но это не так.

Есть ли способ получить все роли в одном потоке без восстановления токена?

Answer 1

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

При использовании DocuSign в Embedding функциональность/API, вы, в основном, рассказывающие систему DocuSign, что вместо платформы, заботясь обо всем (т.е. генерации каждого подписания URL, аутентификации пользователя, уведомления по электронной почте, маршрутизации к следующему получателю, и т. д.), что ваше приложение будет управлять всем этим.

Кроме того, всякий раз, когда вы создаете токен подписывания, срок действия токена истекает через 5 минут, и они также истекают после однократного использования (вам нужно сгенерировать новый, если они закрывают окно, отказываются подписываться и т. Д.).

Таким образом, все это означает, что система будет автоматически маршрутизироваться к следующему получателю в порядке маршрутизации, если у этого следующего получателя нет установленного clientUserId (т. Е. Они не подписываются с использованием вложения). Если все получатели обращаются к конверту через Embedding, вам нужно будет создать новый URL-адрес подписи для каждого получателя.

Некоторые дополнительные ресурсы:

• Embedding API - aka CreateRecipientView
• Corresponding API in the API Explorer Tool

Answer 2

Некоторые комментарии в дополнение к ответу Ergin в:

Старайтесь не использовать IFrame. Особенно, если приложение можно использовать на планшете или мобильном телефоне. Почему: для окна DocuSign действительно нужен весь экран, чтобы обеспечить подписчику качество подписывания.

В вашем случае использования ваше приложение может иметь экран, который включает в себя кнопку «Я Джордж Смит, Клиент 1. Я готов подписать». И важно, чтобы ваши агенты были обучены тому, что Джордж Смит всегда нажимает кнопку. (Никогда агент.)

Это дает вам более сильный аргумент в пользу того, что именно Джордж Смит подписал.

Когда кнопка нажата, ваше приложение будет извлекать URL-адрес получателя из DocuSign и перенаправлять на него.

Когда DocuSign перенаправляет обратно в приложение после подписания, ваше приложение может показать экран «Сьюзен Смит, клиент 2 готов подписать» (если Джордж действительно подписан. См параметр event запроса. Docs.)

Аутентификация

Важнейшей проблемой при использовании встроенного подписи является аутентификация. Ваше приложение отвечает за гарантию подлинности подписывающего лица (ов). Вам нужно тщательно понять, как вы это сделаете.

В случае с агентом и клиентами лично агент будет проверять правительственный идентификатор? Если это так, вы можете захотеть, чтобы агент, как часть процесса подписания, подтвердил, что они проверили идентификатор правительства клиентов.

Из-за проблемы с аттестацией часто бывает важно, чтобы подпись агента была последней. Таким образом, аттестация может быть чем-то вроде «Я подтверждаю, что я проверил идентификацию правительства подписантов Джорджа Смита и Сьюзан Смит». (Спросите своего адвоката точную формулировку.)

Вы можете использовать "Initial Here" tab type рядом с аттестацией.