DocuSign信封通知

Question

我已經使用DocuSign的SOAP API將我公司的系統與DocuSign成功集成。我可以發送，檢查狀態並通過SOAP接口檢索信封。

我讀過，獲得信封狀態的首選方法是通過一個事件。不幸的是，我沒有找到一個這樣的例子運氣。

我發現了一些關於它的文檔HERE。

有沒有人使用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; 

This link是上述代碼引用的地方，以及可能有所幫助的進一步討論。

另一種選擇是使用DocuSign Connect模塊將事件推送到外部偵聽器。 DocuSign Connect和eventNotification之間的主要區別在於eventNotification是每個信封，Connect是帳戶範圍和/或用戶範圍。