Docusign（PHP SDK）信封创建：RECIPIENTS_NOT_PROVIDED

Question

我正在尝试使用 PHP sdk 电子签名客户端从模板创建 Docusign 信封：

$apiClient = new ApiClient($config);

// Create an Envelope from a template
$templateId = env('TEMPLATE_ID');
$accountId = env('API_ACCOUNT_ID');
$envelopeApi = new EnvelopesApi($apiClient);
$templateRole = new TemplateRole([
    'email' => '[email protected]',  // recipient's email
    'name' => 'John Doe',      // recipient's name
    'roleName' => 'User',      // The role name as defined in the template
]);

$envelopeDefinition = new EnvelopeDefinition([
    'status' => 'sent',
    'templateId' => $templateId,
    'templateRoles' => [$templateRole]
]);
$envelopeSummary = $envelopeApi->createEnvelope($accountId, $envelopeDefinition);

产生：请求服务器时出错，收到不成功的 HTTP 代码 [400]，响应为：RECIPIENTS_NOT_PROVIDED - 在请求中找不到收件人

从日志中我可以看到它使用端点

POST /restapi/v2.1/accounts/{accountId}/envelopes

并且似乎包含根据文档的所有必要参数。这些参数似乎也与其他语言/sdks 中预期的一致。

我期望 $envelopeSummary（成功调用时）包含 EnvelopeId、status、statusDateTime 和 uri，然后我将使用它们来创建嵌入式签名仪式。

我已验证模板上的角色名称已设置为“用户”。

Answer 1

我看不到您的模板，但您的模板很可能具有多个收件人（角色），或者模板具有的一个角色不称为 “用户”。 仔细检查您的 templateId， 确保它来自开发人员环境并且位于您的帐户中，并且具有您期望的角色/收件人。