docusignapi - DocuSign REST API - RecipientView 异常 "UNKNOWN_ENVELOPE_RECIPIENT"

Question

我们目前在使用 docusign 开发集成网络解决方案时遇到了一些技术难题。请您提供以下建议:

1. 我们如何在基于文档的 rest api 调用中为收件人分配签名顺序？可以举个json的例子吗？

2. 我们目前无法检索已添加到已创建信封的用户的签名 URL。此代码以前适用于基于模板的信封创建，但不适用于基于使用 PDF 的信封。

对docusign API 的调用和响应(已删除密码)如下所示。两种认证方法都试过了，都失败了。通过信封中的任一电子邮件检索也失败。

POST \\https://demo.docusign.net/restapi/v2/accounts/426142/envelopes/3b2d7418-27d3-4a80-8969-d875b6fb9548/views/recipient HTTP/1.1 
X-DocuSign-Authentication: {"Username":"18f90756-70b1-4f5f-b360-48b198a17215","Password":"*REMOVED*","IntegratorKey":"*REMOVED*"} 
Accept: application/json, application/xml, text/json, text/x-json, text/javascript, text/xml  
Content-Type: application/json 
Host: demo.docusign.net<http://demo.docusign.net> 
Content-Length: 128 
Accept-Encoding: gzip, deflate 

{
    "authenticationMethod": "email",
    "userName": "Simon",
    "email": "test@email",
    "returnUrl": "http://www.google.com"
} 

HTTP/1.1 400 Bad Request 
Cache-Control: no-cache 
Content-Length: 274 
Content-Type: application/json; charset=utf-8 
Date: Fri, 24 Jan 2014 12:11:38 GMT 
Strict-Transport-Security: max-age=7776000; includeSubDomains 

{ 
"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." 
} 

Answer 1

首先，关于指定收件人的顺序，只需为每个收件人设置 routingOrder 属性即可。例如，这个示例 JSON 显示了一个 recipients 结构，它指定 John 应该首先收到信封 (routingOrder=1)，而 Jane 应该第二次收到 Envelope (routingOrder=2):

"recipients": {
    "signers": [
        {
            "name": "John Doe",
            "email": "johnsemail@outlook.com",
            "recipientId": "1",
            "routingOrder": "1",
        },
        {
            "name": "Jane Smith",
            "email": "janesemail@outlook.com",
            "recipientId": "2",
            "routingOrder": "2",
        }
    ]
}

您在响应 POST Recipient View 请求时收到的“UNKNOWN_ENVELOPE_RECIPIENT”错误消息仅表示您提供的收件人信息与以下信息不(完全/完全)匹配您指定的信封中的任何收件人。

首先，请记住，如果您想使用 POST Recipient View 调用来检索可用于启动收件人签名 session 的 URL，那么 Create信封 请求和 POST Recipient View 请求必须包含收件人的(相同)clientUserId 属性值。 (您发布的请求 JSON 不包含 clientUserId。)

如果在 POST Recipient View 请求中包含 clientUserId 属性不能解决您的问题，那么为了进一步排除故障，我建议您执行 >Get Recipients 调用相同的信封，并将响应中的收件人属性与您在(不成功的)POST Recipient View 调用中提供的属性值进行比较。 GET Recipients 请求很简单:

GET/accounts/{accountId}/envelopes/{envelopeId}/recipients