Docusign

Table of Contents:

Basic Docusign Workflow

E-signing a document with Docusign generally requires three major steps:

1. Creating an envelope containing documents, recipient information, and sign field locations (performed by Quik!)

2. Calling Docusign for the status of the envelope (performed by Customer)

3. Downloading, processing, archiving, and/or submitting the signed document (performed by Customer)

The first step requires significant processing and set-up including:

• Creating a flattened, read-only PDF with form data

• Tagging the form with signature fields with location and role data in XML

• Setting up recipients to sign and receive forms, including attributes including:

  • Signing order

  • Recipient email addresses

  • Security settings for identity checks

• Initiating the e-sign process with Docusign

Due to the complexity of the document, fields, roles, recipients and more, the process to generate the necessary data and final document to send Docusign must be performed by a Quik! server. To enable this architecture, Quik! provides web service methods that give customers various methods to perform this first step.

The second and third step, to poll for status and download the final document, is the responsibility of the user interface, workflow and archive system that the customer is using. Since Quik! does not provide or manage the user experience beyond filling out the form and kicking off the e-sign process, the customer must call the Docusign API directly using the EnvelopeID to get the status of the envelope and to download the final document for archival and workflow purposes.

Using Docusign in Quik! 

Important: All customers and partners must have a valid Docusign account in order to use Quik! with Docusign (Quik! is not a re-seller of Docusign).

All Quik! HTML forms are designed for seamless e-signature integration with Docusign. While there are three implementation models to integrate Docusign with Quik!, the user experience of all three begin with the user clicking the "SIGN" button on the form viewer to start the e-sign process. The form will display an pop-up window (called the e-sign pop-up) that asks for signer information required by Docusign (called "envelope information") including signer name, email, authentication type, etc. The user will complete the data fields and click SEND. Depending on the integration method used, this event will then send the form data to either Quik! servers or customer servers to process and create the envelope with Docusign so that signers can begin e-signing the form.

Please review the technical requirements below for integrating Quik! with Docusign regardless of the implementation model used.

Create an OAuth Token with Docusign

To streamline the process of signing documents, the Quik! Master Account must be set up with an OAuth token for the user/customer's Docusign account. Next, users can create Docusign tokens within the Quik! App.

Visit this page for detailed instructions: Docusign Authentication (Create OAuth Tokens)

Configuring Docusign Properties for Form Generation

Once a token is established, customers must include the following properties in their Execute request when generating HTML forms:

1. ESignTypeDocusign: Establishes Docusign as the e-signature service to be used

2. AuthUserID: Indicates which OAuth token will be used.

   1. This comes from the Connection Name that was established upon token generation within the Quik! App

   2. This is also known as CustomerUserID from the results when calling: GET /docusign/oathtokens

3. SignEnvironmentID: Indicates which Docusign environment will be used, see Docusign environment table below

4. SignCallBackURL or SignURL: Indicates which implementation model will be used

5. QuikFormID: Indicates which forms will be generated, always required in any Execute request

6. Any other Docusign settings (optional - see a complete list of Docusign properties here)

Docusign Environments:

Sample REST Execute request

Lastly, it is important to understand which forms can be e-signed in Quik!. See Enable E-Signatures on Forms for more information on e-signability settings.

Now you are ready to build a Docusign integration. See the following sections on using one of the three implementation models.