c# - DocuSign 信封通知

Question

我已经使用 DocuSign 的 SOAP API 成功地将我公司的系统与 DocuSign 集成。我可以通过 SOAP 接口发送、检查状态和检索信封。

我读过获得信封状态的首选方法是通过事件。不幸的是，我没有找到这样的例子。

我在这里找到了一些关于它的文档。

有没有人使用过这种来自 DocuSign 的事件/通知方式来帮助我指明正确的方向？

Answer 1

例如，在 DocuSign 自己的 Lithium 论坛（很快将变为只读）上有一些 PHP 示例。它们很容易设置，您只需要一个服务器在权限端口打开的情况下监听事件，您只需将 eventNotification 元素添加到您的请求中。您已经参考了 SOAP api 指南，下面的示例 PHP 代码显示了如何实现该指南。还有一个可用于 REST API 的版本。

您可以从 GitHub 下载 DocuSign 的 SOAP SDK，并且有现成的示例 PHP 项目可供您开始修改和添加 eventNotifications。

// Notifications
$eventNoti = new EventNotification();
$eventNoti->URL = 'http://myurl.com/docusign/updateDocStatus'.$env_id.'/';
$eventNoti->LoggingEnabled = "TRUE";

// Important Stuff below
$envEvent = new EnvelopeEvent();
$envEvent->EnvelopeEventStatusCode = "Completed";  // <---------- Fires on "Completed" only
$envEvent->IncludeDocuments = "TRUE";
$eventNoti->EnvelopeEvents = array($envEvent); // <------------ Add multiple EnvelopeEvent's
$envInfo->EventNotification = $eventNoti;

此链接是引用上述代码的地方，以及可能有帮助的进一步讨论。

另一种选择是使用DocuSign Connect模块将事件推送到您的外部侦听器。DocuSign Connect 和 eventNotification 之间的主要区别在于 eventNotification 是每个信封，Connect 是帐户范围和/或用户范围。