DocuSign REST API:全部签名后检查信封状态

时间:2017-09-21 13:09:55

标签: rest docusignapi status envelope

供参考,请参阅:Check document status DocuSign

在我的案例中,答案的问题是:

If Envelope status = Completed, you can safely assume that each Recipient in the envelope workflow supplied all information that the Sender marked as Required

这是因为,在我的工作流程中,通过REST API脚本将信封发送给第一个收件人。第一个收件人签字。这会通过DocuSign模板设置触发自动电子邮件,以便反签名人员签名。

问题是,我的脚本每10分钟一直运行,一旦第一个收件人签名,信封的状态就会返回为“完成”,并将其记录在我们的本地数据库中。但如果上面引用的部分是正确的,那么当只有第一个人签字时,信封的状态不应该“完成”。

我能在我的脚本(ColdFusion)中做的是首先检查信封的状态。如果状态为“已完成”,请调用:

#Application.DocuSign_APIURL#/#Application.DocuSign_AccountID#/envelopes/#url.envelopeid#/recipients

然后找到第二个收件人的状态,以便在录制到我的数据库之前检查它是否也“完成” - 我认为可以这样做,但有没有比这更好的方法?我的剧本已经做了很多事情。

谢谢!

2 个答案:

答案 0 :(得分:1)

更好的方法是使用DocuSign WebHooks

这是一个很好的blog post,说明为什么你应该使用WebHooks而不是轮询DocuSign api来进行状态更新。

答案 1 :(得分:0)

事实证明,信封的状态确实不是completed'但是,在我的代码中有许多行,我抓住了收件人'状态以捕获任何错误的电子邮件,其状态为' autoresponded'。我的电话是:

#Application.DocuSign_APIURL#/#Application.DocuSign_AccountID#/envelopes/#url.envelopeid#/recipients

并且我正在查看收件人#1的状态 - 这将是' completed'这就是我在数据库中录制的内容。信封本身就在' sent'状态。所以mea culpa!

HTH。