Блог

Мы интегрировали docusign в наше приложение и можем создавать конверты, добавлять подписчиков и создавать URL-адрес получателя для просмотра с помощью docusign API.

Следующий шаг — разрешить отправителю просмотреть конверт, и для этого мы используем create sender view API. Мы можем успешно выполнить запрос, и URL-адрес будет возвращен.

Наш API, который вызывает create sender view API :

 # the url to return to e.g. https://mywebsite.com
return_url = ReturnUrlRequest(return_url=data["return_url"])

# call the docusign API            
results = envelope_api.create_sender_view(
   session["ds_account_id"], 
   envelope_id, 
   return_url_request=return_url
)


# returns a json object with the url to the client 
return jsonify({"url": results.url}
 

Пример URL-адреса, возвращаемого из вызова API docusign: https://demo.docusign.net/Member/StartInSession.aspx?StartConsole=1amp;t=xxxxamp;DocuEnvelope=xxxxamp;send=1

URL-адрес передается интерфейсному веб-приложению (ReactJS) и используется для перенаправления пользователя на страницу просмотра отправителя. например window.location = response.data.url .

Вот тут-то и возникает проблема:

1. Вместо перенаправления пользователя на веб-сайт docusign пользователь немедленно перенаправляется обратно в приложение.
2. Когда я копирую URL-адрес и вручную вставляю его в новую вкладку браузера, он немедленно перенаправляет меня обратно в приложение, но при втором посещении URL-адреса на новой вкладке он работает.

Я что-то упускаю из виду?

Создать документы для просмотра отправителя: https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createsender /

РЕДАКТИРОВАТЬ: когда мы устанавливаем return_url в качестве пустой строки при создании URL-адреса для просмотра отправителя, пользователь не перенаправляется немедленно.

Можете ли вы проверить статус конвертов, к которым вы пытаетесь получить доступ?

Следует использовать режим Create Sender view, чтобы позволить отправителю редактировать черновики конвертов перед отправкой. В вашем сценарии вы упоминаете, что получатель уже просмотрел его, так что это может быть проблемой.

Если вы хотите разрешить отправителю доступ к редактированию конверта после его отправки, вам нужно будет использовать вызов API create correct view:

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createcorrect/

РЕДАКТИРОВАТЬ: если вы хотите, чтобы отправитель просматривал заполненный конверт, вы должны использовать API create receiver с информацией об отправителях

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createrecipient/

Тело вашего запроса должно иметь следующую структуру:

 {
    "authenticationMethod": "Email",
    "email": "sender@email.test",
    "returnUrl": "https://www.google.com/",
    "userName": "Sender",
 
}