UNKNOWN_ENVELOPE_RECIPIENT但收件人确实匹配

时间:2013-12-10 17:01:39

标签: docusignapi

我们遇到了这个错误:

{“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\"}

1 个答案:

答案 0 :(得分:4)

如果您可以使用以下信息更新您的问题,则此问题的解决方法应该很简单:

  • 执行信封的“获取收件人”请求时收到的回复(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 userName 或< strong> userId 以在 POST收件人视图请求中标识收​​件人。看起来您的请求仅指定 userName - 尝试将电子邮件添加到请求中,这样可以消除您获得的错误。

更新#2

您在 POST收件人视图请求中为 userName 指定的值需要与您在创建信封中创建信封中的签名者名称所指定的值相匹配请求 - 即,这将与 GET收件人响应的名称属性中返回的值相同。尝试在您的请求中指定“Bridget C. Shoemaker”作为用户名的值(而不是使用值“第三方验证”):

"userName":"Bridget C. Shoemaker"

更新#3

以下是用户在指定为信封收件人时可以允许或禁止其名称的替代拼写的位置(首选项&gt;&gt;名称可用&gt;&gt;“发件人可以添加我姓名的新拼写”(复选框) )): user setting

正如您所见,“GET Recipients”调用将始终返回每个收件人在信封中创建的名称 - 因此您可以考虑添加“GET收件人”调用以检索实际的收件人名称进行“POST收件人视图”调用 - 有点麻烦,但至少你可以保证能够为“POST收件人视图”调用提供信息以便成功。