Creating a Document with a DocuSign Template
Please note, our DocuSign Integration is still in a Beta stage. For more information please contact firstname.lastname@example.org
This Knowledge Base Article will cover in detail how to setup your first DocuSign Template, the DocuSign integration allows you to use either Workbooks PDFs or DocuSign Templates. If you are unsure of which Integration type to use we have documented the features of each method here.
This example will run through how to create a DocuSign Document in Workbooks that uses a Template that you can create within the DocuSign Portal.
Stage 1 - Creating a Template in DocuSign
Before configuring a document in Workbooks you will need to create a blank Template within DocuSign. To do this you will need to login to your DocuSign Account.
Once logged in select the Templates option from the toolbar at the top of the page.
This will show you any existing Templates within DocuSign as well as giving you the option to create new Templates by selecting the New button at the top of the toolbar on the left side of the Screen.
You will then be able to give your DocuSign Template a name, this is how it will appear in Workbooks when setting up Document within Workbooks. You can also provide a brief description of the Template. Finally you can provide an upload of your chosen Design to be used in the Template, these Documents can be hosted locally or uploaded from a number of file sharing sites.
Once you have set up the basics of the Template you will need to define the Recipients for this Envelope. In this example we will be requiring that the Person with the Primary Contact Relationship signs the Document so need to enter this into the Role Field. If you are going to have multiple Signers you can add multiple Roles to the Template and change what is required from them at this stage.
Once you have made all of the changes be sure to save the Template, otherwise it will not be available within Workbooks.
Note: It is important to ensure that no DocuSign tabs are added at this point. There are some additional steps required in Workbooks prior to doing this.
Stage 2 - Set up the Template in Workbooks
You will now need to return to Workbooks to configure the synchronisation between the Fields in Workbooks and DocuSign. The DocuSign Menu can be accessed from Start > Configuration > Email & Integration then select New Document.
Step 1 - Introduction
You will need to work through the Settings configuring to them to your DocuSign Template as required.
Document Name: A unique name of the document configuration. We recommend that this is something that includes the function of the Document so it can be easily identified later. The record type that you choose below, will be automatically added to the name.
Note: This will be required later on in the installation so be sure to make a note of it.
Record Type: A Picklist of all available record types that the integration can be used with.
Integration Type: Here you will need to select DocuSign Template. This will trigger the creation of the following Field.
DocuSign Template: From this Picklist select the Template which you wish to use for this Document
DocuSign Notifications: DocuSign records an event when something happens with your document. This event is then pushed to Workbooks and the record updated a new status. By default the “Document Signed” option will be checked, however we recommend that all available options are selected for maximum visibility of your document progress in Workbooks.
Note: You will receive these Notifications in line with your Workbooks Notification settings.
Create/Update Workbooks Fields in DocuSign: Turning this setting on will create a field in DocuSign and map it to every Field on the Record in Workbooks. We advise that this setting is used with caution as Fields only 100 Fields can be created an hour across all Record types in DocuSign so Customers with a large number of Fields may have to wait some time until all of their Fields are created in DocuSign.
Would you like to exclude any of these fields from DocuSign: A Multi-Select Picklist that allows you to exclude any number of Fields from being sent to DocuSign, this is especially useful for Customers that only want to sync a small number of Fields to DocuSign.
Store DocuSign Certificate of Completion: Choose whether you want DocuSign to send an additional file when a document is signed, which details an audited timestamp breakdown of all of the actions against that Document. This file is stored on the Files tab in Workbooks against the record.
Invoice Specific Fields
If in the Record Type Field you selected Invoice additional Fields become available for you to further customise the behaviour of the Document.
DocuSign Payments: It is possible for payment to be taken for invoices through DocuSign itself. Turning this setting On provide recipients with the option to make the payment specified in the Document. More information on this can be found on our Knowledge Base
Which role should complete Payment in DocuSign?: Select the Relationship that the Person making the Payment will have with the Invoice Record, this may be the Primary Contact or you may have a specific Finance Contact.
Payment Gateways: Select the Payment Gateway that you would like the recipient to use. Payment Gateways need to be configured within your DocuSign Account in order to appear here, DocuSign allows Payments through Stripe, Authorize.net and Paypal (via Braintree).
Note: You will require a specific DocuSign Licence in order to use DocuSign Payments. For more information please contact Support@workbooks.com.
Signer/CC Recipient Setup
Which relationship roles should be used as Signers?: A document can be sent to one or more people at the same time. Select the Relationship types that the integration should look for when sending a document. This will only show People Relationships as the Signer must be a Person related to the Transaction Document. If a Person with the selected relationship is not added to your document, then you will not be able to send a document for signature, additionally if a Person is related to the Document by a relationship that is not selected then they will not receive the Document for signature.
Allow Contacts as CC Recipients in DocuSign: When this setting is enabled another multiselect will be shown, allowing you to add additional People to the Email as a CC by specifying the Relationship that they will need with the Document.
DocuSign Interactive Send Mode: By default, this is set to On. When sending a document for signature, Interactive Send Mode will allow the User to preview/change what the Document will look like to the end user. If this setting is turned off, the document will be sent straight away, without allowing the user to preview/change anything first. It is not advised that this setting is ever turned off except for a few specific circumstances.
Enable DRAFT document sending: By default, this setting is set to Off. DocuSign Documents cannot be sent from a DRAFT Transaction Document (DQTE, DINV, DORD, DSOR and DCON). If you would like to override this feature and allow your users to send out DRAFT documents (not recommended), then select On in this picklist.
Enable Multiple Send: Be default, this setting is set to Off. Enabling this feature will allow you to send out a document for signature again, regardless of whether it has already been signed. This setting is useful in some scenarios such as an Approvals process where you may wish to send an internal document before sending out a copy to the customer. Please see our forum post on this topic. Other than this, we recommend that this feature is switched off.
Step 2 - Complete
The DocuSign Document is ready to be generated and will now need to be added to the appropriate Form Layouts via a Button Process. This is documented fully in Knowledge Base
Once this has been completed you will now be able to add the required fields on to your DocuSign Template within the DocuSign Portal
Stage 3 - Configuring DocuSign Fields
You will need to log back in to your DocuSign account and select the Template that you have configured within Workbooks and Select the Edit Button.
Once this has been selected you can make any final amendments to the Template, however if these are made you will need to repeat Step 2 in order for these to take affect. When you are happy with your Template you can now use the Next Button to generate the Template with the ability to add the DocuSign Fields.
From this page you are able to add Standard DocuSign Fields to the Template, using the Picklist at the top of the left hand column to dictate which Document Role they refer to:
Once your Workbooks Fields have synced you will be able to access all of the Fields you synced to DocuSign from Workbooks in the Custom Field Menu:
Note: Fields may not be immediately available as the Process runs once an hour and is limited to created 100 Fields each hour, we do not recommend that the frequency is changed or the process is forced due to the API Limit.
Once you have configured the Fields the Record can be saved and is ready to send. Due to the limitation in Field creation we recommend that you set up all of your DocuSign Templates at the same time in Workbooks so that they can be queued overnight and available the following day across all required Records.