DocuSign 嵌入式签名在第三步获得 UNKNOWN_ENVELOPE_RECIPIENT

Question

我是 DocuSign 的新手，并尝试使用本地文档而不是模板的嵌入式签名。我正在使用 PHP 和沙盒开发人员帐户。我能够成功协商第一部分（登录 API）和第二部分（创建和发送信封），但第三部分（请求签名 URL）失败并出现 UNKNOWN_ENVELOPE_RECIPIENT 错误代码。

我使用的代码如下所示（敏感信息已编辑）：

    $integratorKey   = "XXX-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
    $accountEmail    = "daryl@xxxxx.com"; 
    $accountPassword = "xxxxxxxxxxx"; 
    $recipientName   = "Recipient Name"; 
    $recipientEmail  = "recipient@xxxxxxxx.com";
    $documentName    = "DocumentName.pdf";
    $clientUserId    = "1234";

    // Construct the authentication header:
    $header = "<DocuSignCredentials><Username>" . $accountEmail . "</Username><Password>" . $accountPassword . "</Password><IntegratorKey>" . $integratorKey . "</IntegratorKey></DocuSignCredentials>";

    // Skipping code for parts one and two as they work fine.

    // By this point I have the value of EnvelopId in $envelopeId

    // STEP 3 - Get the Embedded Singing View
    $data = array(
    "returnUrl" => "http://unform.com/",
    "authenticationMethod" => "None",
    "email" => $accountEmail,
    "userName" => $recipientName,
    "clientUserId" => $clientUserId
  );

  $data_string = json_encode($data);

  $curl = curl_init($baseUrl . "/envelopes/$envelopeId/views/recipient" );
  curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($curl, CURLOPT_POST, true);
  curl_setopt($curl, CURLOPT_POSTFIELDS, $data_string);
  curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($data_string),
    "X-DocuSign-Authentication: $header" )
  );

  $json_response = curl_exec($curl);
  $status = curl_getinfo($curl, CURLINFO_HTTP_CODE);

在这些调用之后，$status = 400 我得到的完整的 $json_response 是：

{ "errorCode": "UNKNOWN_ENVELOPE_RECIPIENT", "message": "您识别的收件人不是指定信封的有效收件人。" }

我确实定义了 clientUserId，并且 $recipientName 与步骤 2 中签名者数组中使用的相同，但是字段名称不同，即步骤 2 的签名者数组中的“name”=>“$recipientName”和“ userName" => 第 3 步中的 $recipientName。

为了完整起见，这里是第二步中使用的数据数组：

  $data = array(
    "accountId" => $accountId,
    "emailSubject" => "DocuSign API Sample - Please Sign This Document!",
    "documents" => array(
      array(
        "documentId" => "1",
        "name" => "$documentName"
      ),
    ),
    "recipients" => array(
      "signers" => array(
        array(
          "email" => "$accountEmail",
          "name" => "$recipientName",
          "recipientId" => "1",
          "tabs" => array(
            "signHereTabs" => array(
              array(
                "xPosition" => "100",
                "yPosition" => "150",
                "documentId" => "1",
                "pageNumber" => "1"
              )
            )
          ),
          "routingOrder" =>  "1",
          "recipientId" =>  "1",
          "clientUserId" =>  $clientUserId,
          "name" =>  "Daryl Williams",
          "email" =>  "daryl@weblane.com"
        ),
      ),
    ),
    "status" => "sent"
  );

任何帮助将不胜感激。如果我可以提供任何进一步的细节，请告诉我。

谢谢，

达里尔

Answer 1

看起来您在第二个请求中包含了两次收件人姓名和收件人电子邮件，我怀疑这是问题所在。如果您查看创建信封的代码，则每个都有两个副本：

array(
      "email" => "$accountEmail",
      "name" => "$recipientName",
      "recipientId" => "1",
      "tabs" => array(
        "signHereTabs" => array(
          array(
            "xPosition" => "100",
            "yPosition" => "150",
            "documentId" => "1",
            "pageNumber" => "1"
          )
        )
      ),
      "routingOrder" =>  "1",
      "recipientId" =>  "1",
      "clientUserId" =>  $clientUserId,
      "name" =>  "Daryl Williams",
      "email" =>  "daryl@weblane.com"
    ),

尝试删除底部多余的电子邮件和姓名，然后确保您使用您提供的第一组收件人姓名和电子邮件请求签名 URL，这可能会解决它。您还可以在创建信封后调用 GET Recipient info 来验证正在设置的确切信息。

Answer 2

感谢您的回复。我不仅包含了两次收件人姓名和电子邮件，而且我还为收件人电子邮件设置了两个不同的值，一次是帐户电子邮件，后来是收件人电子邮件。我的困惑是字段：“名称”和“电子邮件”指的是开发帐户还是收件人。当然，我应该已经弄清楚了，因为这两个字段都属于 signers 元素。无论如何，它现在正在工作，我现在明白“姓名”和“电子邮件”字段是指收件人。谢谢你的帮助。对于任何对此感兴趣的人，这里是我现在使用的代码示例：

   "recipients" => array(
      "signers" => array(
        array(
          "name"  => "$recipientName",
          "email" =>  $recipientEmail,
          "routingOrder" =>  "1",
          "recipientId"  =>  "1",
          "clientUserId" =>  $clientUserId,
          "tabs" => array(
            "signHereTabs" => array(
              array(
                "xPosition" => "100",
                "yPosition" => "150",
                "documentId" => "1",
                "pageNumber" => "1"
              )
            )
          ),
        ),
      ),
    ),