DocusignAPI：UNKNOWN_RECIPIENT

Question

我有2个信封，上面有2个不同的文档，但收件人信息相同：

我的数据json如下：信封1：

   {
      "envelopeId": "a2c6bb90-bc62-4c54-84f0-47b31ae559ea",
      "uri": "/envelopes/a2c6bb90-bc62-4c54-84f0-47b31ae559ea",
      "statusDateTime": "2017-03-28T06:11:41.9255402Z",
      "status": "sent"
    }
    {
      "templateId": "14c79646-7849-4f15-801e-af85875b9d2a",
      "templateRoles": [
        {
          "email": "nguyenvannhu0405@gmail.com",
          "roleName": "Client",
          "name": "Nguyen Nhu",
          "clientUserId": "1091",
        },
        {
          "email": "nguyenvannhu.1234@gmail.com",
          "roleName": "Signer2",
          "name": "Nguyen Nhu 2",
          "clientUserId": "1092",
          "tabs": {
          }
        }
      ],
      "status": "sent",
      "emailSubject": "Test File Contract.pdf"
    }

信封2：

{
  "envelopeId": "e0cb2849-7f5c-456d-ae95-0372d2d333f2",
  "uri": "/envelopes/e0cb2849-7f5c-456d-ae95-0372d2d333f2",
  "statusDateTime": "2017-03-28T06:17:39.0928408Z",
  "status": "sent"
}
{
  "templateId": "1080a8a2-d5be-4402-99f7-cbab35910d8d",
  "templateRoles": [
    {
      "email": "nguyenvannhu0405@gmail.com",
      "roleName": "Client",
      "name": "Nguyen Nhu",
      "clientUserId": "1091",
      "tabs": {

      }
    },
    {
      "email": "nguyenvannhu.1234@gmail.com",
      "roleName": "Signer2",
      "name": "Nguyen Nhu 2",
      "clientUserId": "1092",
      "tabs": {

  "status": "sent",
  "emailSubject": "Test File.pdf"
}

问题是，当客户登录URL时，我将客户名称（Nguyen Nhu更改为Nguyen Nhu 12）。 我为信封1和信封2签了字。

信封1已完成

但是，当共同客户也执行相同操作时：将Signer2名称（Nguyen Nhu 2更改为Nguyen Nhu 22）。

我只签名信封1，信封2却报错：

DocuSign.eSign.Client.ApiException: Error calling CreateRecipientView: {
  "errorCode": "UNKNOWN_ENVELOPE_RECIPIENT",
  "message": "The recipient you have identified is not a valid recipient of the specified envelope."
}
   at DocuSign.eSign.Api.EnvelopesApi.CreateRecipientViewWithHttpInfo(String accountId, String envelopeId, RecipientViewRequest recipientViewRequest)
   at DocuSign.eSign.Api.EnvelopesApi.CreateRecipientView(String accountId, String envelopeId, RecipientViewRequest recipientViewRequest)
   at Docusigndll.Docusign.GetUrlDocumentSign(String accountId, String envelopeId, Recipient recipient, String urlRedirect) in d:\soft\Docusigndll\Docusigndll\Docusign.cs:line 269

我模糊地认为错误是因为当我更改联合客户的名称（在信封1上签名）并且Docusign保存在数据库的新联合客户名称中时，信封1和信封2中的CliendUserId相同。客户端与收件人名称不同，保存在Docusign数据库中。 =>错误。但是为什么我也要使用相同的客户端名称却不会出错。

希望大家帮助我，谢谢

Answer 1

发送信封并准备生成签名URL后，您需要正确标识将使用以下内容签名的收件人：

• 收件人姓名
• 收件人电子邮件
• ClientUserId
• 收件人编号

如果其中任何一个不正确，则平台将无法识别收件人，并且您将收到所看到的UNKNOWN_RECIPIENT错误。

要验证正在设置的信息，您应该在信封收件人发送之后但在尝试生成收件人签名URL之前对信封收件人执行GET请求。 您可以为此使用EnvelopeRecipients：列表 API。

查看您的问题，似乎是在发送信封之后但在创建签名URL之前正在更改收件人名称？ 如果是这种情况，那么您可能需要进行适当的信封更正以更新信封中的收件人信息，然后使用更新后的信息发出签名URL请求，并且该请求应该可以使用。

有关如何进行信封更正的信息，请参见envelopeViews：createCorrect API请求。

有关Embedded Signing API流程的一般信息，请参见Embedding DocuSign功能页面。