Question

我想使用基于SOAP的API调用为嵌入式/强制收件人创建信封，并生成一个令牌，收件人可以在创建后立即对其进行签名。我已按照您的文档但无法为嵌入式签名者创建令牌。我能够创建一个信封，但在创建令牌时，我收到一个错误＆＃34;无效的签名凭证＆＃34;。

根据您的文档，在创建包含捕获收件人的信封时，我需要为收件人传递clientuserid。我每次都需要为同一个收件人使用相同的clientuserid。看起来，我可能之前创建了一个带有俘虏收件人的信封，但我没有使用正确的组合..收件人姓名，电子邮件地址和clientuserid每次我创建一个带有俘虏收件人的信封。

1）有没有办法将clientuserid重新分配给收件人？

2）有没有办法检索收件人的clientuserid？

3）在DocuSign帐户中，我们如何检查是否已使用专属收件人创建信封？

4）我们是否必须通过DocuSign帐户启用任何设置来创建包含专属收件人的信封？

Answer 1

1）您可以使用“收件人更正”调用来更新给定收件人的clientUserId，但如果这不起作用，您可以随时从信封中删除收件人，然后重新添加为嵌入式收件人

2）要检索收件人的clientUserId值和其他信息，您需要进行以下API调用：

获取信封收件人状态

URI：

/accounts/{accountId}/envelopes/{envelopeId}/recipients

方法：

GET

示例回复：

{
  "recipientCount":"String content",
  "signers":[{
    "deliveredDateTime": "String content",
    "recipientAuthenticationStatus":{
      "(authentication status result)":
        "eventTimestamp":"String content"
        "status":"String content"
      }
    },
    "recipientId": "String content",
    "clientUserId": "String content",    
    "requireIdLookup": "String content",
    "roleName":"String content",
    "routingOrder": "String content",
    "signedDateTime": "String content",
    "status": "String content",
    "email": "String content",
    "name": "String content"  }]
  }]
}

3）我不确定您是否可以通过DocuSign控制台进行检查，上述API调用将指示给定的收件人是否被俘。如果定义了clientUserId值，则嵌入它们 - 否则它们是远程签名者。

4）是的，这是您的API集成需要包含在其帐户计划中的功能。请与您的DocuSign客户经理联系以获取更多信息。

DocuSign API - 嵌入式收件人

1 个答案: