C
C
QuickBooks - Query Employees
See more QuickBooks Examples
Demonstrates how to query the QuickBooks employee data.Chilkat C Downloads
#include <C_CkJsonObject.h>
#include <C_CkRest.h>
#include <C_CkStringBuilder.h>
#include <C_CkDateTime.h>
#include <C_CkDtObj.h>
#include <C_CkStringTable.h>
void ChilkatSample(void)
{
BOOL success;
HCkJsonObject jsonToken;
HCkRest rest;
BOOL bAutoReconnect;
HCkStringBuilder sbAuth;
const char *query;
const char *responseBody;
HCkJsonObject json;
HCkDateTime dtime;
BOOL bLocalTime;
HCkDtObj dt;
int numRecords;
int i;
HCkStringTable sTab;
const char *year;
const char *month;
const char *day;
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 = CkJsonObject_Create();
success = CkJsonObject_LoadFile(jsonToken,"qa_data/tokens/qb-access-token.json");
rest = CkRest_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 = CkRest_Connect(rest,"sandbox-quickbooks.api.intuit.com",443,TRUE,bAutoReconnect);
if (success == FALSE) {
printf("%s\n",CkRest_lastErrorText(rest));
CkJsonObject_Dispose(jsonToken);
CkRest_Dispose(rest);
return;
}
sbAuth = CkStringBuilder_Create();
CkStringBuilder_Append(sbAuth,"Bearer ");
CkStringBuilder_Append(sbAuth,CkJsonObject_stringOf(jsonToken,"access_token"));
CkRest_putAuthorization(rest,CkStringBuilder_getAsString(sbAuth));
CkRest_AddHeader(rest,"Accept","application/json");
CkRest_putAllowHeaderFolding(rest,FALSE);
query = "select * from Employee";
CkRest_AddQueryParam(rest,"query",query);
CkRest_AddQueryParam(rest,"minorversion","45");
// The company ID is 123146096291789
responseBody = CkRest_fullRequestNoBody(rest,"GET","/v3/company/123146096291789/query");
if (CkRest_getLastMethodSuccess(rest) == FALSE) {
printf("%s\n",CkRest_lastErrorText(rest));
CkJsonObject_Dispose(jsonToken);
CkRest_Dispose(rest);
CkStringBuilder_Dispose(sbAuth);
return;
}
// We should expect a 200 response if successful.
if (CkRest_getResponseStatusCode(rest) != 200) {
printf("Request Header: \n");
printf("%s\n",CkRest_lastRequestHeader(rest));
printf("----\n");
printf("Response StatusCode = %d\n",CkRest_getResponseStatusCode(rest));
printf("Response StatusLine: %s\n",CkRest_responseStatusText(rest));
printf("Response Header:\n");
printf("%s\n",CkRest_responseHeader(rest));
printf("%s\n",responseBody);
CkJsonObject_Dispose(jsonToken);
CkRest_Dispose(rest);
CkStringBuilder_Dispose(sbAuth);
return;
}
// Load the JSON response into a JSON object for parsing.
// A sample JSON response is shown below.
json = CkJsonObject_Create();
CkJsonObject_Load(json,responseBody);
// Show the full JSON response.
CkJsonObject_putEmitCompact(json,FALSE);
printf("%s\n",CkJsonObject_emit(json));
// Use this online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
// These will be used for parsing date/time strings..
dtime = CkDateTime_Create();
bLocalTime = TRUE;
dt = CkDtObj_Create();
// Iterate over each account returned.
numRecords = CkJsonObject_SizeOfArray(json,"QueryResponse.Employee");
i = 0;
while (i < numRecords) {
CkJsonObject_putI(json,i);
printf("DisplayName: %s\n",CkJsonObject_stringOf(json,"QueryResponse.Employee[i].DisplayName"));
printf("Id: %s\n",CkJsonObject_stringOf(json,"QueryResponse.Employee[i].Id"));
printf("Active: %d\n",CkJsonObject_BoolOf(json,"QueryResponse.Employee[i].Active"));
// Load the CreateTime into a CkDateTime...
CkDateTime_SetFromTimestamp(dtime,CkJsonObject_stringOf(json,"QueryResponse.Employee[i].MetaData.CreateTime"));
CkDateTime_ToDtObj(dtime,bLocalTime,dt);
printf("%d/%d/%d %d:%d\n",CkDtObj_getMonth(dt),CkDtObj_getDay(dt),CkDtObj_getYear(dt),CkDtObj_getHour(dt),CkDtObj_getMinute(dt));
// The the birth year, month, and day, if it exists.
// The BirthDate contains something like this: "1985-09-11"
if (CkJsonObject_HasMember(json,"QueryResponse.Employee[i].BirthDate") == TRUE) {
sTab = CkStringTable_Create();
CkStringTable_SplitAndAppend(sTab,CkJsonObject_stringOf(json,"QueryResponse.Employee[i].BirthDate"),"-",TRUE,TRUE);
year = CkStringTable_stringAt(sTab,0);
month = CkStringTable_stringAt(sTab,1);
day = CkStringTable_stringAt(sTab,2);
printf("BirthDate: %s/%s/%s\n",month,day,year);
}
printf("----\n");
i = i + 1;
}
printf("Success.\n");
// ------------------------------------------------------
// The JSON response looks like this:
// {
// "QueryResponse": {
// "Employee": [
// {
// "BillableTime": false,
// "domain": "QBO",
// "sparse": false,
// "Id": "55",
// "SyncToken": "0",
// "MetaData": {
// "CreateTime": "2016-09-15T11:21:48-07:00",
// "LastUpdatedTime": "2016-09-15T11:21:48-07:00"
// },
// "GivenName": "Emily",
// "FamilyName": "Platt",
// "DisplayName": "Emily Platt",
// "PrintOnCheckName": "Emily Platt",
// "Active": true
// },
// {
// "BillableTime": false,
// "BirthDate": "1985-09-11",
// "HiredDate": "2016-08-17",
// "domain": "QBO",
// "sparse": false,
// "Id": "54",
// "SyncToken": "1",
// "MetaData": {
// "CreateTime": "2016-09-15T11:21:28-07:00",
// "LastUpdatedTime": "2016-09-15T11:46:26-07:00"
// },
// "GivenName": "John",
// "FamilyName": "Johnson",
// "DisplayName": "John Johnson",
// "PrintOnCheckName": "John Johnson",
// "Active": true,
// "PrimaryPhone": {
// "FreeFormNumber": "(540) 555-9645"
// }
// },
// {
// "SSN": "XXX-XX-XXXX",
// "PrimaryAddr": {
// "Id": "98",
// "Line1": "45 N. Elm Street",
// "City": "Middlefield",
// "CountrySubDivisionCode": "CA",
// "PostalCode": "93242"
// },
// "BillableTime": false,
// "domain": "QBO",
// "sparse": false,
// "Id": "60",
// "SyncToken": "0",
// "MetaData": {
// "CreateTime": "2016-10-25T14:08:18-07:00",
// "LastUpdatedTime": "2016-10-25T14:08:18-07:00"
// },
// "GivenName": "John",
// "FamilyName": "Meuller",
// "DisplayName": "John Meuller",
// "PrintOnCheckName": "John Meuller",
// "Active": true,
// "PrimaryPhone": {
// "FreeFormNumber": "408-525-1234"
// }
// }
// ],
// "startPosition": 1,
// "maxResults": 3
// },
// "time": "2016-10-25T14:18:38.487-07:00"
// }
CkJsonObject_Dispose(jsonToken);
CkRest_Dispose(rest);
CkStringBuilder_Dispose(sbAuth);
CkJsonObject_Dispose(json);
CkDateTime_Dispose(dtime);
CkDtObj_Dispose(dt);
CkStringTable_Dispose(sTab);
}