Docusign 接收者的观点答案

【问题标题】：Docusign Receipient's ViewDocusign 接收者的观点
【发布时间】：2021-08-19 17:50:06
【问题描述】：

在 GET Docusign Envelope Recipient 的查询参数中，GET 调用为“/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/combined?recipient_id=123&documents_by_userid=false”，是收件人ID，由docusign 生成的GUID 还是我们必须在信封创建调用中传递的ID？

【问题讨论】：

标签： docusignapi

【解决方案1】：

收件人 ID 是在信封创建调用中传递的 ID（除非您使用的是复合模板，这可能会导致您的收件人 ID 被折叠成 1、2、3...）。如果您不确定收件人 ID 是什么，请先调用 GetRecipients 并查找有问题的 RecipientId 参数。

通过执行 GET /envelopes/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/documents/combined?recipient_id=63189929，我能够获得合并文档的有限视图（仅显示收件人能够查看的文档）。我是从 Web 控制台发送出去的，所以我的收件人的 ID 是随机整数。

如果这不适合您，我建议您打开Support Case。如果您这样做，请附上您的信封 ID 和您尝试下载合并文档的 API log。

【讨论】：

【解决方案2】：

首先，关闭这不是我们所说的收件人视图。此调用用于下载实际信封及其文件。有一个不同的POST call 来生成收件人视图。至于 recipientId，它是您在创建信封时指定的，它不必是 GUID，它可以是“1”或您想要的任何值。

【讨论】：

是的，我们其实是想下载Recipient的版本/包的视图并保存，而不是仅仅生成一个视图，在所有的签名都完成之后。出于审计目的，我们会在收到签名完成通知后将带有签名的同一信封的各个版本保存回我们的数据中。
改写一下，下载收件人的实际完整信封版本。
只有以收件人身份进行身份验证才能执行此操作。作为发件人，您只能看到发件人的版本。
API Spec 没有这么说，只谈到了查询参数。所以我们认为这是可行的。这还能如何实现？我看到您提到的“POST”调用仅适用于“已发送”状态，而不适用于已完成的文档。 Docusign Connect 服务（管理员门户）中的通知事件是否在启用时捕获此内容？现在我们只捕获接收者事件。我可以进行任何其他 API 调用来获取收件人的完整文档吗？
您希望收件人完成的文档与发件人的完整文档有何不同？ DocuSign 系统的唯一区别在于审核跟踪，即谁查看了文档