CODEWITHSUNDEEP
docusignapi
Dániel Somogyi
Dániel Somogyi

Reputation: 800

Cannot get combined envelope document with SBS signatures

I'm trying to query for the combined Envelope document (all envelopes and certificate as one PDF). For this I'd use the EnvelopeDocuments interface, specifically via get request. But that responds me with an Error I do not know how to interpret.

Usually I'd make a REST-request from Java, but to rule out most errors I'm using the docusign API Explorer:

After entering the parameters the API explorer gives the url /restapi/v2.1/accounts/7f[...]/envelopes/A5AAACA-[...]/documents/combined, but the request just returns a 400 with following data:

{
  "message" : "Bad Request",
  "response" : {
    "type": "Buffer",
    "data": [123, 34, ...]
  }
}

When I use certificate or some document-id instead of combined the api responds with the certificate or the document, as expected.

What am I doing wrong? And How do I interpret the response-data being a byte-buffer? Usually error responses should contain a code and a message, but not more?

EDIT:
Actually, making a custom rest-request instead of using the api explorer gave me more insight with a Proper error message:

{
  "errorCode": "COMBINED_PDF_DOWNLOAD_NOT_ALLOWED",
  "message": "Setting Enable Combined PDF Download for SBS envelopes is turned off"
}

So, apparently I can not download a combined PDF, as the envelope was signed with a Qualified Electronic Signature.

But can I turn on combined download somehow? I could not find anything in the settings.

Upvotes: 0

Views: 400

Answers (2)

Eduardo Silva
Eduardo Silva

Reputation: 1

Combined PDF Download is a feature that you need to enable with the DocuSign support, you need to submit a case on their portal at https://support.docusign.com and request to enable this feature.

Upvotes: 0

Larry K
Larry K

Reputation: 49104

By design, you can't download a "combined" documents and certificate of completion PDF when the documents include a standards-based signature (SBS).

SBS signatures are digital X.509 signatures. That type of signature, by itself, guarantees both the identity of the signer and the integrity of the signed document.

If DocuSign created a combined PDF that included the SBS-signed document, then that document's SBS signatures would no longer be valid: not good.

Recommendation

  1. Download the signed documents separately from the certificate of completion.
  2. The signed documents' signatures can be verified using any standards-based signature verification software (eg validator.docusign.com)
  3. The certificate of completion provides additional information on the documents' signatures.

Upvotes: 1

Related Questions