(Delphi DLL) Xero Update Account Details

Update some details of an account in a Xero company (Accounting API)

For more information, see https://developer.xero.com/documentation/api/accounts#POST

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: HCkHttp;
jsonToken: HCkJsonObject;
success: Boolean;
jsonRequestBody: HCkJsonObject;
url: PWideChar;
resp: HCkHttpResponse;
jsonResponse: HCkJsonObject;
AccountID: PWideChar;
Code: PWideChar;
Name: PWideChar;
Type: PWideChar;
TaxType: PWideChar;
Description: PWideChar;
Class: PWideChar;
EnablePaymentsToAccount: Boolean;
ShowInExpenseClaims: Boolean;
ReportingCode: PWideChar;
ReportingCodeName: PWideChar;
UpdatedDateUTC: PWideChar;
AddToWatchlist: Boolean;
Id: PWideChar;
Status: PWideChar;
ProviderName: PWideChar;
DateTimeUTC: PWideChar;
i: Integer;
count_i: Integer;

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

http := CkHttp_Create();

jsonToken := CkJsonObject_Create();
success := CkJsonObject_LoadFile(jsonToken,'qa_data/tokens/xero-access-token.json');
if (success = False) then
  begin
    Memo1.Lines.Add(CkJsonObject__lastErrorText(jsonToken));
    Exit;
  end;

CkHttp_putAuthToken(http,CkJsonObject__stringOf(jsonToken,'access_token'));

// Replace the value here with an actual tenant ID obtained from this example:
// Get Xero Tenant IDs
CkHttp_SetRequestHeader(http,'Xero-tenant-id','83299b9e-5747-4a14-a18a-a6c94f824eb7');

CkHttp_putAccept(http,'application/json');

// The following JSON is sent in the request body:

// {
//   "AccountID": "54ddab14-4a8d-45cf-86be-076c99a0cea0",
//   "Name": "Sales account",
//   "Type": "REVENUE",
//   "TaxType": "OUTPUT",
//   "Description": "Income from any normal business trading activity",
//   "EnablePaymentsToAccount": "false",
//   "ShowInExpenseClaims": "false"
// }

// Use this online tool to generate the code from sample JSON: 
// Generate Code to Create JSON

jsonRequestBody := CkJsonObject_Create();
CkJsonObject_UpdateString(jsonRequestBody,'AccountID','54ddab14-4a8d-45cf-86be-076c99a0cea0');
CkJsonObject_UpdateString(jsonRequestBody,'Name','Sales account');
CkJsonObject_UpdateString(jsonRequestBody,'Type','REVENUE');
CkJsonObject_UpdateString(jsonRequestBody,'TaxType','OUTPUT');
CkJsonObject_UpdateString(jsonRequestBody,'Description','Income from any normal business trading activity');
CkJsonObject_UpdateString(jsonRequestBody,'EnablePaymentsToAccount','false');
CkJsonObject_UpdateString(jsonRequestBody,'ShowInExpenseClaims','false');

url := 'https://api.xero.com/api.xro/2.0/Accounts/54ddab14-4a8d-45cf-86be-076c99a0cea0';

resp := CkHttp_PText(http,'POST',url,CkJsonObject__emit(jsonRequestBody),'utf-8','application/json',False,False);
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add('Response Status Code: ' + IntToStr(CkHttpResponse_getStatusCode(resp)));

jsonResponse := CkJsonObject_Create();
CkJsonObject_Load(jsonResponse,CkHttpResponse__bodyStr(resp));
CkJsonObject_putEmitCompact(jsonResponse,False);
Memo1.Lines.Add(CkJsonObject__emit(jsonResponse));

if (CkHttpResponse_getStatusCode(resp) >= 300) then
  begin
    Memo1.Lines.Add('Failed.');
    CkHttpResponse_Dispose(resp);
    Exit;
  end;

CkHttpResponse_Dispose(resp);

// Sample output...
// (See the parsing code below..)
// 
// Use the this online tool to generate parsing code from sample JSON: 
// Generate Parsing Code from JSON

// {
//   "Id": "430e92a8-de02-41d5-a00e-3ef899188aea",
//   "Status": "OK",
//   "ProviderName": "Chilkat2222",
//   "DateTimeUTC": "\/Date(1587162517005)\/",
//   "Accounts": [
//     {
//       "AccountID": "54ddab14-4a8d-45cf-86be-076c99a0cea0",
//       "Code": "201",
//       "Name": "Sales account",
//       "Status": "ACTIVE",
//       "Type": "REVENUE",
//       "TaxType": "OUTPUT",
//       "Description": "Income from any normal business trading activity",
//       "Class": "REVENUE",
//       "EnablePaymentsToAccount": false,
//       "ShowInExpenseClaims": false,
//       "ReportingCode": "REV",
//       "ReportingCodeName": "Revenue",
//       "UpdatedDateUTC": "\/Date(1587162517090+0000)\/",
//       "AddToWatchlist": false
//     }
//   ]
// }
// 

Id := CkJsonObject__stringOf(jsonResponse,'Id');
Status := CkJsonObject__stringOf(jsonResponse,'Status');
ProviderName := CkJsonObject__stringOf(jsonResponse,'ProviderName');
DateTimeUTC := CkJsonObject__stringOf(jsonResponse,'DateTimeUTC');
i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'Accounts');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    AccountID := CkJsonObject__stringOf(jsonResponse,'Accounts[i].AccountID');
    Code := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Code');
    Name := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Name');
    Status := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Status');
    Type := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Type');
    TaxType := CkJsonObject__stringOf(jsonResponse,'Accounts[i].TaxType');
    Description := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Description');
    Class := CkJsonObject__stringOf(jsonResponse,'Accounts[i].Class');
    EnablePaymentsToAccount := CkJsonObject_BoolOf(jsonResponse,'Accounts[i].EnablePaymentsToAccount');
    ShowInExpenseClaims := CkJsonObject_BoolOf(jsonResponse,'Accounts[i].ShowInExpenseClaims');
    ReportingCode := CkJsonObject__stringOf(jsonResponse,'Accounts[i].ReportingCode');
    ReportingCodeName := CkJsonObject__stringOf(jsonResponse,'Accounts[i].ReportingCodeName');
    UpdatedDateUTC := CkJsonObject__stringOf(jsonResponse,'Accounts[i].UpdatedDateUTC');
    AddToWatchlist := CkJsonObject_BoolOf(jsonResponse,'Accounts[i].AddToWatchlist');
    i := i + 1;
  end;

CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonToken);
CkJsonObject_Dispose(jsonRequestBody);
CkJsonObject_Dispose(jsonResponse);

end;