DocuSign-获得无效信封的原因[英] DocuSign - getting void envelope reason

本文是小编为大家收集整理的关于DocuSign-获得无效信封的原因的处理/解决方法,可以参考本文帮助大家快速定位并解决问题,中文翻译不准确的可切换到English标签页查看源文。

问题描述

How can I get the reason an envelope was voided thru the API? The envelope could be voided in multiple ways so it would be nice to know if it was voided because it expired as opposed to if the sender voided it. Can this be added to the envelope status object?

推荐答案

When you get status of an envelope through REST, voidedReason is one of the responses.

https://demo.docusign.net/restapi/v2/account/{accountId}/envelopes/{envelopeId}

status:"voided",
..
voidedDateTime:"2014-02-02T11:37:18.5500000Z",
voidedReason:"Envelope has expired."

When an envelope has expired, it will show: "Envelope has expired."

When someone declines or cancels an envelope, it will show the comments they entered in the text box upon voiding.

These responses given above do not show unless the envelope is in a voided status, so you'll want your request to only use this information is status is equal to 'voided'