如何获取由 DocuSign 中的代理/中介分配的签名者的嵌入式签名 URL?



在DocuSign中使用代理/中介分配签名者时,我们为签名者设置了使用嵌入式签名功能的clientUserId。但是DocuSign会自动将电子邮件发送给分配的签名者,我们无法通过APIPOST {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}/views/recipient获取签名URL。

如此线程所示: https://stackoverflow.com/a/63810135/13191875 .这是由于当代理/中介更改签名者的电子邮件/姓名信息时,clientUserId被删除。它建议在更改签名者的电子邮件/姓名信息后添加workflow以暂停流程,然后将clientUserId添加到签名者,然后恢复工作流。

我尝试使用请求正文:

{
"recipients": {
"intermediaries": [
{
"clientUserId": "1",
"email": "aaa@example.com.au",
"name": "Intermediary",
"recipientId": "1",
"routingOrder": "1"
}
],
"signers": [
{
"clientUserId": "2",
"email": "example@example.com",
"name": "example",
"recipientId": "2",
"routingOrder": "2",
"tabs": {
"signHereTabs": [
{
"anchorIgnoreIfNotPresent": "false",
"anchorString": "Signature_anchor_1",
"anchorUnits": "pixels",
"anchorYOffset": "0",
"name": "Please sign here",
"recipientId": "1"
}
]
}
}
]
},
"workflow": {
"workflowSteps": [
{
"action": "pause_before",
"itemId": "2",
"triggerOnItem": "routing_order"
}
]
},
"emailSubject": "DocuSign API - Signature Request on Document Call",
"documents": [
{
"documentId": "1",
"name": "{{fileName}}",
"documentBase64": "{{fileBase64}}"
}
],
"status": "sent"
}

我可以在更改签名者的电子邮件/姓名后设置clientUserId但无法通过调用 API 恢复工作流PUT {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}?resend_envelope=true.因此,无法获取签名者的签名 URL,因为该过程已暂停,签名者的状态将保持created

我也尝试了agents

{
"recipients": {
"agents": [
{
"clientUserId": "1",
"email": "aaa@example.com.au",
"name": "Agent",
"recipientId": "1",
"routingOrder": "1"
}
],
"signers": [
{
"clientUserId": "2",
"email": "",
"name": "",
"recipientId": "2",
"routingOrder": "2",
"tabs": {
"signHereTabs": [
{
"anchorIgnoreIfNotPresent": "false",
"anchorString": "Signature_anchor_1",
"anchorUnits": "pixels",
"anchorYOffset": "0",
"name": "Please sign here",
"recipientId": "1"
}
]
}
}
]
},
"workflow": {
"workflowSteps": [
{
"action": "pause_before",
"itemId": "2",
"triggerOnItem": "routing_order"
}
]
},
"emailSubject": "DocuSign API - Signature Request on Document Call",
"documents": [
{
"documentId": "1",
"name": "{{fileName}}",
"documentBase64": "{{fileBase64}}"
}
],
"status": "sent"
}

代理添加姓名/电子邮件后,该过程将暂停,我为签名者设置了clientUserId,我通过调用获取收件人信息 API 验证了它是否已添加。恢复该过程后,DocuSign 会向签名者发送电子邮件,但我无法获取该签名者的嵌入式签名 URL。我可以看到通过再次调用获取收件人信息 API 来删除该签名者的clientUserId

我的问题是:

  1. 在DocuSign中使用代理/中介时,我们是否有可能获得代理/中介更新/添加其电子邮件的分配签名者的嵌入式签名URL?
  2. 在DocuSign中使用代理/中介时,我们是否可以关闭从DocuSign到签名者的电子邮件,其电子邮件由代理/中介更新/添加?

在 DocuSign 中使用代理/中介时,我们是否有可能获得其电子邮件由代理/中介更新/添加的已分配签名者的嵌入式签名 URL?

是的,但您首先需要将客户端用户 ID 分配给收件人。 由于收件人已收到签名仪式的电子邮件邀请,因此添加 clientUserId 属性是有问题的,因为这样做会使电子邮件邀请无效。

在DocuSign中使用代理/中介时,我们是否可以关闭从DocuSign到签名者的电子邮件,其电子邮件由代理/中介更新/添加?

为此,您需要停止工作流,如我在另一个答案中所述。

更好的方法是扩展您的 API 应用程序,以便使用它来更改签名者的姓名/电子邮件。这样,您的应用程序还可以同时设置 clientUserId,并且签名者不会收到任何电子邮件。

基本上,嵌入式签名仅在通过 API 程序创建/编辑信封时才有效。您使用API程序和使用常规DocuSign Web应用程序(专注于电子邮件传递,而不是嵌入式签名)的目标是混合苹果和橙子。这是可能的,但有问题。

您可以使用新的高级收件人路由 (ARR) 功能暂停信封,获取有关下一个收件人的信息(通过对 listRecipients 的 GET 调用),然后对其进行修改以添加 clientUserId。我没有尝试过这个,但理论上应该可以工作。 ARR 现在在模拟/开发者账户中可用于创建的所有新账户。 https://developers.docusign.com/docs/esign-rest-api/how-to/pause-workflow 包含有关如何创建信封的信息,使其在特定路由号码之后暂停。 https://developers.docusign.com/docs/esign-rest-api/how-to/unpause-workflow 显示了如何在进行更改后恢复信封。 您可能需要做的另一件事是在中介的状态更新时添加一个 webhook 调用,以便您知道何时更新下一个收件人(但在执行此操作之前,您必须获取有关新收件人的信息)。

最新更新