Question

我们正在使用Power Form在信封中创建签名文档，以便我们的客户签署我们的合同。

我们的客户完成对文档的签名（响应）之后，我们可以从DocSign中获取任何回调事件并获取客户签名（完成）的文档（流或URL）吗？

我正尝试使用下面的示例代码下载文档，但是它只能从信封中获取模板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

如果对于使用Powerform创建的每个信封都有可使用的信封ID，则上述调用可以很好地检索签名的文档。

有多种方法可以从DocuSign for Powerform场景中获取EnvelopeId：

如果您使用的是Direct Powerform（无电子邮件验证），并且是一个
签名者场景，那么您需要在
中创建会话中登录页面 DS帐户，如Configure In-Session landing
pages中所述，配置返回/回调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是信封ID，现在您可以使用此信封ID来得到签名的文件
如果您将Direct PowerForm与多个签名者一起使用，或者使用电子邮件Powerform（已选中“需要电子邮件验证”复选框 Powerform配置），则需要在以下位置配置目标网址品牌解释 here 带有返回/回调网址，例如https://www.google.com，其中 www.google.com是您的回调应用程序URL，作为响应，DocuSign将还可以在查询参数中发送信封ID，现在您可以使用它了信封编号为得到签名的文件
最后一种方法，最好是使用DocuSign Connect，它就像一个Pub-Sub架构，您将在其中开发和托管一个 WebService，可以接受POST调用和XML输入。你呢将在DocuSign中配置相同的WebService，并且您还将在DocuSign中配置触发事件，通知DocuSign您的工作是什么您希望DocuSign推送XML通知时的有趣事件到您的WebService。一旦触发事件发生在您的信封上然后DocuSign将推送XML消息，其中包含信封ID和状态为信封，收到XML消息后，您可以调用/ documents 具有信封ID的API，用于下载签名文档。另外，如果您文件不是很大，那么您可以通过DocuSign发送给您签名 XML也采用Base64格式的文档，这是其中之一配置您的DocuSign Connect设置中的配置网络服务。

DocuSign API从Power Form获取响应（签名）文档

1 个答案: