DocuSign API для получения ответных (подписанных) документов из Power Form

Question

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

После того, как наш клиент завершил подписание (ответ) документа, можем ли мы получить какое-либо событие обратного вызова и получить подписанный (завершенный) документ клиента (либо Stream, либо URL) из docSign?

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

EnvelopesApi envelopesApi = new EnvelopesApi(apiClient.Configuration);

var docStream = envelopesApi.GetDocument(accountId, envelopeId, "combined");

using (var stream = File.Create(@"c:\temp\docu38.pdf"))
      {
           docStream.CopyTo(stream);
      }

Любая помощь будет оценена. Спасибо: -)

Answer 1

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

Существуют различные способы вернуть EnvelopeIds из сценария DocuSign для Powerform:

• Если вы используете Direct Powerform (без проверки электронной почты) и один
  Сценарий подписи, то вам нужно создать целевую страницу в сеансе в
  Учетная запись DS, как описано в Настройка сеанса в сеансе
  страниц , настроить URL возврата / обратного вызова, например https://www.google.com?,, где www.google.com - это URL-адрес вашего приложения обратного вызова, и когда произойдет обратный вызов Вы увидите некоторые параметры запроса, как показано ниже:

  https://www.google.com/?env=b807a0fc-fc80-445f-9740-38e0e5f0200c&pf=c4b09cfb-8264-4fe7-a35d-554294f99445&r=50dd1f38-4242-4d47-8ddb-f73c03db929e

  где env - это envelopeId, и теперь вы можете использовать этот envelopeId для получить подписанный документ

• Если вы используете Direct PowerForm с несколькими подписавшими или если вы с помощью Email Powerform (установлен флажок Требуется проверка электронной почты в Конфигурация Powerform), то вам нужно настроить целевые URL в Брендинг как объяснено здесь с URL возврата / обратного вызова, например https://www.google.com,, где www.google.com - это URL вашего обратного вызова, а в ответ DocuSign также отправьте envelopeId в параметре запроса, и теперь вы можете использовать это envelopeId to получить подписанный документ

• Последний и самый рекомендуемый способ - использовать DocuSign Подключение , это как архитектура Pub-Sub, где вы будете разрабатывать и размещать WebService, который может принимать вызов POST и ввод XML. а вы настроит тот же WebService в DocuSign, а также вы настройте триггерные события в DocuSign, сообщив DocuSign, что у вас интересные события, когда вы хотите, чтобы DocuSign отправлял уведомление XML на ваш веб-сервис. Как только события триггера произойдут в вашем конверте то DocuSign отправит сообщение XML с envelopeId и статусом конверт, после получения сообщения XML вы можете позвонить / документы API с envelopeId для загрузки подписанного документа. Также если ваш документы не большие, то вы можете DocuSign отправить вам подписанный Документ в формате XML как Base64, это один из конфигурации в настройках DocuSign Connect при настройке Webservice.