DocuSign API: проблемы перенаправления с URL-адресами представления проверки подлинности конверта

У нас есть интеграция с DocuSign, которая позволяет нашим клиентам подписывать свои документы в DocuSign. Вот шаги, которым мы следуем:

  1. Мы создаем новый конверт документа, нажав кнопку Envelopes: create конечная точка.
  2. Используя идентификатор конверта из предыдущего шага, мы попали в EnvelopeViews : createConsole, чтобы получить URL-адрес перенаправления. Получаем URL, который выглядит так:

    https://demo.docusign.net/Member/StartInSession.aspx?StartConsole=1&t=[GUID]&DocuEnvelope=[ENVELOPE_ID]

  3. Мы перенаправляем нашего пользователя на URL-адрес перенаправления с предыдущего шага.

Ожидаемое поведение: URL перенаправления должен направлять нашего пользователя на черновик страницы конверта, т. е. /prepare/<ENVELOPE_ID> Наблюдаемое поведение: пользователь попадает на главную страницу DocuSign.


Мы смогли наблюдать проблему, когда пользователь не вошел в DocuSign и пытается перейти по URL-адресу перенаправления:

  • При входе в DocuSign (действительный сеанс браузера) URL-адрес перенаправления успешно попадает в URL-адрес подготовки конверта.
  • При выходе из системы URL-адрес перенаправления перенаправляет пользователя на страницу входа, а после входа в систему перенаправляет на домашнюю страницу.

пс. В прошлом мы без проблем использовали тот же рабочий процесс. Этот вопрос был доведен до нашего сведения несколько дней назад. (15 февраля 2020 г.)

pps. Эта проблема затрагивает всех пользователей.


person Arian Khosravi    schedule 20.02.2020    source источник


Ответы (2)


В DocuSign было несколько сообщений об этом. Проблема отслеживается по номеру билета EC-2126 - я бы порекомендовал обратиться к вашей команде по работе с аккаунтом, чтобы добавить вашу информацию в этот билет. Если у вас есть учетная запись в Интернете, вы можете отправить электронное письмо по адресу [email protected], указав номер проблемы и идентификатор вашей учетной записи, чтобы добавить ее.

В настоящее время рекомендуется вместо этого использовать вызов CreateSenderView: https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeViews/createSender

person Drew    schedule 20.02.2020
comment
Спасибо за быстрый ответ Дрю! попробует и вернется к вам. - person Arian Khosravi; 21.02.2020
comment
Дрю, эта конечная точка генерирует URL-адрес перенаправления, который заканчивается на /prepare/ENVELOPD_ID/add_notes, что намного лучше, чем переход на домашнюю страницу. Вы знаете, есть ли способ приземлиться на /prepare/ENVELOPE_ID? - person Arian Khosravi; 24.02.2020
comment
В документации указано, что вы можете change the query parameter from send=1 to send=0 to start with the recipients/documents view. - это то, что вы ищете? - person Drew; 24.02.2020
comment
Да, это тот, не знаю, как я это пропустил: facepalm: Еще раз спасибо, Дрю! - person Arian Khosravi; 24.02.2020

Ваш шаг 2 неверен ...

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

Используйте EnvelopeViews :: createSender.

Кроме того, что вы хотите, чтобы произошло во время просмотра отправки? Какой у вас вариант использования? (Пожалуйста, обновите / отредактируйте свой вопрос с добавленной информацией.)

Или встроенное представление подписи? - Церемония подписания?

Используйте EnvelopeViews :: createRecipient.

person Larry K    schedule 20.02.2020