如何获取DocuSign信封取消原因：解析审计日志

<?php

require_once(__DIR__ . '/vendor/autoload.php'); // 假设您已通过Composer安装DocuSign SDK

use DocuSign\eSign\ApiClient;
use DocuSign\eSign\Configuration;
use DocuSign\eSign\Api\EnvelopesApi;

class DocuSignEnvelopeService
{
    private $apiClient;
    private $accountId;
    private $envelopeId;
    private $accessToken;

    public function __construct($accessToken, $accountId, $envelopeId, $baseUrl)
    {
        $this->accessToken = $accessToken;
        $this->accountId = $accountId;
        $this->envelopeId = $envelopeId;

        $config = new Configuration();
        $config->setHost($baseUrl);
        $config->addDefaultHeader('Authorization', 'Bearer ' . $this->accessToken);
        $this->apiClient = new ApiClient($config);
    }

    /**
     * 获取信封的审计事件，并尝试解析取消原因
     *
     * @return string|null 返回取消原因，如果未找到则返回null
     */
    public function getEnvelopeCancellationReason()
    {
        try {
            $envelopeApi = new EnvelopesApi($this->apiClient);

            // 调用API获取信封的审计事件
            // 注意：具体方法名和参数可能因SDK版本而异，请参考DocuSign官方SDK文档
            $auditEvents = $envelopeApi->getEnvelopeAuditEvents(
                $this->accountId,
                $this->envelopeId
            );

            $cancellationReason = null;

            if ($auditEvents && isset($auditEvents->auditEvents)) {
                foreach ($auditEvents->auditEvents as $event) {
                    // 寻找描述中包含“Envelope Voided”或“Envelope Cancelled”的事件
                    // 具体的描述文本可能因DocuSign系统语言或事件类型而异
                    if (isset($event->description) && strpos($event->description, 'Envelope Voided') !== false) {
                        // 取消原因通常包含在eventData属性中，它是一个JSON字符串
                        if (isset($event->eventData)) {
                            $eventData = json_decode($event->eventData, true);
                            if (isset($eventData['voidReason'])) {
                                $cancellationReason = $eventData['voidReason'];
                                break; // 找到原因后即可退出循环
                            }
                        }
                    }
                }
            }
            return $cancellationReason;

        } catch (\DocuSign\eSign\ApiException $e) {
            // 处理API调用异常
            echo "DocuSign API 错误: " . $e->getMessage() . "\n";
            return null;
        } catch (\Exception $e) {
            // 处理其他异常
            echo "发生错误: " . $e->getMessage() . "\n";
            return null;
        }
    }
}

// 示例用法
// $accessToken = env('DOCUSIGN_ACCESS_TOKEN');
// $accountId = env('DOCUSIGN_ACCOUNT_ID');
// $envelopeId = 'YOUR_ENVELOPE_ID'; // 替换为实际的信封ID
// $baseUrl = env('DOCUSIGN_BASE_URL'); // 例如：'https://demo.docusign.net/restapi'

// $service = new DocuSignEnvelopeService($accessToken, $accountId, $envelopeId, $baseUrl);
// $reason = $service->getEnvelopeCancellationReason();

// if ($reason) {
//     echo "信封取消原因: " . $reason . "\n";
// } else {
//     echo "未找到信封取消原因，或信封未被取消。\n";
// }

?>