DocusignAPI: UNKNOWN_RECIPIENT

Question

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

我的数据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 Nhu12)。我为信封1和信封2签名正态。

Envelope 1 is completed

但是当Co-Client也执行相同的操作时:将Signer2名称( Nguyen Nhu2更改为Nguyen Nhu22)。

我只为信封1和信封2签名get错误：

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

我隐约认为错误是因为我更改了Co-Client的名字(在信封1中签名)和Docusign在数据库中保存了Co-Client的新名称时，信封1和信封2中的CliendUserId相同。=> Error.But为什么客户端名称我也做同样的事情，它不是get错误。

希望大家能帮助我，谢谢！

Answer 1

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

• Recipient Name
• Recipient Email
• ClientUserId
• RecipientId

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

要验证所设置的信息，应该在信封收件人发送之后，但在尝试生成收件人签名URL之前，对信封收件人执行GET请求。为此，您可以使用EnvelopeRecipients: list应用编程接口。

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

有关如何进行信封修正的信息，请参阅envelopeViews: createCorrect接口请求。

有关嵌入式签名应用编程接口流程的一般信息，请参阅Embedding DocuSign功能页面。