由于收件人锁定，通过 docusign API 向收件人重新发送信封答案

【问题标题】：Resend envelope to recipient through docusign API blocked due to locked recipient由于收件人锁定，通过 docusign API 向收件人重新发送信封
【发布时间】：2016-01-11 18:17:32
【问题描述】：

在我们的应用中，我们有一种方法让用户生成文档信封，然后通过状态跟踪这些信封并通过一系列收件人进行签名。

我在界面中添加了重新发送文档的功能。通过 API 使用 XML 我认为我正确地请求将信封重新发送给处于“已交付”状态的收件人（这意味着他们已发送文档但我认为尚未签名）。我在这里遵循了这些概念：Resend DocuSign Emails

但是很遗憾，我在发送文档的重新发送请求时收到错误消息：

错误代码：RECIPIENTS_LOCKED

消息：收件人已锁定，无法修改。

我返回模板并查找可能会锁定收件人更改的选项（即使实际上没有进行任何更改），但只能在收件人和收件人中找到“发件人无法添加、编辑、删除收件人”选项模板的路由部分。取消选中此选项并没有解决问题，我在尝试重新发送文档时仍然遇到同样的错误。

是否有其他方法可以解锁信封的收件人，从而允许我使用 API 向他们重新发送文档？

编辑

端点网址：https://na2.docusign.net/restapi/v2/accounts/[accountId]/envelopes/[envelopeId]/recipients?resend_envelope=true

请求正文：

string requestBody = "<recipients xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://www.docusign.com/restapi\">" +
            "<signers><signer>" +
                "<recipientId>" + recipientId.ToString() + "</recipientId>" +
                "<name>" + recipientName + "</name>" +
                "<email>" + recipientEmail + "</email>" +
            "</signer></signers></recipients>";

【问题讨论】：

您能分享您尝试访问的 URL/端点以及请求正文吗？
添加端点和请求正文，谢谢。
如果您实际上是在修改 API 调用中提供的收件人信息（名称更改？），我认为您会看到这样的消息。我认为这些是远程签名者，因为您使用的是 DocuSign 电子邮件。作为一项额外的故障排除练习，您能否对信封//lock 端点进行获取？是否应用了任何锁？
嗯可能正在尝试更改名称，但我只是从 Get Recipients 调用中获取 ID、名称和电子邮件并将其传递回重新发送 POST 调用，所以我认为它会保持不变但我会在那里做一些调查以确保。当我将 XML 反序列化为 POST 调用的输入时，这些值可能会发生变化。
锁定检查导致：EDIT_LOCK_ENVELOPE_NOT_LOCK - 信封未锁定。所以这似乎不是问题。

标签： xml asp.net-mvc docusignapi

【解决方案1】：

对此进行了更多挖掘，并能够在以下条件下重现此行为：

如果您从模板创建信封并在 createEnvelope 请求中指定 recipientsLock=true，并且执行正确的重新发送，则必须指定在模板上定义的有效收件人 ID。请确保您使用的是 GET 中的收件人 ID 值，而不是收件人 IDGuid 或用户 ID。

关于创建模板 w/recipientsLock 的 API 信息： https://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Post%20Template.htm?Highlight=recipientslock

【讨论】：

Luis，感谢您继续为我调查此事。收件人锁定是否已在 DocuSign 管理面板的模板上设置？也许那是“发件人无法添加、编辑、删除收件人”选项现在未选中，但仍然是更改之前创建的先前信封的一个因素？我在创建信封时查看了用于嵌入式发送的代码，但没有看到在任何地方设置了 recipientsLock 属性。
如果您在模板上设置了“发件人无法添加、编辑、删除收件人”复选框，则与recipientsLock=true 相同。管理模板时有几个复选框，因此请确保您未选中正确的复选框。
这是否意味着我无法重新发送模板选中时创建的信封，但它应该适用于使用未选中模板创建的新信封？我已经确认我在尝试重新发送时直接从 GET 使用了收件人 ID、姓名和电子邮件。
老实说，从我所做的测试来看，即使设置了 recipientsLock=true，我仍然能够执行电子邮件重新发送。只有在我为收件人指定了不正确的收件人 ID 时，我才会收到错误消息。完整性检查 - 请确保您在信封上指定的收件人仍在“处理中”且尚未完成签名。
终于有了一个在模板中创建新的实时信封的示例，该选项未选中，它允许我重新发送没有问题。谢谢。