(AutoIt) QuickBooks - Query Employees

Demonstrates how to query the QuickBooks employee data.

For more information, see https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/employee#query-an-employee

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

; 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"
; }

$oJsonToken = ObjCreate("Chilkat.JsonObject")
Local $bSuccess = $oJsonToken.LoadFile("qa_data/tokens/qb-access-token.json")

$oRest = ObjCreate("Chilkat.Rest")

; 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.
Local $bAutoReconnect = True
$bSuccess = $oRest.Connect("sandbox-quickbooks.api.intuit.com",443,True,$bAutoReconnect)
If ($bSuccess <> True) Then
    ConsoleWrite($oRest.LastErrorText & @CRLF)
    Exit
EndIf

$oSbAuth = ObjCreate("Chilkat.StringBuilder")
$oSbAuth.Append("Bearer ")
$oSbAuth.Append($oJsonToken.StringOf("access_token"))
$oRest.Authorization = $oSbAuth.GetAsString()

$oRest.AddHeader("Accept","application/json")
$oRest.AllowHeaderFolding = False

Local $sQuery = "select * from Employee"
$oRest.AddQueryParam("query",$sQuery)
$oRest.AddQueryParam("minorversion","45")

; The company ID is 123146096291789
Local $sResponseBody = $oRest.FullRequestNoBody("GET","/v3/company/123146096291789/query")
If ($oRest.LastMethodSuccess <> True) Then
    ConsoleWrite($oRest.LastErrorText & @CRLF)
    Exit
EndIf

; We should expect a 200 response if successful.
If ($oRest.ResponseStatusCode <> 200) Then
    ConsoleWrite("Request Header: " & @CRLF)
    ConsoleWrite($oRest.LastRequestHeader & @CRLF)
    ConsoleWrite("----" & @CRLF)
    ConsoleWrite("Response StatusCode = " & $oRest.ResponseStatusCode & @CRLF)
    ConsoleWrite("Response StatusLine: " & $oRest.ResponseStatusText & @CRLF)
    ConsoleWrite("Response Header:" & @CRLF)
    ConsoleWrite($oRest.ResponseHeader & @CRLF)
    ConsoleWrite($sResponseBody & @CRLF)
    Exit
EndIf

; Load the JSON response into a JSON object for parsing.
; A sample JSON response is shown below.
$oJson = ObjCreate("Chilkat.JsonObject")
$oJson.Load($sResponseBody)

; Show the full JSON response.
$oJson.EmitCompact = False
ConsoleWrite($oJson.Emit() & @CRLF)

; 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..
$oDtime = ObjCreate("Chilkat.CkDateTime")
Local $bLocalTime = True
Local $oDt

; Iterate over each account returned.
Local $iNumRecords = $oJson.SizeOfArray("QueryResponse.Employee")
Local $i = 0
While $i < $iNumRecords

    $oJson.I = $i
    ConsoleWrite("DisplayName: " & $oJson.StringOf("QueryResponse.Employee[i].DisplayName") & @CRLF)
    ConsoleWrite("Id: " & $oJson.StringOf("QueryResponse.Employee[i].Id") & @CRLF)
    ConsoleWrite("Active: " & $oJson.BoolOf("QueryResponse.Employee[i].Active") & @CRLF)

    ; Load the CreateTime into a CkDateTime...
    $oDtime.SetFromTimestamp($oJson.StringOf("QueryResponse.Employee[i].MetaData.CreateTime"))
    $oDt = $oDtime.GetDtObj($bLocalTime)
    ConsoleWrite($oDt.Month & "/" & $oDt.Day & "/" & $oDt.Year & "  " & $oDt.Hour & ":" & $oDt.Minute & @CRLF)

    ; The the birth year, month, and day, if it exists.
    ; The BirthDate contains something like this: "1985-09-11"
    If ($oJson.HasMember("QueryResponse.Employee[i].BirthDate") = True) Then
        $oSTab = ObjCreate("Chilkat.StringTable")
        $oSTab.SplitAndAppend($oJson.StringOf("QueryResponse.Employee[i].BirthDate"),"-",True,True)
Local $sYear = $oSTab.StringAt(0)
Local $sMonth = $oSTab.StringAt(1)
Local $sDay = $oSTab.StringAt(2)
        ConsoleWrite("BirthDate: " & $sMonth & "/" & $sDay & "/" & $sYear & @CRLF)
    EndIf

    ConsoleWrite("----" & @CRLF)
    $i = $i + 1
Wend

ConsoleWrite("Success." & @CRLF)

; ------------------------------------------------------
; 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"
;