DocuSign信封通知

Question

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

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

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

是否有人使用过DocuSign的这种事件/通知方式，可以帮助我指出正确的方向？

Answer 1

例如，在使用PHP的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;

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

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