无法通过 REST API 取消 DocuSign 信封

Question

我正在尝试通过 REST API 调用取消“处理中”DocuSign 信封。我正在使用 changeStatus 方法来取消信封。我们在 StatusChangeRequest 对象中将状态设置为“voided”并将原因设置为“voidedReason”。

但是，在 REST API 调用后，信封不会作废。 Web 控制台中的状态保持为“进行中”。

有解决这个问题的帮助吗？

谢谢， 什里尼瓦斯

Answer 1

我刚刚取消了几个信封，没有任何问题，你一定是做错了什么。您提出请求时的返回码是什么，您收到的是 200 还是其他？我怀疑您的请求存在 4 个常见问题之一：

• 您将请求正文设置错误。
• 您正在执行 POST 请求而不是 PUT 请求。
• 您输入了错误的 URI。
• 您试图取消错误的信封。

void 请求的主体非常简单，让我们从它开始。我刚刚使用以下请求正文作废了所有信封：

{
    "status": "voided",
    "voidedReason": "Void Testing..."
}

接下来，请确保您正在执行 PUT 请求而不是 POST，这是一个常见错误，并确保您 PUT 使用正确的 URI （以下是DEMO环境）：

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

当然，请确保您使用的是当前处于“处理中”状态的有效信封Id，并在通话后检查正确的相应信封。有关 void 调用的更多信息，请参阅THIS LINK。