一旦信封处于正在处理状态,是否可以在共享文档上切换签名者(带标签)?
我们的流程如下:
为所有签名者生成单个共享PDF文档(不使用DocuSign模板)和签名占位符。
我们为文档PDF创建并发送信封。
一个或多个客户签署文档(使用嵌入式签名页面)。
最后一位签名者(我们的员工)签署文件(也使用嵌入式签名页)。
员工签名者可以是几个员工中的一个,但无论是谁,他们都会在文档上签署相同的位置。我们希望能够延迟选择哪个员工签署文档直到流程结束,而不必在创建信封时指定它们。
信封处于正在处理状态后,我可以添加和删除员工收件人,但我也无法找到包含其选项卡的方法。我在请求中包含选项卡,但添加的员工始终处于草稿状的“已创建”状态,没有选项卡。嵌入视图仍然要求查看者手动放置其标签。我需要将标签放置并锁定在文档上,以便员工签名。
我们正在使用REST API,这需要是一个自动化解决方案(无需手动修改信封)。有没有办法实现这个或类似的东西?
这是我的添加收件人请求
POST https://demo.docusign.net/restapi/v2/accounts/<account>/envelopes/<envelope-id>/recipients?resend_envelope=true
{
"signers" : [{
"recipientId" : 4,
"email" : "john@example.com",
"name" : "John Citizen",
"tabs" : {
"initialHereTabs" : [{
"documentId" : "1",
"recipientId" : 4,
"name" : "InitialHere_3",
"pageNumber" : 1,
"xPosition" : 282,
"yPosition" : 454,
"tabName" : "InitialHere_3"
}
],
"signHereTabs" : [{
"documentId" : "1",
"recipientId" : 4,
"name" : "SignHere_3",
"pageNumber" : 1,
"xPosition" : 81,
"yPosition" : 447,
"tabName" : "SignHere_3"
}
],
},
"clientUserId" : "LTEST_Resident4",
"routingOrder" : 2,
}
]
}
(我也尝试过使用PUT而不是POST的相同请求。结果是一样的)
答案 0 :(得分:2)
听起来您的工作流程需要执行以下操作:
我假设你有1.照顾,我会仔细阅读2-4的例子。
POST: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients
{
"signers": [
{
"email": "email@domain.com",
"name": "Andrew Wilson",
"recipientId": "3",
"defaultRecipient": "true",
"routingOrder": "3"
}
]
}
POST: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs
{
"signHereTabs": [
{
"xPosition": "100",
"yPosition": "200",
"documentId": "1",
"pageNumber": "1"
},
{
"xPosition": "200",
"yPosition": "200",
"documentId": "1",
"pageNumber": "1"
}
]
}
DELETE: https://demo.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}
答案 1 :(得分:0)
听起来您正在尝试修改或更正并重新发送收件人信息。
https://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf Page 137
修改或更正并重新发送收件人信息
这使您可以修改草稿信封中的收件人或更正正在处理的信封的收件人信息。对于草稿信封,您可以编辑:email,userName,routingOrder,faxNumber,deliveryMethod,accessCode和requireIdLookup。发送信封后,您只能编辑:email,userName,signerName,routingOrder,faxNumber和deliveryMethod。您还可以选择使用resend_envelope选项重新发送信封。
示例请求:
PUT https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients?resend_envelope=true
X-DocuSign-Authentication:<DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials>
Accept: application/json
Content-Type: application/json
{
"signers": [
{
"email": "email@domain.com",
"name": "John Smith",
"recipientId": "1"
}
]
}
<强>响应强>
如果更正成功,则返回响应。以下示例显示响应json正文。
响应示例:
{
"recipientUpdateResults": [
{
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
},
"recipientId": "1"
}
]
}