我们遇到此错误:
{“ errorCode” =>“ UNKNOWN_ENVELOPE_RECIPIENT”,“ message” =>“您所标识的收件人不是指定信封的有效收件人。无法确定信封收件人。'clientUserId','email'或'userName'在请求中,信封可能不匹配。“}
但是,签名者是通过email字段或clientUserId(它们都是电子邮件)标识的,并且随处可见。我检查了四倍。因此,此错误似乎是完全错误的。此特定请求仅针对一个信封失败,我试图在其中获取特定用户的嵌入式签名体验。我无法使用我们为调查此问题而创建的其他电子邮件地址将问题与其他任何信封一起复制。
如果尝试加载嵌入式签名体验的用户已经拥有Docusign帐户,那会产生什么影响?从我的测试中可以看出,这个问题似乎源于她的电子邮件……似乎是在Docusign方面。
更新:
我故意有点含糊不清,因为我不喜欢公开披露此类数据。但是按照您的要求,这是get_recipients返回:
pry(main)> client.get_envelope_recipients(envelope_id: 'dffa4edc-1fcf-4098-b3e8-9b1a5ed984f8') => { "signers" => [ [0] { "name" => "Bridget C. Shoemaker", "email" => "bridget.shoemaker@oakpartners.com", "recipientId" => "1", "recipientIdGuid" => "c8edf6a1-ab19-4bd0-af75-715bcec43aa1", "requireIdLookup" => "false", "userId" => "1a873cb0-044a-4b3f-9e0d-dc6a948e579b", "clientUserId" => "bridget.shoemaker@oakpartners.com", "routingOrder" => "1", "note" => "", "roleName" => "Third Party", "status" => "delivered", "deliveredDateTime" => "2013-12-09T18:25:44.7800000Z" } ], "agents" => [], "editors" => [], "intermediaries" => [], "carbonCopies" => [], "certifiedDeliveries" => [], "inPersonSigners" => [], "recipientCount" => "1", "currentRoutingOrder" => "1" }
这是REST API的JSON格式的get_recipient_view请求正文
{\"authenticationMethod\":\"email\",\"clientUserId\":\"bridget.shoemaker@oakpartners.com\",\"email\":\"bridget.shoemaker@oakpartners.com\",\"returnUrl\":\"https://app.bolstr.com/accredited_verifications/113/docusign_response?accredited_verification_id=113\",\"userName\":\"Third Party Verification\"}
Kim Brandl.. 5
如果可以使用以下信息来更新您的问题,则解决此问题的过程应该很简单:
对信封(GET /accounts/{accountId}/envelopes/{envelopeId}/recipients
)执行“获取收件人”请求时收到的响应
您用于“ POST收件人视图”请求(POST /accounts/{accountId}/envelopes/{envelopeId}/views/recipient
)的JSON或XML 。
如果您可以更新问题以包括此信息,我将更新答案以提供有关消除您收到的错误的信息。
更新#1
感谢您更新您的问题以包含该信息。我们了解您不愿意在此处发布您的特定信息/数据-您应该随时更改(即使用通用的)任何您不愿意共享的数据。数据值通常对于解决此类问题无关紧要-但至关重要的是查看要在请求中包含/设置的属性以及响应结构的外观。
如REST API指南(http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf)第166-167页中的表所述,“您可以使用电子邮件 AND 用户名或用户ID来标识POST收件人视图请求中的“收件人” 。看起来您的请求仅指定了UserName-也尝试向请求中添加电子邮件,这样可以消除您收到的错误。
更新#2
您在POST收件人视图请求中为userName指定的值必须与您在“ 创建信封”请求中为签名者名称指定的值匹配-即,该值将与GET收件人响应的name属性中返回的值相同。请尝试在请求中指定“ Bridget C. Shoemaker”作为用户名的值(而不是使用“第三方验证”值):
"userName":"Bridget C. Shoemaker"
更新#3
在将用户指定为信封收件人时,可以在此处允许或禁止其姓名的其他拼写(首选项>>可用名称>>“发件人可以添加我的名字的新拼写”(复选框)):
如您所见,“ GET收件人”调用将始终返回在信封中创建的每个收件人的名称-因此,您可以考虑添加“ GET收件人”调用以检索实际的收件人名称,然后再创建“ POST收件人视图”调用-有点麻烦,但至少可以保证您能够为“ POST收件人视图”调用提供信息,以确保成功。