Pascal (Lazarus/Delphi)

QuickBooks - Full Update an Account

See more QuickBooks Examples

Demonstrates how to update any of the writable fields of an existing account. The example first reads the JSON data for the account, makes some changes, and then POST's the updated JSON to update the account. 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.StringBuilder,
  Chilkat.Rest,
  Chilkat.JsonObject;

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

procedure RunDemo;
var
  success: Boolean;
  jsonToken: TJsonObject;
  rest: TRest;
  bAutoReconnect: Boolean;
  sbAuth: TStringBuilder;
  responseBody: string;
  json: TJsonObject;
  updateJson: TJsonObject;

begin
  success := False;

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

  //  Get our previously obtained OAuth2 access token, which should contain JSON like this:
  //  {
  //    "expires_in": 3600,
  //    "x_refresh_token_expires_in": 8726400,
  //    "refresh_token": "L011546037639r ... 3vR2DrbOmg0Sdagw",
  //    "access_token": "eyJlbmMiOiJBMTI4Q0 ... oETJEMbeggg",
  //    "token_type": "bearer"
  //  }

  jsonToken := TJsonObject.Create;
  success := jsonToken.LoadFile('qa_data/tokens/qb-access-token.json');

  rest := TRest.Create;

  //  Connect using TLS.
  //  A single REST object, once connected, can be used for many Quickbooks REST API calls.
  //  The auto-reconnect indicates that if the already-established HTTPS connection is closed,
  //  then it will be automatically re-established as needed.
  bAutoReconnect := True;
  success := rest.Connect('sandbox-quickbooks.api.intuit.com',443,True,bAutoReconnect);
  if (success = False) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  sbAuth := TStringBuilder.Create;
  sbAuth.Append('Bearer ');
  sbAuth.Append(jsonToken.StringOf('access_token'));
  rest.Authorization := sbAuth.GetAsString();

  rest.AddHeader('Accept','application/json');
  rest.AllowHeaderFolding := False;

  //  First get the full JSON for the account we'll be updating..
  //  The company ID is the 123146096291789
  //  The account ID is 29
  responseBody := rest.FullRequestNoBody('GET','/v3/company/123146096291789/account/29?minorversion=45');
  if (rest.LastMethodSuccess = False) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  We should expect a 200 response if successful.
  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('Request Header: ');
      WriteLn(rest.LastRequestHeader);
      WriteLn('----');
      WriteLn('Response StatusCode = ' + rest.ResponseStatusCode);
      WriteLn('Response StatusLine: ' + rest.ResponseStatusText);
      WriteLn('Response Header:');
      WriteLn(rest.ResponseHeader);
      WriteLn(responseBody);
      Exit;
    end;

  //  Load the JSON response into a JSON object for parsing/updating
  json := TJsonObject.Create;
  json.Load(responseBody);

  //  Show the JSON..
  json.EmitCompact := False;
  WriteLn(json.Emit());
  WriteLn('----');

  //  The JSON passed in the HTTP POST for updating is the inner content of the Account
  updateJson := TJsonObject.Create;
  json.ObjectOf2('Account',updateJson);

  //  Add or update the Description.
  //  (If a Description already exists, it is replace, otherwise the Description is added.)
  updateJson.UpdateString('Description','Description added during update.');

  //  Examine the JSON we'll be sending in the body of the POST.
  updateJson.EmitCompact := False;
  WriteLn(updateJson.Emit());
  WriteLn('----');

  //  Now we're going to POST the changes to update the Quickbooks account.
  rest.ClearAllHeaders();
  rest.Authorization := sbAuth.GetAsString();
  rest.AddHeader('Accept','application/json');
  rest.AddHeader('Content-Type','application/json');

  //  The updated JSON is passed as the HTTP request body.
  responseBody := rest.FullRequestString('POST','/v3/company/123146096291789/account?minorversion=45',updateJson.Emit());
  if (rest.LastMethodSuccess <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  We should expect a 200 response if successful.
  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('Request Header: ');
      WriteLn(rest.LastRequestHeader);
      WriteLn('----');
      WriteLn('Response StatusCode = ' + rest.ResponseStatusCode);
      WriteLn('Response StatusLine: ' + rest.ResponseStatusText);
      WriteLn('Response Header:');
      WriteLn(rest.ResponseHeader);
      WriteLn(responseBody);
      Exit;
    end;

  //  Load the JSON response into a JSON object to emit in indented form..
  json.Load(responseBody);
  WriteLn(json.Emit());

  //  Use this online tool to generate parsing code from sample JSON: 
  //  Generate Parsing Code from JSON

  WriteLn('Success.');


  jsonToken.Free;
  rest.Free;
  sbAuth.Free;
  json.Free;
  updateJson.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.