React Native

DocuSign Add Documents to a Draft Envelope

See more DocuSign Examples

Demonstrates how to add one or more additional documents to a DocuSign draft envelope. React Native

import { BinData, Http, HttpResponse, JsonObject, StringBuilder } from '@chilkat/react-native'

async function chilkatExample() {
  // This example assumes the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  const http = new Http();

  // Load a previously obtained OAuth2 access token.
  const jsonToken = new JsonObject();
  try {
    jsonToken.loadFile('qa_data/tokens/docusign.json');
  } catch {
    console.log(jsonToken.lastErrorText);
    return;
  }

  // Adds the "Authorization: Bearer eyJ0eXAi.....UE8Kl_V8KroQ" header.
  http.authToken = jsonToken.stringOf('access_token');

  // Send the following request.
  // Make sure to use your own account ID (obtained from Get Docusign User Account Information)

  // PUT https://demo.docusign.net/restapi/v2.1/accounts/<account ID>/envelopes/<envelope ID>/documents HTTP/1.1
  // Expect: 100-continue
  // Accept: application/json
  // Cache-Control: no-cache
  // Authorization: Bearer eyJ0eX...
  // Content-Length: ...
  // Content-Type: application/json
  // 
  // {
  // 	"documents": [
  // 		{
  // 		"documentId": "1",
  // 		"name": "hello.pdf",
  // 		"pages": "1",
  // 		"documentBase64": "<insert base64 content here>"
  // 		},
  // 		{
  // 		"documentId": "2",
  // 		"name": "hello2.pdf",
  // 		"pages": "1",
  // 		"documentBase64": "<insert base64 content here>"
  // 		}
  // 	]
  // }

  const bd1 = new BinData();
  bd1.loadFile('qa_data/pdf/hello.pdf');
  const bd2 = new BinData();
  bd2.loadFile('qa_data/pdf/hello2.pdf');

  const json = new JsonObject();
  let i = 0;
  json.i = i;
  json.updateString('documents[i].documentId', '1');
  json.updateString('documents[i].name', 'hello.pdf');
  json.updateString('documents[i].pages', '1');
  json.updateString('documents[i].documentBase64', bd1.getEncoded('base64'));
  i++;
  json.i = i;
  json.updateString('documents[i].documentId', '2');
  json.updateString('documents[i].name', 'hello2.pdf');
  json.updateString('documents[i].pages', '1');
  json.updateString('documents[i].documentBase64', bd2.getEncoded('base64'));

  const sbJson = new StringBuilder();
  json.emitCompact = false;
  json.emitSb(sbJson);

  http.setRequestHeader('Expect', '100-continue');
  http.setRequestHeader('Cache-Control', 'no-cache');
  http.setRequestHeader('Accept', 'application/json');

  // Use your own account ID here.
  http.setUrlVar('accountId', '7f3f65ed-5e87-418d-94c1-92499ddc8252');
  // Use the envelope ID returned by DocuSign when creating the draft envelope).
  http.setUrlVar('envelopeId', 'e01f2043-3850-4fcb-afd1-b1726216e099');

  const url = 'https://demo.docusign.net/restapi/v2.1/accounts/{$accountId}/envelopes/{$envelopeId}/documents';
  const resp = new HttpResponse();
  try {
    await http.httpSbAsync('PUT', url, sbJson, 'utf-8', 'application/json', resp);
  } catch {
    console.log(http.lastErrorText);
    return;
  }

  const jResp = new JsonObject();
  jResp.load(resp.bodyStr);
  jResp.emitCompact = false;

  console.log('Response Body:');
  console.log(jResp.emit());

  // If you get a 401 response status code, it's likely you need to refresh the DocuSign OAuth2 token).
  const respStatusCode = resp.statusCode;
  console.log(`Response Status Code = ${respStatusCode}`);
  if (respStatusCode >= 400) {
    console.log('Response Header:');
    console.log(resp.header);
    console.log('Failed.');
    return;
  }

  // Sample JSON response:
  // (Sample code for parsing the JSON response is shown below)

  // {
  //   "envelopeId": "da9fb811-e6a4-48c0-a9fb-81ed18b989af",
  //   "envelopeDocuments": [
  //     {
  //       "documentId": "1",
  //       "documentIdGuid": "38e919fc-0a77-4b0c-9da0-e3530f4e6fc7",
  //       "name": "hello.pdf",
  //       "type": "content",
  //       "uri": "/envelopes/da9fb811-e6a4-48c0-a9fb-81ed18b989af/documents/1",
  //       "order": "3",
  //       "containsPdfFormFields": "false",
  //       "templateRequired": "false",
  //       "authoritativeCopy": "false"
  //     },
  //     {
  //       "documentId": "2",
  //       "documentIdGuid": "2cbd0fcc-c1ca-4a3a-b8b5-fe252dd89731",
  //       "name": "hello2.pdf",
  //       "type": "content",
  //       "uri": "/envelopes/da9fb811-e6a4-48c0-a9fb-81ed18b989af/documents/2",
  //       "order": "4",
  //       "containsPdfFormFields": "false",
  //       "templateRequired": "false",
  //       "authoritativeCopy": "false"
  //     }
  //   ]
  // }

  // Sample code for parsing the JSON response...
  // Use the following online tool to generate parsing code from sample JSON:
  // Generate Parsing Code from JSON

  let documentId = '';
  let documentIdGuid = '';
  let name = '';
  let vType = '';
  let uri = '';
  let order = '';
  let containsPdfFormFields = '';
  let templateRequired = '';
  let authoritativeCopy = '';

  const envelopeId = jResp.stringOf('envelopeId');
  i = 0;
  const countI = jResp.sizeOfArray('envelopeDocuments');
  while (i < countI) {
    jResp.i = i;
    documentId = jResp.stringOf('envelopeDocuments[i].documentId');
    documentIdGuid = jResp.stringOf('envelopeDocuments[i].documentIdGuid');
    name = jResp.stringOf('envelopeDocuments[i].name');
    vType = jResp.stringOf('envelopeDocuments[i].type');
    uri = jResp.stringOf('envelopeDocuments[i].uri');
    order = jResp.stringOf('envelopeDocuments[i].order');
    containsPdfFormFields = jResp.stringOf('envelopeDocuments[i].containsPdfFormFields');
    templateRequired = jResp.stringOf('envelopeDocuments[i].templateRequired');
    authoritativeCopy = jResp.stringOf('envelopeDocuments[i].authoritativeCopy');
    i++;
  }
}