Search code examples
docusignapienvelope

Re-sending documents when signer declines

Is it possible to re-send the envelope when signer has declined to sign it?

In my current application, need to include option to re-send the envelope based on the recipient/signer status. Also, in my case, there is a single recipient/signer in each envelope.

I am using RESTFul APIs. Functionality is working fine in case recipients having statuses - sent, delivered, autoresponded.

But when I try to re-send the envelope when recipient declined to sign it, I am getting this error: ENVELOPE_INVALID_STATUS: Invalid envelope status. Envelope status is not one of: Created, Sent, Delivered, Correct.

API used - /accounts/{accountId}/envelopes/{envelopeId}/recipients - PUT

Request JSON

{
 "signers": [
     {
        "email": "'.$email_rec['email_id'].'",
        "name": "'.$email_rec['name'].'",
        "recipientId": "1",
        "roleName": "Employee"
      }
    ]
}

Please let me know if I am missing something.

Solution

  • You cannot re-send an envelope once it has reached a terminal state: completed, declined, voided (either explicitly by sender or envelope expired).

    In this case, you may want to consider cloning the declined envelope and start the transaction over from the top of the workflow. If signer attachments were added to the declined envelope they will also exist in the clone, which may lead you to instead start from scratch/clean slate.