Docusign

[Scott B]

Does anyone have experience integrating a web application (v11 or 12) with Docusign's Open API?

[Ted Giles]

Re: Docusign

Have you read their API instructions and help details?

[Scott B]

Re: Docusign

Hi Ted - I printed them out this morning and slowly going through them. There is definitely ample documentation. I was just curious what the experience has been (if any) of the Alpha community.

[Ted Giles]

Re: Docusign

Looks like you are the trail blazer!
Buckskin suit and a bum full of arrows then!

[coleresources]

Re: Docusign

Scott,

Did you manage to make any progress with this? I need docusign integration as well. Please let me know!

[Scott B]

Re: Docusign

Scott,

Did you manage to make any progress with this? I need docusign integration as well. Please let me know!

Not yet, but I recently resurrected this and have gotten closer. I plan on working on this a good deal over the nex next few weeks and will post an update. I may also record a video if I make a major breakthrough!

[coleresources]

Re: Docusign

Scott,

If you have a use case and code you want to share and collaborate on I will gladly work with you and share any breakthrough's I have. I need this asap. We might be able to knock it out quicker working it from two angles. Were you able to find documentation for xbasic that gave you a start in alpha? If you could share any documentation that'd be awesome!

[Scott B]

Re: Docusign

Hi Josh -

Sorry - been traveling for the last day and a half. I think collaborating on this one is a great idea. The most helpful documentation I've found to date is a demo on an example REST API integrating with SalesForce. If you do a search using these keywords, you should be able to find this.

[Scott B]

Re: Docusign

Hi Josh,

Were you able to get this to work? I've bee struggling with the following JS code which would request a signature on a DocuSign document. (I tried executing via a script in HTML as well as via on on click event on a button in a dialog component... no luck with either.) The problem for me may very well be in the "Install async and request packages", as I have no idea what that means or what I need to do.

// Request Signature on a Document (Node.js)

// To run this sample
// 1. Copy the file to your local machine and give .js extension (i.e. example.js)
// 2. Change "***" to appropriate values
// 3. Install async and request packages
// npm install async
// npm install request
// npm install fs
// 4. execute
// node example.js
//

var async = require("async"), // async module
request = require("request"), // request module
fs = require("fs"); // fs module

var email = "***", // your account email
password = "***", // your account password
integratorKey = "***", // your Integrator Key (found on the Preferences -> API page)
recipientName = "***", // recipient (signer) name
documentName = "***", // copy document with this name into same directory!
baseUrl = ""; // we will retrieve this through the Login call

async.waterfall(
[
/////////////////////////////////////////////////////////////////////////////////////
// Step 1: Login (used to retrieve your accountId and baseUrl)
/////////////////////////////////////////////////////////////////////////////////////
function(next) {
var url = "https://demo.docusign.net/restapi/v2/login_information";
var body = ""; // no request body for login api call

// set request url, method, body, and headers
var options = initializeRequest(url, "GET", body, email, password);

// send the request...
request(options, function(err, res, body) {
if(!parseResponseBody(err, res, body)) {
return;
}
baseUrl = JSON.parse(body).loginAccounts[0].baseUrl;
next(null); // call next function
});
},

/////////////////////////////////////////////////////////////////////////////////////
// Step 2: Request Signature on a PDF Document
/////////////////////////////////////////////////////////////////////////////////////
function(next) {
var url = baseUrl + "/envelopes";
// following request body will place 1 signature tab 100 pixels to the right and
// 100 pixels down from the top left of the document that you send in the request
var body = {
"recipients": {
"signers": [{
"email": email,
"name": recipientName,
"recipientId": 1,
"tabs": {
"signHereTabs": [{
"xPosition": "100",
"yPosition": "100",
"documentId": "1",
"pageNumber": "1"
}]
}
}]
},
"emailSubject": 'DocuSign API - Signature Request on Document Call',
"documents": [{
"name": documentName,
"documentId": 1,
}],
"status": "sent",
};

// set request url, method, body, and headers
var options = initializeRequest(url, "POST", body, email, password);

// change default Content-Type header from "application/json" to "multipart/form-data"
options.headers["Content-Type"] = "multipart/form-data";

// configure a multipart http request with JSON body and document bytes
options.multipart = [{
"Content-Type": "application/json",
"Content-Disposition": "form-data",
"body": JSON.stringify(body),
}, {
"Content-Type": "application/pdf",
'Content-Disposition': 'file; filename="' + documentName + '"; documentId=1',
"body": fs.readFileSync(documentName),
}
];

// send the request...
request(options, function(err, res, body) {
parseResponseBody(err, res, body);
});
} // end function
]);

//***********************************************************************************************
// --- HELPER FUNCTIONS ---
//***********************************************************************************************
function initializeRequest(url, method, body, email, password) {
var options = {
"method": method,
"uri": url,
"body": body,
"headers": {}
};
addRequestHeaders(options, email, password);
return options;
}

///////////////////////////////////////////////////////////////////////////////////////////////
function addRequestHeaders(options, email, password) {
// JSON formatted authentication header (XML format allowed as well)
dsAuthHeader = JSON.stringify({
"Username": email,
"Password": password,
"IntegratorKey": integratorKey // global
});
// DocuSign authorization header
options.headers["X-DocuSign-Authentication"] = dsAuthHeader;
}

///////////////////////////////////////////////////////////////////////////////////////////////
function parseResponseBody(err, res, body) {
console.log("\r\nAPI Call Result: \r\n", JSON.parse(body));
if( res.statusCode != 200 && res.statusCode != 201) { // success statuses
console.log("Error calling webservice, status is: ", res.statusCode);
console.log("\r\n", err);
return false;
}
return true;
}

[coleresources]

Re: Docusign

I have made some progress but not with xbasic. I have been working on .net wrappers that I am integrating into my AA apps and have one for my docusign requirement. I've spent enough time working in C# for this that I might be able to take a stab at it with xbasic. Give me until Friday and I'll post back with my results. I am also happy to provide assistance if you want to consider a .net wrapper for this. I am pretty excited about the way I've been leveraging .NET assemblies in my AA apps.

[nlk10010]

Re: Docusign

I have made some progress but not with xbasic. I have been working on .net wrappers that I am integrating into my AA apps and have one for my docusign requirement. I've spent enough time working in C# for this that I might be able to take a stab at it with xbasic. Give me until Friday and I'll post back with my results. I am also happy to provide assistance if you want to consider a .net wrapper for this. I am pretty excited about the way I've been leveraging .NET assemblies in my AA apps.

PMFJI, but I am struggling with the same general problem, but in my case I would like to interact with Intuit's REST API for QuickBooks online. I already have an application listed on their Apps.Com that utilizes C# (via an SDK they provide) but I'd LIKE to convert this to AA. Problem is I find that in trying to create wrappers around OAuth and other DLLs AA's support is just off (e.g. Date and CoClass support). I will keep poking, perhaps this latest version surreptitiously improved DotNet interfacing, and will watch this thread.