Docusignapi 如何为DocuSign中由代理/中介分配的签名者获取嵌入式签名URL?
在DocuSign中使用代理/中介分配签名者时,我们为签名者设置Docusignapi 如何为DocuSign中由代理/中介分配的签名者获取嵌入式签名URL?,docusignapi,Docusignapi,在DocuSign中使用代理/中介分配签名者时,我们为签名者设置clientUserId,以使用嵌入式签名功能。但是DocuSign将自动向指定的签名者发送电子邮件,我们无法通过APIPOST{{baseUrl}/v2.1/accounts/{{accountId}}/envelopes/{envelopeId}/views/recipient获取签名URL 如此线程中所建议的:。这是因为代理/中介更改签名人的电子邮件/姓名信息时,clientUserId被删除。建议在签名人的电子邮件/姓名信息
clientUserId
,以使用嵌入式签名功能。但是DocuSign将自动向指定的签名者发送电子邮件,我们无法通过APIPOST{{baseUrl}/v2.1/accounts/{{accountId}}/envelopes/{envelopeId}/views/recipient
获取签名URL
如此线程中所建议的:。这是因为代理/中介更改签名人的电子邮件/姓名信息时,clientUserId
被删除。建议在签名人的电子邮件/姓名信息更改后,可以添加工作流
,以暂停流程,然后向签名人添加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}}?重新发送信封=true
。因此无法获取签名者的签名URL,因为该过程已暂停,签名者的状态保持在created
我还与代理一起尝试了以下操作:
{
"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
,我通过调用get recipients info API验证了它是否已添加。在我恢复该过程后,DocuSign会向签名者发送一封电子邮件,我无法获取该签名者的嵌入签名URL。我可以看到,通过再次调用get recipients info API,该签名者的clientUserId
已被删除
我的问题是:
在DocuSign中使用代理/中间人时,我们是否可以为代理/中间人更新/添加电子邮件的指定签名人获取嵌入的签名URL?
在DocuSign中使用代理/中间人时,我们是否可以关闭DocuSign发送给签名人的电子邮件,签名人的电子邮件由代理/中间人更新/添加?
您可以潜在地使用新的高级收件人路由(ARR)功能暂停信封,获取关于下一个收件人的信息(通过GET call to listRecipients),然后修改它以添加clientUserId。我没有尝试过这个,但理论上应该是可行的。
对于创建的所有新帐户,ARR现在在演示/开发人员帐户中可用。
包含有关如何创建封套的信息,以便封套在特定路由编号后暂停。
演示如何在进行更改后恢复信封。
您可能需要做的另一件事是添加一个webhook调用,以便在中间层的状态更新时知道何时更新下一个收件人(但在更新之前,您必须获取有关新收件人的信息)。您可以潜在地使用新的高级收件人路由(ARR)功能暂停信封,获取下一个收件人的信息(通过GET call to listRecipients),然后对其进行修改以添加clientUserId。我没有尝试过这个,但理论上应该是可行的。
对于创建的所有新帐户,ARR现在在演示/开发人员帐户中可用。
包含有关如何创建封套的信息,以便封套在特定路由编号后暂停。
演示如何在进行更改后恢复信封。
您可能需要做的另一件事是添加一个webhook调用,以便在中间人的状态被更新时知道何时更新下一个收件人(但在您可以这样做之前,您必须获得有关新收件人的信息)
在DocuSign中使用代理/中介时,我们是否可以为代理/中介更新/添加电子邮件的指定签名人获取嵌入的签名URL
是的,但首先需要为收件人分配clientUserId。
而且,由于收件人已被发送电子邮件邀请参加签名仪式,因此添加clientUserId属性是有问题的,因为这样做将使电子邮件邀请无效
在DocuSign中使用代理/中间人时,我们是否可以关闭DocuSign发送给签名人的电子邮件,签名人的电子邮件由代理/中间人更新/添加
为此,您需要停止工作流,正如我在另一个答案中所描述的那样
更好的做法是扩展API应用程序,以便使用它更改签名者的姓名/电子邮件。这样,您的应用程序也可以同时设置clientUserId,签名者将不会收到任何电子邮件
基本上,只有通过API程序创建/编辑信封时,嵌入式签名才有效。您使用API程序和常规DocuSign Web应用程序(专注于电子邮件传递,而非嵌入式签名)的目标是混合苹果和橙子。这是可能的,但有问题
在DocuSign中使用代理/中介时,我们是否可以为代理/中介更新/添加电子邮件的指定签名人获取嵌入的签名URL
是的,但首先需要为收件人分配clientUserId。
而且,由于收件人已被发送电子邮件邀请参加签名仪式,因此添加clientUserId属性是有问题的,因为这样做将使电子邮件邀请无效
在DocuSign中使用代理/中间人时,我们是否可以关闭DocuSign发送给签名人的电子邮件,签名人的电子邮件由代理/中间人更新/添加
为此,您需要停止工作流,正如我在另一个答案中所描述的那样
更好的做法是扩展API应用程序,以便使用它更改签名者的姓名/电子邮件。这样,您的应用程序也可以同时设置clientUserId,签名者将不会收到任何电子邮件
基本上,嵌入式签名