如何为组中的用户创建信封收件人

Question

我创建了一个与组相关联的信封，在创建时正确地向组中的用户发送电子邮件，他们可以通过该链接进行签名，因此该端的所有内容看起来都非常实用。

然而，目标是能够为组的用户提供一个门户来签署文档，因此我们需要能够使用API​​为组创建收件人视图。

使用此请求：

/restapi/v2/accounts/<accountnumber>/envelopes/<envelopeId>/views/recipient

使用标题：

X-DocuSign-Authentication : 

{"Username":"<userEmail>","Password":"<pw>","IntegratorKey":"<key>"}

请求正文：

{
  "authenticationMethod": "None",
  "email": "<email>",
  "returnUrl": "<httpsURL>",
  "userName": "<userName>",
}

失败

{
 "errorCode": "UNKNOWN_ENVELOPE_RECIPIENT",
 "message": "The recipient you have identified is not a valid recipient of the specified envelope."
}

通过大量的时间和故障排除，我意外地发现如果用户在标头中用于验证请求本身的用户是组的一部分，您将获得有效的URL结果，但是网址适用于无论您将哪个userName / email组合放入请求正文，该用户都是如此。

就好像docusign默认为发出请求的用户凭据，如果它在请求正文中找不到任何工作。哪个......看起来很奇怪？

如何通过API正确地为组创建docusign请求视图？

Answer 1

• 文档指出“如果使用userId并且未提供clientUserId，则userId必须与身份验证用户的用户ID匹配。”通过https://docs.docusign.com/esign/restapi/Envelopes/EnvelopeViews/createRecipient/

• 如果您尝试返回嵌入式签名网址，则需要包含有关特定收件人的信息，而不是将其概括为某个组。 DocuSign需要返回您指定的特定用户的签名URL。