DocuSign Api - 带有 eNotary 的模板

Question

我们正在使用 DocuSign eSignature Api 成功发送模板。我们现在正在尝试发送需要公证的文件，但收到此错误消息：

{
    "errorCode": "NOTARY_SIGNING_HOST_NOT_FOUND",
    "message": "The notary signing host is not found."
}

经过一番挖掘，我们从 DocuSign 找到了这篇文章，但没有提到带有 eNotary 的模板： https://www.docusign.com/blog/dsdev-common-api-tasks-using-enotary-programmatically

我们尝试按照文章大纲进行操作，但遇到了这个错误：

{
    "errorCode": "INVALID_REQUEST_PARAMETER",
    "message": "The request contained at least one invalid parameter. 'recipients' may not be specifed when 'templateId' is set. Use 'templateRoles'."
}

最后，当我们在 Create Envelope | 查看 API 文档时TemplateRoles 字段我们没有发现任何关于公证主机的信息： https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopes/create/

此对象指定模板收件人。模板中的每个 roleName 都必须有一个分配给它的收件人。该对象由以下元素组成：

• 电子邮件：收件人的电子邮件地址。
• 姓名：收件人姓名。
• roleName：与收件人关联的模板角色名。
• clientUserId：一个可选属性，指定接收者是嵌入的还是远程的。如果 clientUserId 不为 null，则嵌入收件人。请注意，如果使用了 clientUserId，并且帐户设置 signerMustHaveAccount 或 signerMustLoginToSign 为 true，则会在发送时生成错误。
• defaultRecipient：可选，设置为 true 时，此收件人为默认收件人，transformPdfFields 选项生成的任何选项卡都映射到此收件人。
• routingOrder：指定信封中收件人的路由顺序。
• accessCode：此可选元素指定收件人必须输入以验证身份的访问代码。最大长度：50 个字符。
• inPersonSignerName：可选。如果模板角色是亲自签名者，则这是签名者的法定全名。最大长度：100 个字符。
• emailNotification：这是一个可选的复杂元素，具有特定于角色的 emailSubject、emailBody 和语言。它遵循与收件人的 emailNotification 属性相同的格式。
• tabs：此属性允许指定选项卡值以匹配模板中的选项卡。

那么我们到底如何发送带有公证人的模板呢？

Answer 1

在 API 方面，Notary 以一种特殊的方式工作。 我建议您先熟悉一下普通信封的工作原理。 为此 - 请参阅我的 blog post 中的代码 sn-ps。

诀窍实际上是您有一个 InPersonSigner，即实际签署的人，然后是一个 NotaryHost，即公证人。一个嵌套在 JSON 中的另一个内部。 如果您使用我们的 SDK 之一 - 会更容易。

更新：当您使用从模板创建的信封时，有两种选择：

1. 原始模板具有 InPersonH​​ost 和 NotaryHost 作为角色。在这种情况下，您只需添加 templateRoles 并匹配 roleName。
2. 您在“草稿”模式下创建一个信封，然后再次调用 API 来添加这些收件人。