由于锁定的收件人而被阻止的docusign API会将信封重新发送给收件人

时间:2016-01-11 18:17:32

标签: xml asp.net-mvc docusignapi

在我们的应用程序中,我们为用户提供了一种生成docusign信封的方法,然后通过状态跟踪并通过一系列收件人进行签名。

我添加了一项功能,可以在我们的界面中重新发送文档。通过API使用XML我认为我正在请求将信封重新发送给处于“已交付”状态的收件人(意味着他们已经发送了文档但我还没有签名)。我按照这里的概念:Resend DocuSign Emails

但是,我很遗憾在发送文档的重发请求时收到错误:

ErrorCode: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>";

1 个答案:

答案 0 :(得分:3)

在这个问题上进行了一些挖掘并且能够在以下条件下重现此行为:

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

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