(VB.NET) Quickbooks Query an Invoice

Demonstrates how to query for invoices matching a SELECT statement via the Quickbooks REST API.

For more information, see https://www.developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/invoice#query-an-invoice

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

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

' First get our previously obtained OAuth2 access token.
Dim jsonToken As New Chilkat.JsonObject
Dim success As Boolean = jsonToken.LoadFile("qa_data/tokens/qb-access-token.json")

Dim rest As New Chilkat.Rest

Dim bTls As Boolean = True
Dim port As Integer = 443
Dim bAutoReconnect As Boolean = True
Dim success As Boolean = rest.Connect("sandbox-quickbooks.api.intuit.com",port,bTls,bAutoReconnect)


Dim sbAuth As New Chilkat.StringBuilder
sbAuth.Append("Bearer ")
sbAuth.Append(jsonToken.StringOf("access_token"))
rest.Authorization = sbAuth.GetAsString()

' --------------------------------------------------------------------------
' Note: The above REST connection and setup of the AWS credentials
' can be done once.  After connecting, any number of REST calls can be made.
' The "auto reconnect" property passed to rest.Connect indicates that if
' the connection is lost, a REST method call will automatically reconnect
' if needed.
' --------------------------------------------------------------------------

' This is a GET request, so there should be no Content-Type
' This line of code is just to make sure..
rest.RemoveHeader("Content-Type")

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

' Add a SELECT statement 
rest.AddQueryParam("query","select * from Invoice where id = '239'")

Dim sbResponseBody As New Chilkat.StringBuilder
success = rest.FullRequestNoBodySb("GET","/v3/company/<realmID>/invoice",sbResponseBody)
If (success <> True) Then
    Debug.WriteLine(rest.LastErrorText)
    Exit Sub
End If


Dim respStatusCode As Integer = rest.ResponseStatusCode
If (respStatusCode >= 400) Then
    Debug.WriteLine("Response Status Code = " & respStatusCode)
    Debug.WriteLine("Response Header:")
    Debug.WriteLine(rest.ResponseHeader)
    Debug.WriteLine("Response Body:")
    Debug.WriteLine(sbResponseBody.GetAsString())
    Exit Sub
End If


' Success is indicated by a 200 response status.
Debug.WriteLine("response status code = " & respStatusCode)


Dim json As New Chilkat.JsonObject
json.LoadSb(sbResponseBody)
json.EmitCompact = False
Debug.WriteLine(json.Emit())

' Sample output:
' Use the this online tool to generate parsing code from sample JSON: 
' Generate Parsing Code from JSON

' {
'   "QueryResponse": {
'     "startPosition": 1, 
'     "totalCount": 1, 
'     "maxResults": 1, 
'     "Invoice": [
'       {
'         "DocNumber": "1070", 
'         "SyncToken": "0", 
'         "domain": "QBO", 
'         "Balance": 150.0, 
'         "BillAddr": {
'           "City": "Bayshore", 
'           "Line1": "4581 Finch St.", 
'           "PostalCode": "94326", 
'           "Lat": "INVALID", 
'           "Long": "INVALID", 
'           "CountrySubDivisionCode": "CA", 
'           "Id": "2"
'         }, 
'         "TxnDate": "2015-07-24", 
'         "TotalAmt": 150.0, 
'         "CustomerRef": {
'           "name": "Amy's Bird Sanctuary", 
'           "value": "1"
'         }, 
'         "ShipAddr": {
'           "City": "Bayshore", 
'           "Line1": "4581 Finch St.", 
'           "PostalCode": "94326", 
'           "Lat": "INVALID", 
'           "Long": "INVALID", 
'           "CountrySubDivisionCode": "CA", 
'           "Id": "109"
'         }, 
'         "LinkedTxn": [], 
'         "DueDate": "2015-08-23", 
'         "PrintStatus": "NeedToPrint", 
'         "Deposit": 0, 
'         "sparse": false, 
'         "EmailStatus": "NotSet", 
'         "Line": [
'           {
'             "LineNum": 1, 
'             "Amount": 150.0, 
'             "SalesItemLineDetail": {
'               "TaxCodeRef": {
'                 "value": "NON"
'               }, 
'               "ItemRef": {
'                 "name": "Services", 
'                 "value": "1"
'               }
'             }, 
'             "Id": "1", 
'             "DetailType": "SalesItemLineDetail"
'           }, 
'           {
'             "DetailType": "SubTotalLineDetail", 
'             "Amount": 150.0, 
'             "SubTotalLineDetail": {}
'           }
'         ], 
'         "ApplyTaxAfterDiscount": false, 
'         "CustomField": [
'           {
'             "DefinitionId": "1", 
'             "Type": "StringType", 
'             "Name": "Crew #"
'           }
'         ], 
'         "Id": "239", 
'         "TxnTaxDetail": {
'           "TotalTax": 0
'         }, 
'         "MetaData": {
'           "CreateTime": "2015-07-24T10:35:08-07:00", 
'           "LastUpdatedTime": "2015-07-24T10:35:08-07:00"
'         }
'       }
'     ]
'   }, 
'   "time": "2015-07-24T10:38:50.01-07:00"
' }



Dim DocNumber As String
Dim SyncToken As String
Dim domain As String
Dim Balance As String
Dim BillAddrCity As String
Dim BillAddrLine1 As String
Dim BillAddrPostalCode As String
Dim BillAddrLat As String
Dim BillAddrLong As String
Dim BillAddrCountrySubDivisionCode As String
Dim BillAddrId As String
Dim TxnDate As String
Dim TotalAmt As String
Dim CustomerRefName As String
Dim CustomerRefValue As String
Dim ShipAddrCity As String
Dim ShipAddrLine1 As String
Dim ShipAddrPostalCode As String
Dim ShipAddrLat As String
Dim ShipAddrLong As String
Dim ShipAddrCountrySubDivisionCode As String
Dim ShipAddrId As String
Dim DueDate As String
Dim PrintStatus As String
Dim Deposit As Integer
Dim sparse As Boolean
Dim EmailStatus As String
Dim ApplyTaxAfterDiscount As Boolean
Dim Id As String
Dim TxnTaxDetailTotalTax As Integer
Dim MetaDataCreateTime As String
Dim MetaDataLastUpdatedTime As String
Dim j As Integer
Dim count_j As Integer
Dim LineNum As Integer
Dim Amount As String
Dim SalesItemLineDetailTaxCodeRefValue As String
Dim SalesItemLineDetailItemRefName As String
Dim SalesItemLineDetailItemRefValue As String
Dim DetailType As String
Dim DefinitionId As String
Dim invType As String
Dim Name As String

Dim QueryResponseStartPosition As Integer = json.IntOf("QueryResponse.startPosition")
Dim QueryResponseTotalCount As Integer = json.IntOf("QueryResponse.totalCount")
Dim QueryResponseMaxResults As Integer = json.IntOf("QueryResponse.maxResults")
Dim time As String = json.StringOf("time")
Dim i As Integer = 0
Dim count_i As Integer = json.SizeOfArray("QueryResponse.Invoice")
While i < count_i
    json.I = i
    DocNumber = json.StringOf("QueryResponse.Invoice[i].DocNumber")
    SyncToken = json.StringOf("QueryResponse.Invoice[i].SyncToken")
    domain = json.StringOf("QueryResponse.Invoice[i].domain")
    Balance = json.StringOf("QueryResponse.Invoice[i].Balance")
    BillAddrCity = json.StringOf("QueryResponse.Invoice[i].BillAddr.City")
    BillAddrLine1 = json.StringOf("QueryResponse.Invoice[i].BillAddr.Line1")
    BillAddrPostalCode = json.StringOf("QueryResponse.Invoice[i].BillAddr.PostalCode")
    BillAddrLat = json.StringOf("QueryResponse.Invoice[i].BillAddr.Lat")
    BillAddrLong = json.StringOf("QueryResponse.Invoice[i].BillAddr.Long")
    BillAddrCountrySubDivisionCode = json.StringOf("QueryResponse.Invoice[i].BillAddr.CountrySubDivisionCode")
    BillAddrId = json.StringOf("QueryResponse.Invoice[i].BillAddr.Id")
    TxnDate = json.StringOf("QueryResponse.Invoice[i].TxnDate")
    TotalAmt = json.StringOf("QueryResponse.Invoice[i].TotalAmt")
    CustomerRefName = json.StringOf("QueryResponse.Invoice[i].CustomerRef.name")
    CustomerRefValue = json.StringOf("QueryResponse.Invoice[i].CustomerRef.value")
    ShipAddrCity = json.StringOf("QueryResponse.Invoice[i].ShipAddr.City")
    ShipAddrLine1 = json.StringOf("QueryResponse.Invoice[i].ShipAddr.Line1")
    ShipAddrPostalCode = json.StringOf("QueryResponse.Invoice[i].ShipAddr.PostalCode")
    ShipAddrLat = json.StringOf("QueryResponse.Invoice[i].ShipAddr.Lat")
    ShipAddrLong = json.StringOf("QueryResponse.Invoice[i].ShipAddr.Long")
    ShipAddrCountrySubDivisionCode = json.StringOf("QueryResponse.Invoice[i].ShipAddr.CountrySubDivisionCode")
    ShipAddrId = json.StringOf("QueryResponse.Invoice[i].ShipAddr.Id")
    DueDate = json.StringOf("QueryResponse.Invoice[i].DueDate")
    PrintStatus = json.StringOf("QueryResponse.Invoice[i].PrintStatus")
    Deposit = json.IntOf("QueryResponse.Invoice[i].Deposit")
    sparse = json.BoolOf("QueryResponse.Invoice[i].sparse")
    EmailStatus = json.StringOf("QueryResponse.Invoice[i].EmailStatus")
    ApplyTaxAfterDiscount = json.BoolOf("QueryResponse.Invoice[i].ApplyTaxAfterDiscount")
    Id = json.StringOf("QueryResponse.Invoice[i].Id")
    TxnTaxDetailTotalTax = json.IntOf("QueryResponse.Invoice[i].TxnTaxDetail.TotalTax")
    MetaDataCreateTime = json.StringOf("QueryResponse.Invoice[i].MetaData.CreateTime")
    MetaDataLastUpdatedTime = json.StringOf("QueryResponse.Invoice[i].MetaData.LastUpdatedTime")
    j = 0
    count_j = json.SizeOfArray("QueryResponse.Invoice[i].LinkedTxn")
    While j < count_j
        json.J = j
        j = j + 1
    End While
    j = 0
    count_j = json.SizeOfArray("QueryResponse.Invoice[i].Line")
    While j < count_j
        json.J = j
        LineNum = json.IntOf("QueryResponse.Invoice[i].Line[j].LineNum")
        Amount = json.StringOf("QueryResponse.Invoice[i].Line[j].Amount")
        SalesItemLineDetailTaxCodeRefValue = json.StringOf("QueryResponse.Invoice[i].Line[j].SalesItemLineDetail.TaxCodeRef.value")
        SalesItemLineDetailItemRefName = json.StringOf("QueryResponse.Invoice[i].Line[j].SalesItemLineDetail.ItemRef.name")
        SalesItemLineDetailItemRefValue = json.StringOf("QueryResponse.Invoice[i].Line[j].SalesItemLineDetail.ItemRef.value")
        Id = json.StringOf("QueryResponse.Invoice[i].Line[j].Id")
        DetailType = json.StringOf("QueryResponse.Invoice[i].Line[j].DetailType")
        j = j + 1
    End While
    j = 0
    count_j = json.SizeOfArray("QueryResponse.Invoice[i].CustomField")
    While j < count_j
        json.J = j
        DefinitionId = json.StringOf("QueryResponse.Invoice[i].CustomField[j].DefinitionId")
        invType = json.StringOf("QueryResponse.Invoice[i].CustomField[j].Type")
        Name = json.StringOf("QueryResponse.Invoice[i].CustomField[j].Name")
        j = j + 1
    End While
    i = i + 1
End While