DocuSign信封通知

Question

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

我已经读过获取信封状态的首选方法是通过一个事件。不幸的是，我没有找到这方面的例子。

我找到了一些关于它的文档HERE。

有没有人使用过DocuSign的这种事件/通知方式，这有助于我指出正确的方向？

Answer 1

例如，有很多关于DocuSign自己的Lithium论坛（将很快以只读方式制作）的例子。它们很容易设置，您只需要一个服务器监听权限端口打开的事件，您只需将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;

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

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