使用位于http://iodocs.docusign.com/的 DocuSign REST Api 页面,我使用“来自复合 Templatesv2/accounts/:accountId/envelopes”选项在“请求签名”选项卡下创建了一个复合信封。我的请求网址是:“ uri”:“ //demo.docusign.net/restapi/v2/accounts/660598/envelopes”,正文为
{
"emailBlurb": "Sign Me",
"emailSubject": "Sign this",
"status": "Created",
"templateId": "d34e9aa1-bc1d-41bc-ab3d-de42057dc990",
"templateRoles": [
{
"tabs": {
"textTabs": [
{
"tabLabel": "AccountFirstName",
"value": "FirstName"
},
{
"tabLabel": "AccountLastName",
"value": "LastName"
}
]
},
"roleName": "Account Holder",
"name": "William Heine",
"email": "myEmail@email.com"
}
],
"compositeTemplates": [
{
"serverTemplates": [
{
"sequence": "1",
"templateId": "d34e9aa1-bc1d-41bc-ab3d-de42057dc990"
}
],
"inlineTemplates": [
{
"sequence": "1"
}
]
},
{
"serverTemplates": [
{
"sequence": "2",
"templateId": "2661f101-6bea-4ec1-826d-d3f69863c393"
}
],
"inlineTemplates": [
{
"sequence": "2"
}
]
},
{
"serverTemplates": [
{
"sequence": "3",
"templateId": "1e2aa3b8-8e17-4b57-b7b1-5539a896f1c0"
}
],
"inlineTemplates": [
{
"sequence": "3"
}
]
},
{
"serverTemplates": [
{
"sequence": "4",
"templateId": "5a59fdd0-ae1d-4907-aead-608fc544422f"
}
],
"inlineTemplates": [
{
"sequence": "4"
}
]
}
]
}
对此的响应是:
{
"envelopeId": "3a9388dc-5c8e-49f5-88c5-7e666363534a",
"uri": "/envelopes/3a9388dc-5c8e-49f5-88c5-7e666363534a",
"statusDateTime": "2014-07-25T22:50:45.9000000Z",
"status": "created"
}
接下来,我进入“视图”选项卡,并使用以下 URL 进行呼叫“ Recipientv2/accounts/:accountId/envelopes/:envelopeId/views/recipient”:“ uri”:“ //demo.docusign.net/restapi/v2/accounts/660598/envelopes/3a9388dc-5c8e-49f5-88c5-7e666363534a/views/recipient”和此正文:
{
"authenticationMethod": "email",
"email": "myEmail@email.com",
"returnUrl": "http://testing.ad.mtrust.com/",
"userName": "William Heine"
}
我得到这个错误:
{
"errorCode": "UNKNOWN_ENVELOPE_RECIPIENT",
"message": "The recipient you have identified is not a valid recipient of the specified envelope. Envelope recipient could not be determined. 'clientUserId', 'email', or 'userName' in request and envelope may not match."
}
用户名和电子邮件地址相同。没有在复合信封上输入 clientUserId 的位置。那么为什么这不起作用呢?
2 回答
当您发送状态为
created
的信封时,它将成为 DocuSign 中的草稿。您必须以状态sent
发送,才能发送给接收者。views/recipients
请求要求信封处于created
以外的任何状态。为了使用嵌入式签名(和收件人视图),收件人必须具有 clientUserId。尽管 iodocs 可能不会公开它,但这是必需的,除非您的签名者也是经过身份验证的 API 用户。您可以在 inlineTemplates 中将“ clientUserId”添加到签名者对象: