我正在集成 Docusign，以便收件人可以看到他们的信封嵌入在我的网站上。我首先使用 api 创建信封，然后尝试使用动态数据预填充数据字段。
据我所知，我用来创建信封的 json 没有任何问题。 StackOverflow 上针对此问题的其他解决方案均无济于事。我的 json 看起来像这样（我发送到https://demo.docusign.net/restapi/v2/accounts/360734/envelopes https://demo.docusign.net/restapi/v2/accounts/360734/envelopes):
{
"status": "sent",
"emailBlurb": "Please sign the document.",
"emailSubject": "Please sign your agreement",
"templateId": "TEMPLATE_ID",
"templateRoles": [
{
"clientUserId": "EMAIL",
"name": "NAME",
"email": "EMAIL",
"roleName": "Signer1",
"tabs": {
"textTabs": [
{
"tabLabel": "address",
"value": "ADDRESS "
},
{
"tabLabel": "multi_address",
"value": "ADDRESSES"
}
]
}
},
{
"name": "ANOTHER NAME",
"email": "ANOTHER EMAIL",
"roleName": "Random1"
}
]
}
我得到以下回复：
{
"envelopeId": "ENVELOPE_ID",
"uri": "/envelopes/ENVELOPE_ID",
"statusDateTime": "2013-10-25T01:20:55.6750772Z",
"status": "sent"
}
然后我通过发布到来获取向客户展示的链接https://demo.docusign.net/restapi/v2/accounts/360734/envelopes/ENVELOPE_ID/views/recipient https://demo.docusign.net/restapi/v2/accounts/360734/envelopes/ENVELOPE_ID/views/recipient
{
"authenticationMethod": "email",
"clientUserId": "EMAIL",
"email": "EMAIL",
"returnUrl": "MYURL",
"userName": "NAME"
}
我得到这样的回应：
{
"url": "https://demo.docusign.net/Member/StartInSession.aspx?t=REDACTED"
}
这遵循此处看到的示例：https://github.com/Ergin008/DocuSign-REST-API-Webinar-April2013/blob/master/example2.json https://github.com/Ergin008/DocuSign-REST-API-Webinar-April2013/blob/master/example2.json
以这种方式创建信封后，标签似乎没有预填充。当我查看网站上嵌入的信封时，没有任何内容。我确信 tabLabels 是正确的。其他一切似乎都工作正常。我缺少某种设置吗？
UPDATE看来这可能是一个错误！我所更改的只是角色名称，它有效！
{
"status": "sent",
"emailBlurb": "Please sign the document.",
"emailSubject": "Please sign your agreement",
"templateId": "TEMPLATE_ID",
"templateRoles": [
{
"clientUserId": "EMAIL",
"name": "NAME",
"email": "EMAIL",
"roleName": "Signer1",
"tabs": {
"textTabs": [
{
"tabLabel": "address",
"value": "ADDRESS "
},
{
"tabLabel": "multi_address",
"value": "ADDRESSES"
}
]
}
},
{
"name": "ANOTHER NAME",
"email": "ANOTHER EMAIL",
"roleName": "Signer2"
}
]
}
而且人口众多！看来如果我以 Signer 以外的任何名称开始角色名称，它就不起作用。诡异的！
是的，在本例中，我将 Docusign 上的角色名称从 Random1 更改为 Signer2。例如，Signer3 也可以工作。
您的问题表明您将该 JSON 提交到“获取收件人视图”资源：
https://demo.docusign.net/restapi/v2/accounts/ACCOUNT_ID/envelopes/ENVELOPE_ID/views/recipient)
...但是该 JSON 看起来像您在“创建信封”请求中使用的内容，而不是“获取收件人视图”请求中使用的内容。因此，让我首先澄清促进嵌入式/强制签名的过程（即在您的站点内呈现收件人的信封）。这样做分为两步：
STEP 1：创建信封（如果需要，请求包括为每个收件人预填充字段的数据）。
POST https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes
请参阅 REST API 指南第 27 页开始的“从模板创建信封”部分（http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf）有关请求和响应的详细信息。
STEP 2：检索可用于启动收件人信封（签名会话）的 URL。
POST https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/views/recipient
{
"authenticationMethod":"Email",
"clientUserId":"CLIENT_USERID_SPECIFIED_IN_REQUEST",
"email":"RECIPIENT_EMAIL",
"returnUrl":"URL_TO_REDIRECT_TO_WHEN_SIGNING_COMPLETE",
"userName":"RECIPIENT_NAME"
}
响应将包含可用于启动收件人信封的 URL：
{
"url":"URL_THAT_WILL_LAUNCH_ENVELOPE"
}
请参阅 REST API 指南第 160 页开始的“收件人后视图”部分（http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf）有关请求和响应的更多详细信息。
现在，假设您正确执行了所有这些操作（步骤 1 和步骤 2），那么让我们回到您报告的问题：难以为收件人预填充字段。关于您问题中包含的“从模板创建信封”JSON 的一些评论：
因此，这是一个“从模板创建/发送信封”示例请求（step 1上面），用值“VALUE_A”预先填充名为“FIELD_1”的选项卡，该选项卡出现在信封中的任何位置：
POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes
{
"status" : "sent",
"emailBlurb" : "please sign",
"emailSubject" : "Please sign your document",
"templateId" : "TEMPLATE_ID",
"templateRoles" : [{
"name" : "John Doe",
"email" : "[email protected] /cdn-cgi/l/email-protection",
"roleName" : "Signer1Role",
"clientUserId" : "123",
"tabs" :
{"textTabs":[{
"tabLabel":"\\*FIELD_1",
"value":"VALUE_A"}
]}
}]
}
然后，您将获取响应中返回的信封 ID 并调用“获取收件人视图”资源（step 2上面）获取启动签名会话的 URL：
POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes/ENVELOPE_ID/views/recipient
{
"authenticationMethod": "Email",
"clientUserId": "123",
"userName": "John Doe",
"email": "Johns[email protected] /cdn-cgi/l/email-protection",
"returnUrl": "http://www.google.com"
}
Finally, one last comment (but an important one): if you're just wanting to inject the recipient's "full name" in the document -- use the "Full Name" tab when creating the Template and DocuSign will automatically inject the recipient's name in place of that tag, anywhere that it appears (instead of you using a Text Tab and having to populate it via the API request). Here's the Full Name tag in the DocuSign UI tagger view:
另一个创建信封示例（带有数据字段属性的屏幕截图):
如果我提交此请求：
POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes
{
"emailSubject": "Please sign this",
"emailBlurb": "Please sign...thanks!",
"templateId": "TEMPLATE_ID",
"envelopeIdStamping": "false",
"templateRoles": [
{
"roleName": "Signer1",
"name": "John Doe",
"email": "[email protected] /cdn-cgi/l/email-protection",
"recipientId": "1",
"tabs":{
"textTabs":[
{
"tabLabel":"\\*address",
"value":"123 Main Street"
},
],
}
}
],
"status": "sent"
}
数据字段属性（通过 DocuSign UI 编辑模板时）如下所示：
那么结果就是带有 Label = 的字段address分配给收件人角色的Signer1当签名者查看其信封时，将预先填充值“123 Main Street”。如果这不适合您，我建议您：
Note: 值为区分大小写，因此请确保您请求中的值是exact与数据字段标记属性中的值匹配（包括大写/小写）。