可选的收件人角色模板 docusign

Question

我通过 UI 创建了一个模板，并使用它通过其余 API 创建了信封。到目前为止一切顺利。

在模板中，创建了 4 个角色。但是其中一个在创建信封时应该是可选的，即在某些信封中只有 3 个签名者。

问题是，如果我只发送 3 个模板角色的信息，docusign returns 错误 INVALID_EMAIL_ADDRESS_FOR_RECIPIENT，对于未被通知的角色。

我的问题是是否有办法在模板中创建“可选”角色。这只会在一些信封中被告知。

编辑：

我正在创建状态为“已创建”的信封。我这样做是因为我们必须在发送前将一些文件添加到信封中。之后我更新信封，将状态更改为“已发送”。

错误发生在我将状态更新为“已发送”时。如果我创建的信封已经具有“已发送”状态，则不会发生错误。

这是我的代码：

 $result = Docusign::createEnvelope(array(
        'templateId' => $saleContract->obra->template_id,
        'emailSubject' => 'Contrato de Compra - ' . $saleContract->obra->nome_fantasia,
        'status' => 'created',
        'templateRoles' => $this->getRoles($saleContract, $tabs),
    ));

   $this->addDocuments($saleContract, $result['envelopeId']);

    //HERE IS WHERE THE ERROR HAPPENS
    Docusign::updateEnvelope($result['envelopeId'], ['status' => 'sent']);

Answer 1

默认情况下，模板角色是可选的。这意味着您可以成功地执行以下操作：

创建一个包含最大收件人数量的模板（所有收件人 fields/tabs）。
每次您通过 API 创建信封时，仅在 "Create Envelope" API 请求中包含所需收件人（角色）的收件人信息。

您在 POST /envelopes 时未指定信息的任何收件人角色将不包括在内。如果您想在草稿中创建信封，进行修改，然后发送，请将 "merge roles on draft" qp 设置为 true。

merge_roles_on_draft    string  
When set to true, template roles will be merged, and empty recipients will be removed. This parameter applies when you create a draft envelope with multiple templates. (To create a draft envelope, the status field is set to created.)

如果您仍然遇到问题，请仔细检查您是否没有使用名称或电子邮件值预先填充您的模板角色。这将混淆合并 ^

可选的收件人角色模板 docusign

Optional recipient role template docusign

laravel

docusignapi