Pascal (Lazarus/Delphi)

DocuSign Add One Document to a Draft Envelope

See more DocuSign Examples

Demonstrates how to add one document to a DocuSign draft envelope. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Http,
  Chilkat.BinData,
  Chilkat.StringBuilder,
  Chilkat.HttpResponse,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  jsonToken: TJsonObject;
  bd1: TBinData;
  json: TJsonObject;
  sbJson: TStringBuilder;
  url: string;
  resp: THttpResponse;
  jResp: TJsonObject;
  respStatusCode: Integer;
  documentId: string;
  documentIdGuid: string;
  name: string;
  v_type: string;
  uri: string;
  order: string;
  containsPdfFormFields: string;
  templateRequired: string;
  authoritativeCopy: string;
  envelopeId: string;
  i: Integer;
  count_i: Integer;

begin
  success := False;

  //  This example assumes the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  http := THttp.Create;

  //  Load a previously obtained OAuth2 access token.
  jsonToken := TJsonObject.Create;
  success := jsonToken.LoadFile('qa_data/tokens/docusign.json');
  if (success = False) then
    begin
      WriteLn(jsonToken.LastErrorText);
      Exit;
    end;

  //  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": "project_xyz.pdf",
  //  		"pages": "1",
  //  		"documentBase64": "<insert base64 content here>"
  //  		}
  //  	]
  //  }

  bd1 := TBinData.Create;
  success := bd1.LoadFile('qa_data/pdf/project_xyz.pdf');

  json := TJsonObject.Create;
  json.UpdateString('documents[0].documentId','1');
  json.UpdateString('documents[0].name','project_xyz.pdf');
  json.UpdateString('documents[0].pages','1');
  json.UpdateString('documents[0].documentBase64',bd1.GetEncoded('base64'));

  sbJson := TStringBuilder.Create;
  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','cee4191c-f94e-4089-9d7c-8033685cbc1a');

  url := 'https://demo.docusign.net/restapi/v2.1/accounts/{$accountId}/envelopes/{$envelopeId}/documents';
  resp := THttpResponse.Create;
  success := http.HttpSb('PUT',url,sbJson,'utf-8','application/json',resp);
  if (success = False) then
    begin
      WriteLn(http.LastErrorText);
      Exit;
    end;

  jResp := TJsonObject.Create;
  jResp.Load(resp.BodyStr);
  jResp.EmitCompact := False;

  WriteLn('Response Body:');
  WriteLn(jResp.Emit());

  //  If you get a 401 response status code, it's likely you need to refresh the DocuSign OAuth2 token).
  respStatusCode := resp.StatusCode;
  WriteLn('Response Status Code = ' + respStatusCode);
  if (respStatusCode >= 400) then
    begin
      WriteLn('Response Header:');
      WriteLn(resp.Header);
      WriteLn('Failed.');
      Exit;
    end;

  //  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": "project_xyz.pdf",
  //        "type": "content",
  //        "uri": "/envelopes/da9fb811-e6a4-48c0-a9fb-81ed18b989af/documents/1",
  //        "order": "3",
  //        "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

  envelopeId := jResp.StringOf('envelopeId');
  i := 0;
  count_i := jResp.SizeOfArray('envelopeDocuments');
  while i < count_i do
    begin
      jResp.I := i;
      documentId := jResp.StringOf('envelopeDocuments[i].documentId');
      documentIdGuid := jResp.StringOf('envelopeDocuments[i].documentIdGuid');
      name := jResp.StringOf('envelopeDocuments[i].name');
      v_type := 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 := i + 1;
    end;



  http.Free;
  jsonToken.Free;
  bd1.Free;
  json.Free;
  sbJson.Free;
  resp.Free;
  jResp.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.