I am building an application in which the sender has the sender's view, and then he from the sender's view, adds recipients, message subject, documents and tabs and after that using our own application send button and save draft button, the envelope can be saved or sent.
If I just change the status to "send" using an api call, it won't work since the docusign server is not aware of the recipients and the documents the sender has entered, so, how do I create my own send button and save draft button for a view that is initially empty and the user enters everything manually?
Thanks.
I don't think want you want to do is feasible. i.e., unless/until the user clicks the "Save Draft" link within the Embedded Sender view, DocuSign will not persist (store) any of the changes the user has made to the Envelope(recipients, documents, email info, tabs, etc.).
Related
DocuSign the sender view Image
Details
No1.
Create an envelope with the following API.
https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopes/create/
At this time, include the following in the request body. This will invalidate any recipient edits that have already been set.
recipients.signers[0].templateRequired = 'true';
recipients.signers[0].templateLocked = 'true'.
No2.
Get the URL of the sender view of the envelope created in No1 with the following API.
https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createsender/
No3.
Access the sender view URL obtained in No2 by specifying the following in the query parameter This will enable the envelope destination edit action.
?showHeaderActions=true&showEditRecipients=true
At this time, the Add Recipients button is pressed from the Edit Recipients action on the Senders view screen of the DocuSign UI. By default, they are sequentially numbered. (See image)
Is there any way to prevent this added recipient order from being changed by changing the settings from the screen or by specifying options when creating a recipient?
I have read the documentation but have not found a good way to do this.
Recipients should not be able to change the routing order unless they are an Editor Recipient (who can change the envelope and everything about it)
If they are all signers or other recipients with no editing privileges, the routing order will respect what you have put in.
If you are looking to make a template and lock the routing order in the template, that is possible too.
But otherwise if there are no editor type recipients, the routing order will stay the same
I have an ASP.NET MVC application that's using the DocuSign REST API to create a draft envelope, then redirect to the DocuSign Sender view, for the user to then manually add the relevant tabs/fields for each recipient, to each document.
Is there any way when creating the envelope, to state that for a given recipient, at least one signature field needs to be added (within the sender view) to a given document; for another recipient, they must add both a signature and initials field/tab to a given document, and so on. The result being that unless those criteria are met within the sender view, i.e. the sender has not added those necessary tabs/fields, then the sender cannot send the envelope until they've been added?
Basically, we don't know where on any documents these tabs/fields need to be applied, so we leave it up to the sender to add them in the DocuSign sender view, but it would be nice if we can ensure the sender does actually add the necessary tabs/fields accordingly - preventing the envelope from being sent with documents that have missing fields.
Is this possible?
You can do this but it is tricky. Here's another way to look at solving the use case; what I think you're asking for:
Your application creates the envelope in draft format
Your application opens a sender view for the human to do their tagging of the document(s) for the recipient(s)
You want your application to now have the ability to check that the human did add a certain number of tabs for various recipients. If they did, then the envelope should continue on its way to the first recipient. Else, you want to have the human try again with the sender view, or abort the send, or make the alarms go off, etc.
Here's how you can do the above:
When your app creates the envelope in draft form, add an additional signer recipient, as an embedded signer. Something like
{email: "noone#example.com", name: "App check tabs step", clientUserId: "1", routingOrder: "1"}
All the real recipients will also need their routingOrder to be set, and to a number above 1.
After the human completes the sender view (where they hopefully added the tags correctly), the envelope will be set to sent status and it will start to be routed. But since the first recipient is the embedded signer, the envelope will wait for your application to handle that recipient (because it is an embedded recipient).
After the human completes the sender view, your application can then "check" the envelope to see if the tabs were added per your specification--your app will just need to get the envelope recipients/tabs and check to see if the tabs were created.
Next step if the tabs were added correctly: your application should obtain an EnvelopeLock, then delete the embedded recipient, then delete the EnvelopeLock. Once you do this, the envelope routing will resume with the next recipient, the first "real" recipient.
If the the tabs were NOT added correctly, then you can probably open an Editing View screen for the human to fix the tabs. Or you could void the envelope. (Then re-check the envelope's tabs and then remove the embedded signer when you're ready for the envelope to proceed.)
The above works fine. There is a downside that the certificate of completion will show that the envelope was "corrected" when the "application user" was deleted.
I am sending documents from Salesforce for Signature using DocuSign using Custom Button on the Custom Object record. I am capturing the recipients in the record and passing the details in CRL, CCRM, CCTM. Now i want to remove the feature to Add or delete or Edit the recipients that are showing in the Envelope just before send. Could any one subject what i could do to achieve this.
Thanks in-advance
Based on the documentation (http://www.docusign.com/sites/default/files/DocuSign_for_Salesforce_Administrator_Guide.pdf), I don't think it's possible to show the Envelope confirmation/review screen to the sender and NOT allow them to modify Recipients. The closest you could come would be to set OCO='Send' -- but that would result in the Envelope being sent immediately when the button is clicked (i.e., wouldn't display the Envelope confirmation/review screen at all) -- so your button code would need to supply all required Envelope information, and the sender wouldn't have the opportunity to review/change any of the information prior to the Envelope being sent.
We have a voting button in an email which works in the Client, is it possible to include a button in the email that would work for iNotes users?
The button is used to confirm that the email has been read and certain conditions understood.
Yes. Basically, what you want is for the user to click on a link that will run an agent on the server which executes the commands you have in the button in the Notes client directly on the server.
Can we "refresh" the document names in envelopes retroactively? We've already sent out our envelopes but need to change the document names inside of the completed/sent out envelopes. There is around a few hundred envelopes to update so updating each one individually will be problematic. The reason we need to do this is that we have a few different envelopes but when setting up the documents inside of the envelope the documents were setup with the same name so when we receive the Document through the API the documents had the same name so each document was overwriting the previous entry.
Sorry but I don't believe this is possible. Once an envelope has been sent and its status is "In-Process" the only aspects you can change are recipient(s), tab(s), and or custom fields (which are at the envelope level, not document level), and if it's in "Completed" status then there's nothing you can change about it.
So there's currently no way to change the document names of a sent envelope, and I'm not sure if there ever will be as that's like having someone sign something, then changing an aspect about that something that they signed underneath them.
With regards to what you CAN change once an envelope has been sent, you can edit the following recipient info:
email, userName, signerName, routingOrder, faxNumber, and deliveryMethod
And you can modify tabs for a given recipient as well. You can also modify any envelope custom fields you might have in the envelope. One final point I'll make, is that in our system a POST http request is always to add or create things, and a PUT http requests is for modifying existing envelopes - so whenever you are modifying a recipient, tab, or custom field make sure your requests are PUT requests.
References:
Modify or Correct and Resend Recipient Information
Modify Envelope Custom Fields for an Envelope
Modify Tabs for a Recipient