Using web input to build conditional Docusign response - docusignapi

I'm only mildly technical and not the web lead for my company, but I am the membership lead and I'm hoping to use your API for my workflow. This is what I need:
A web form on our website that asks for Name, e-mail, age, and a drop-down box of predetermined locations.
Using the above, I'd like the age to decide whether the requestor receives the Over 18 or Under 18 version of my form. Then I'd like the name to be auto-filled into the correct form. I'd like the form to be then e-mailed to them for a signature, and I'd like the signed, returned form to not only come to my primary e-mail address, but also to use the location to send a carbon copy to their local representative.
Can it be done? Thank you all for your help!

Yes you can use DocuSign to easily achieve the workflow you've stated. There's probably several ways you can implement this, I'll focus on the first that comes to my mind which is using DocuSign Templates.
Using Templates you can upload documents into your DocuSign account at design time, add workflow, tabs, routing, etc, then at run-time your app can reference these templates and match specific recipients to placeholder roles configured in the template.
For example, your flow would be:
Create 2 templates in your DocuSign account, one for 18+ case and one for Under 18 (note: you have unlimited templates in your account).
Add a Carbon Copy recipient as the second recipient for each template, make sure to give a routing order = 2 by setting the signing order.
Once your web form receives all input data from the user (ie Name, email, age, and location) use the Envelopes: create API to create an envelope with the form data populated in various tabs.
By default, once they are done signing the platform will email them a copy of the signed document (you can control this through account settings).
The Carbon Copy recipient will also receive a copy of the signed document once signing is complete, you can store a static email in the template or provide new recipient information at run-time when making the API request.
For more info see the DocuSign Developer Center. I also recommend you have a look at the Tabs section and Templates section for some highly useful information.

Related

Can I implement an e-signature-only of a PDF provided by the calling application with Docusign?

My use case only requires Docusign for e-signature of pre-filled PDF forms.
The PDF forms will be generated on our application side where some fields will be automatically filled (using xPressions) and the user will fill in the remaining blank fields.
The use case:
In our web application the user is presented with a task/action.
After invoking the task the user is presented with a PDF form.
The user fills in the blank fields of the PDF form and closes it.
The user is then invited to e-sign the document.
The web applications initiates a session with Docusign and transfers the PDF document to Docusign.
The web application hands control over to Docusign (in an IFrame) where the user can add a signature to the document.
Docusign hands control back to the web application.
The user task is complete.
The web application retrieves the e-signed document.
End
In this use case we don't have a need for Docusign templates or powerforms as the PDF generation solution already exists. This existing PDF generation solution is quite complex and it would not feasible or cost effective re-implement within the Docusign solution.
My question, is the above, e-signature-only, use case feasible within the docusign solution?
You will want to use "embedded signing" to keep the entire flow within your web app. This is accomplished by specifying a "captive recipient" as the signer. In addition to name and email address, you will specify a "clientUserId" for the signer. This should be specific and unique to the actual signer, e.g. a "customer ID", employee ID, etc. In a pinch, you can use the email address.
See (https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/embedding/).
You can use this API endpoint to create an envelope by passing your pdf.
See guide and section "Attaching documents to an envelope"

Is the Docusign API object library exposed?

I am working with existing Word documents that are currently updated in a mail merge. I would like to be able to (on the high-level) just be able to convert these documents in run-time to a Docusign template with signable fields and automatically send them (without having to upload documents to the Docusign site, etc., etc;). I don't want to change our current workflow, just add a "behind-the-scenes" step that automatically creates and sends the DocuSign envelope(s) to the specified signer. The users won't be signing into Word or DocuSign, they'll be literally clicking a "Generate and Send Document" button. Is the Docusign API object exposed in a way that makes this possible?
Chris Fleetwood
Software Developer
N.C. Partnership for Children, Inc.
cfleetwood#smartstart.org
One way you can do that is using the DocuSign Connector for Flow and PowerApps.
This does require you to have an account with Microsoft and potentially pay them extra (I'm not sure about that part, you would have to check with them) but it seems to have the functionality you need, without having to write any code.
DocuSign also has a Word Add-In that does support templates, but only through the template-match feature. If the document you are authoring looks like a document stored in your DocuSign account inside a template - you can use this template form Word with one-click.

How to Switch Docusign Branding Dynamically through C# API for Powerforms

Team,
I have many documents multiple companies on single docusign prod account.
I need to use multiple logo as per different-different company logo for powerforms.
I want to switch branding dynamically as per company, so that when my code detects a company, I must be able to set branding as per selected company ; so that whenever email is sent, company logo is sent with email.
I am using c# APIsc for docusign.
Your help is really appreciable in advance.
Yes you can accomplish this with DocuSign, you just need to create the multiple brand profiles you want to use in your account, then specify which brand you want to use each time you create an envelope.
To specify which brand to use for a given envelope, there is a brandId property that's part of the envelopeDefinition that you can configure. To get a list of valid brand GUIDs from your account you can make the GET Brand Profile Information API call.

Can we customize email content at runtime

I have looked at several PDF uploaded on docusign website but didn't get success at all. My problem is I want to create a generic email template in my docusign account but want to update its uncommon(client specific) content dynamically using the Docusign Web-service API.
For example: Client Name, Client Address, Phone Number, Mobile number, Payment Amount, and Payment Last date are some fields whose values varies based on client whereas other content of the email is common for all, Hence I want to understand that is there any way so that I can set the values for this fields in WS call and docusign will use that common email template and replace the customized fields on the fly for every client.
We Will make one WS call for one client at a time. Please help it is quite crucial for us.
Currently we are creating email content to our side and set into the EmailBlur but want to do it more customized so in future we can make changes easily.
Quick response is highly appreciate!
Thanks in Advance !!
It's not possible to create/maintain an "email template" in DocuSign that contains placeholder variables for you to dynamically inject client-specific values into the email for each Envelope as part of the Create Envelope request.
To acheive your scenario, you'll need to create/maintain the email template contents within your application, and have your application dynamically generate the email contents for each Envelope. Then you can simply set the Envelope's emailBlurb property (in the Create Envelope request) to the contents (i.e., full email body) that your application generated.
It is Account related setting which needs to be enable by docusign, In my case I have contacted them and they made some changes after which the emailblurb method start supporting HTML.

How to use Docusign API to get one link for multiple signatures

Hello Docusign Team Member,
Currently we are using the docusign for e-signatures and it is working very well. However, we need to integrate to with our internal project management tool called as AtTask.
AtTask has its own approval process, all I need from docusign is a link which managers can click into while being asked for signatures.
To briefly explain the process:
We have these set of documents, which is first being approved by the procurement manager, then it automatically goes to the Project director, When he signs it, it automatically goes to the Assistant Director, when he signs it, it gets routed back to the project admin that initiated the process.
Now, my question is, how can I create this process on docusign and get one link that I can use in our PM tool..? I was seeing that one possible way to do it is by using your API feature.. Could you please help me with that..?
Your help is very much appreciated.
There are a couple of ways you could set up your desired workflow however please note that you will not be able to do all of this with just one link. You'll either need to generate a unique URL for each recipient, or you can use email to initiate the requests. Both are very easy to setup.
In the DocuSign system there are two general methods for initiating your signature requests-
1. Email Delivery
2. Embedding Feature
I'll briefly describe each but for a good explanation of the differences please see this page from the DocuSign Developer Center
http://www.docusign.com/developer-center/explore/features/embedding-docusign
When you setup signature requests through the DocuSign Console they are sent using the first method- Email - and the recipients are known as "remote" recipients. This means that each recipient receives an email when it's their turn to sign, and they start the signing workflow by clicking the link in the email request.
You can add as many recipients you want to the envelope and using the Routing Order property you can control the order that each recipient signs the documents. If two recipients have routing order 1 and 2, for example, then the second recipient can not sign until the first recipient is done signing. If they have the same routing order, then they can sign at the same time.
With the second method - Embedding - your recipients are known as "captive" or "embedded" recipients, and they will start the signing process directly by clicking on a hyperlink (i.e. instead of waiting for an email and clicking from there they can access it immediately). This is done by generating a URL token. For more info on how to create URL tokens for your recipients please see the above link to Dev Center.
You can intermix your recipients on a given envelope, meaning you can have embedded and remote recipients in the same envelope, so if you want you could make your Procurement Manager an embedded recipient (so that they start signing by opening a URL) and then all the remaining recipients remote recipients so that once the procurement manager signs the system then automatically emails the next manager for their signature, and so on. Or if you don't want to ever wait for any emails then you could make each recipient an embedded one, but they will still have to at least click a link (or have one automatically opened for them) to start their signing workflow.
The two best resources for this are the above link, which I'm referencing here again, and the API Walkthroughs. The last three walkthroughs all focus on Embedding DocuSign...
DocuSign Embedding Feature
DocuSign API Walkthroughs

Resources