docusignapi - UNKNOWN_ENVELOPE_RECIPIENT 但收件人实际上匹配

Question

我们遇到了这个错误:

{"errorCode"=>"UNKNOWN_ENVELOPE_RECIPIENT", "message"=>"您确定的收件人不是指定信封的有效收件人。无法确定信封收件人。'clientUserId'、'email' 或 'userName'在请求和信封中可能不匹配。"}

但是，签名者由电子邮件字段或 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\"}

Answer 1

如果您可以使用以下信息更新您的问题，则此问题的故障排除应该很简单:

对信封 (GET /accounts/{accountId}/envelopes/{envelopeId}/recipients) 执行“获取收件人”请求时收到的响应

用于“POST Recipient View”请求的 JSON 或 XML ( POST /accounts/{accountId}/envelopes/{envelopeId}/views/recipient )。

如果您可以更新您的问题以包含此信息，我将更新我的答案以提供有关消除您收到的错误的信息。

更新 #1

感谢您更新您的问题以包含该信息。我理解您不愿意在此处发布您的特定信息/数据——您应该随时更改(即，使之通用)您不喜欢共享的任何数据。数据值在解决此类问题时通常无关紧要——但查看您在请求中包含/设置的属性以及响应结构的外观至关重要。

作为对REST API指南( http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf)的166-167页表中所描述，“您可以使用 电子邮件与 的userName 或 用户id 识别收件人”在 POST收件人查看请求。看起来您的请求仅指定 用户名 - 尝试将 电子邮件 添加到请求中，这应该可以消除您遇到的错误。

更新 #2

您在 POST Recipient View 请求中为 userName 指定的值需要与您在 中为签名者的名称指定的值相匹配，即在 中创建相同的值，即返回的信封 12040477047047040777917 GET Recipients 响应的名称 属性。尝试在您的请求中将“Bridget C. Shoemaker”指定为 username 的值(而不是使用值“第三方验证”):

"userName":"Bridget C. Shoemaker"

更新 #3

当用户被指定为信封收件人时，用户可以在此处允许或禁止其姓名的替代拼写(首选项 >> 可用姓名 >> “发件人可以添加我姓名的新拼写”(复选框)):


正如您所见，“GET Recipients”调用将始终返回在 Envelope 中创建的每个 Recipient 的名称——因此您可以考虑添加一个“GET Recipients”调用来检索实际的 Recipient Name，然后再进行“POST Recipient View”调用——有点麻烦，但至少你可以保证能够为“POST Recipient View”调用提供成功的信息。