Question

创建稍后用于生成查看URL以供签名者使用而不是接收电子邮件的信封时，我们遇到的问题是我们指定的用户无效。

例如，这是一个有一个收件人的信封，＆＃34; Peter Hughes Jr。＆＃34;

Request URL: https://na2.docusign.net/restapi/v2/accounts/4476693/envelopes/f3a45945-f1ff-4731-a407-963a32378d77/recipients
------
{"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
Request headers: 
X-DocuSign-Authentication : {"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
Host : na2.docusign.net
Connection : Keep-Alive
------
Request body: 

------
Response headers: 
Strict-Transport-Security : max-age=7776000; includeSubDomains
Content-Length : 696
Cache-Control : no-cache
Content-Type : application/json; charset=utf-8
Date : Thu, 18 Dec 2014 15:26:42 GMT
------
Response body: 
{
  "signers": [
    {
      "name": "Peter Hughes Jr.",
      "email": "pwhughes@verizon.net",
      "recipientId": "1",
      "recipientIdGuid": "2461be9a-69d3-420d-b5f3-2c327af2f5f6",
      "requireIdLookup": "false",
      "userId": "0d5035dc-b70f-4026-8283-5c8d8903385a",
      "clientUserId": "1",
      "routingOrder": "1",
      "note": "",
      "roleName": "Applicant",
      "status": "sent",
      "templateLocked": "false",
      "templateRequired": "false"
    }
  ],
  "agents": [],
  "editors": [],
  "intermediaries": [],
  "carbonCopies": [],
  "certifiedDeliveries": [],
  "inPersonSigners": [],
  "recipientCount": "1",
  "currentRoutingOrder": "1"
}

当我们尝试为此用户设置视图时，会发生以下异常：

Request URL: https://na2.docusign.net/restapi/v2/accounts/4476693/envelopes/f3a45945-f1ff-4731-a407-963a32378d77/views/recipient
------
{"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
------
EXCEPTION
System.Net.WebException: The remote server returned an error: (400) Bad Request.
   at System.Net.HttpWebRequest.GetResponse()
   at DocusignView.Request.Send[T](String body) in C:\Users\johnathank\Desktop\docusigntest\DocusignView.cs:line 293
------
Request headers: 
X-DocuSign-Authentication : {"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
Content-Type : application/json
Host : na2.docusign.net
Content-Length : 143
Expect : 100-continue
------
Request body: 
{"authenticationMethod":"email","clientUserId":"1","email":"pwhughes@verizon.net","returnUrl":"www.impellam.com","userName":"Peter Hughes Jr."}
------
Response headers: 
Strict-Transport-Security : max-age=7776000; includeSubDomains
Content-Length : 152
Cache-Control : no-cache
Content-Type : application/json; charset=utf-8
Date : Thu, 18 Dec 2014 15:28:31 GMT
------
Response body: 
{
  "errorCode": "UNKNOWN_ENVELOPE_RECIPIENT",
  "message": "The recipient you have identified is not a valid recipient of the specified envelope."
}

我们确实已经确定了问题，但尚未找到实施解决方案的好方法。当检查Docusign内的信封时，我可以看到该用户采用了名称＆＃34; Peter W. Hughes Jr＆＃34;。

所以我尝试发送另一个名为＆＃34; Peter W. Hughes Jr。＆＃34;相反，它工作... 然而这会带来问题。我们如何才能找出用户所采用的名称？它不在原始信封数据中，并且在iodocs.docusign.com上浏览API时，似乎没有一种方法可以为我提供用户所采用的名称。

我已经阅读了一个替代解决方案，它说我们可以在视图请求中提供userId而不是userName，但是当我尝试这样做时，我收到一个错误，指示userName是必需的。

Request URL: https://na2.docusign.net/restapi/v2/accounts/4476693/envelopes/f3a45945-f1ff-4731-a407-963a32378d77/views/recipient
------
{"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
------
EXCEPTION
System.Net.WebException: The remote server returned an error: (400) Bad Request.
   at System.Net.HttpWebRequest.GetResponse()
   at DocusignView.Request.Send[T](String body) in C:\Users\johnathank\Desktop\docusigntest\DocusignView.cs:line 295
------
Request headers: 
X-DocuSign-Authentication : {"IntegratorKey":"***","Password":"***","Username":"onboarding@impellam.com"}
Content-Type : application/json
Host : na2.docusign.net
Content-Length : 191
Expect : 100-continue
------
Request body: 
{"authenticationMethod":"email","clientUserId":"1","email":"pwhughes@verizon.net","returnUrl":"www.impellam.com","userId":"2461be9a-69d3-420d-b5f3-2c327af2f5f6","userName":"Peter Hughes Jr."}
------
Response headers: 
Strict-Transport-Security : max-age=7776000; includeSubDomains
Content-Length : 167
Cache-Control : no-cache
Content-Type : application/json; charset=utf-8
Date : Thu, 18 Dec 2014 15:52:06 GMT
------
Response body: 
{
  "errorCode": "INVALID_REQUEST_PARAMETER",
  "message": "The request contained at least one invalid parameter. A value was not found for parameter 'userName'."
}

Answer 1

这只是在飞行中向同一收件人姓名，电子邮件和clientUserId组合发送多个信封时的问题。

一旦发送了reciptoken，并且他们使用不同的名称进行签名，则因为名称更改而对第二个信封使用相同的请求将失败。

最佳做法是为每个信封生成一个新的clientUserId，或阻止收件人在DocuSign帐户功能中更改其名称。该功能称为“签名采用配置”。

请求视图时信封收件人不匹配

1 个答案: