Chilkat Online Tools

PureBasic / New FreshBooks / Get Bills

Back to Collection Items

IncludeFile "CkJsonObject.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"

Procedure ChilkatExample()

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

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    queryParams.i = CkJsonObject::ckCreate()
    If queryParams.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(queryParams,"search[date_min]","2021-10-09")
    CkJsonObject::ckUpdateString(queryParams,"search[date_max]","search[date_min]")

    ; Adds the "Authorization: Bearer <access_token>" header.
    CkHttp::setCkAuthToken(http, "<access_token>")

    resp.i = CkHttp::ckQuickRequestParams(http,"GET","https://api.freshbooks.com/accounting/account/5pyBd/bills/bills",queryParams)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)

    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "response": {
    ;     "result": {
    ;       "bill_vendors": [
    ;         {
    ;           "account_number": "8394858982590",
    ;           "city": null,
    ;           "country": null,
    ;           "created_at": "2020-10-06 14:20:20",
    ;           "currency_code": "CAD",
    ;           "is_1099": false,
    ;           "language": "en",
    ;           "outstanding_balance": [
    ;             {
    ;               "amount": {
    ;                 "amount": "5.00",
    ;                 "code": "CAD"
    ;               }
    ;             }
    ;           ],
    ;           "overdue_balance": [
    ;           ],
    ;           "phone": "8335970553",
    ;           "postal_code": null,
    ;           "primary_contact_email": "hdavid@freshbooks.com",
    ;           "primary_contact_first_name": "Hannah",
    ;           "primary_contact_last_name": "David",
    ;           "province": null,
    ;           "street": null,
    ;           "street2": null,
    ;           "tax_defaults": [
    ;             {
    ;               "amount": "13.56",
    ;               "created_at": "2020-10-06 14:23:06",
    ;               "enabled": true,
    ;               "name": "GST",
    ;               "system_taxid": 36859,
    ;               "tax_authorityid": null,
    ;               "taxid": 1,
    ;               "updated_at": "2020-10-06 14:23:06",
    ;               "vendorid": 1
    ;             },
    ;             {
    ;               "amount": "13",
    ;               "created_at": "2020-10-06 14:23:06",
    ;               "enabled": true,
    ;               "name": "HST",
    ;               "system_taxid": 37696,
    ;               "tax_authorityid": null,
    ;               "taxid": 3,
    ;               "updated_at": "2020-10-06 14:23:06",
    ;               "vendorid": 1
    ;             }
    ;           ],
    ;           "updated_at": "2020-10-06 14:22:49",
    ;           "vendor_name": "Staples",
    ;           "vendorid": 1,
    ;           "vis_state": 0,
    ;           "website": null
    ;         }
    ;       ],
    ;       "page": 1,
    ;       "pages": 1,
    ;       "per_page": 15,
    ;       "total": 1
    ;     }
    ;   }
    ; }

    ; Sample code for parsing the JSON response...
    ; Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    account_number.s
    city.s
    country.s
    created_at.s
    currency_code.s
    is_1099.i
    language.s
    phone.s
    postal_code.s
    primary_contact_email.s
    primary_contact_first_name.s
    primary_contact_last_name.s
    province.s
    street.s
    street2.s
    updated_at.s
    vendor_name.s
    vendorid.i
    vis_state.i
    website.s
    j.i
    count_j.i
    Amount.s
    Code.s
    amount.s
    enabled.i
    name.s
    system_taxid.i
    tax_authorityid.s
    taxid.i

    Page.i = CkJsonObject::ckIntOf(jResp,"response.result.page")
    Pages.i = CkJsonObject::ckIntOf(jResp,"response.result.pages")
    Per_page.i = CkJsonObject::ckIntOf(jResp,"response.result.per_page")
    Total.i = CkJsonObject::ckIntOf(jResp,"response.result.total")
    i.i = 0
    count_i.i = CkJsonObject::ckSizeOfArray(jResp,"response.result.bill_vendors")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        account_number = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].account_number")
        city = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].city")
        country = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].country")
        created_at = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].created_at")
        currency_code = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].currency_code")
        is_1099 = CkJsonObject::ckBoolOf(jResp,"response.result.bill_vendors[i].is_1099")
        language = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].language")
        phone = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].phone")
        postal_code = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].postal_code")
        primary_contact_email = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].primary_contact_email")
        primary_contact_first_name = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].primary_contact_first_name")
        primary_contact_last_name = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].primary_contact_last_name")
        province = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].province")
        street = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].street")
        street2 = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].street2")
        updated_at = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].updated_at")
        vendor_name = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].vendor_name")
        vendorid = CkJsonObject::ckIntOf(jResp,"response.result.bill_vendors[i].vendorid")
        vis_state = CkJsonObject::ckIntOf(jResp,"response.result.bill_vendors[i].vis_state")
        website = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].website")
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"response.result.bill_vendors[i].outstanding_balance")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            Amount = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].outstanding_balance[j].amount.amount")
            Code = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].outstanding_balance[j].amount.code")
            j = j + 1
        Wend
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"response.result.bill_vendors[i].overdue_balance")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            j = j + 1
        Wend
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"response.result.bill_vendors[i].tax_defaults")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            amount = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].amount")
            created_at = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].created_at")
            enabled = CkJsonObject::ckBoolOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].enabled")
            name = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].name")
            system_taxid = CkJsonObject::ckIntOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].system_taxid")
            tax_authorityid = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].tax_authorityid")
            taxid = CkJsonObject::ckIntOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].taxid")
            updated_at = CkJsonObject::ckStringOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].updated_at")
            vendorid = CkJsonObject::ckIntOf(jResp,"response.result.bill_vendors[i].tax_defaults[j].vendorid")
            j = j + 1
        Wend
        i = i + 1
    Wend


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(queryParams)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure

Curl Command

curl -G -d "search[date_min]=2021-10-09"
	-d "search[date_max]=search%5Bdate_min%5D"
	-H "Authorization: Bearer <access_token>"
https://api.freshbooks.com/accounting/account/5pyBd/bills/bills

Postman Collection Item JSON

{
  "name": "Get Bills",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "let jsonData = JSON.parse(responseBody);",
          "pm.environment.set(\"billId\", jsonData.response.result.bills[0].id)"
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "auth": {
      "type": "bearer",
      "bearer": [
        {
          "key": "token",
          "value": "eyJraWQiOiJhMTlPSlR5aVlKOXhPM3FoWnhWeE1KZE5ZNXJ4cUhpQzBSTUY0TWRheGtjIiwiYWxnIjoiUlMyNTYifQ.eyJqdGkiOiJjZTI5MTQ1MWUxMTYyMThmNDdlZDhhMGIyYWJhZGVkODhhZDIyZWUxNDlhNmI0OTczMzVlNWU3MDMxNTdmZDJmIiwiaWF0IjoxNjM3MDc4ODUyLCJleHAiOjE2MzcxMjIwNTIsInN1YiI6IlNtdXhJZGVudGl0eTs2NzA1NDgiLCJjbGllbnRfaWQiOiI1MzFlMjI0NzMxYWUxYjcyNzkyMDUwYzIxYjdjYjg4YjQ4YjVjZmYyM2IyNjQ0OGYxMGM3YjZkZDE2YzM4M2NiIiwic2NvcGUiOiJhZG1pbjphbGwiLCJhdXRoLmZyZXNoYm9va3MuY29tL3N1Yl90eXBlIjoicmVzb3VyY2Vfb3duZXIifQ.XZYsOTZZJyxc4ny1NVrAShnNqbpS1GGc54jlRSO8gll4axcdadpluV_gflS_CyZfPSw6ivhu1lwxczj5xGNllZkMI85nVs17EPmpq4MqO9b08oaWoWIptxD329uO893jxW4cFQdGLbCAnJ2BNddWoVIaHS-1EiVPbEh8EKTFeJ-j5tYHRbWcuy32ftuKrqX53z5dY3sUMRsmhsGMfOEzTUfz0J1epHqJSDGHn-HQLljZ4fbmGwCf4LlWPnsgGJj5nDxiRWbUOPXW2J73_tAAH2-u49MRhO2nf_8meHKHhCVZZ0PM4lPzaAqv5OkofwCSEEgIX4Af3Ifh88O9uLtbGg",
          "type": "string"
        }
      ]
    },
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "https://api.freshbooks.com/accounting/account/5pyBd/bills/bills?search[date_min]=2021-10-09&search[date_max]=search[date_min]",
      "protocol": "https",
      "host": [
        "api",
        "freshbooks",
        "com"
      ],
      "path": [
        "accounting",
        "account",
        "5pyBd",
        "bills",
        "bills"
      ],
      "query": [
        {
          "key": "search[date_min]",
          "value": "2021-10-09"
        },
        {
          "key": "search[date_max]",
          "value": "search[date_min]"
        }
      ]
    }
  },
  "response": [
    {
      "name": "https://api.freshbooks.com/accounting/account/{{accountId}}/bill_vendors/bill_vendors",
      "originalRequest": {
        "method": "GET",
        "header": [
        ],
        "url": {
          "raw": "https://api.freshbooks.com/accounting/account/{{accountId}}/bill_vendors/bill_vendors",
          "protocol": "https",
          "host": [
            "api",
            "freshbooks",
            "com"
          ],
          "path": [
            "accounting",
            "account",
            "{{accountId}}",
            "bill_vendors",
            "bill_vendors"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Server",
          "value": "nginx"
        },
        {
          "key": "Date",
          "value": "Fri, 09 Oct 2020 15:19:07 GMT"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        },
        {
          "key": "Vary",
          "value": "Accept-Encoding"
        },
        {
          "key": "X-NewRelic-App-Data",
          "value": "PxQBWV5TCBABVlVSAwEOVlcTGhE1AwE2QgNWEVlbQFtcCxYnRA9QFg1ZWU4DFVdfRgFPCkNFR0gGWFpfPRAGDFQNShECWl1eXxNcD1UOQRFGGgdNVk0LBQlRU1sOBwVTVwgABFBeVk4dUxRACVxRAFIGC1QHBAdaV1RWA0RPXlJcFwQ/"
        },
        {
          "key": "X-Frame-Options",
          "value": "SAMEORIGIN"
        },
        {
          "key": "X-XSS-Protection",
          "value": "1; mode=block"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "Content-Security-Policy",
          "value": "default-src 'self'"
        },
        {
          "key": "X-Content-Security-Policy",
          "value": "default-src 'self'"
        },
        {
          "key": "Strict-Transport-Security",
          "value": "max-age=31556926; includeSubDomains; preload"
        },
        {
          "key": "Referrer-Policy",
          "value": "strict-origin-when-cross-origin"
        },
        {
          "key": "X-RateLimit-Limit",
          "value": "600"
        },
        {
          "key": "X-RateLimit-Remaining",
          "value": "599"
        },
        {
          "key": "X-RateLimit-Reset",
          "value": "1602256808"
        },
        {
          "key": "Retry-After",
          "value": "60"
        },
        {
          "key": "Access-Control-Allow-Origin",
          "value": "*"
        },
        {
          "key": "Content-Encoding",
          "value": "gzip"
        },
        {
          "key": "Via",
          "value": "1.1 google"
        },
        {
          "key": "Alt-Svc",
          "value": "h3-Q050=\":443\"; ma=2592000,h3-Q046=\":443\"; ma=2592000,h3-Q043=\":443\"; ma=2592000,quic=\":443\"; ma=2592000; v=\"46,43\""
        },
        {
          "key": "Transfer-Encoding",
          "value": "chunked"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"response\": {\n        \"result\": {\n            \"bill_vendors\": [\n                {\n                    \"account_number\": \"8394858982590\",\n                    \"city\": null,\n                    \"country\": null,\n                    \"created_at\": \"2020-10-06 14:20:20\",\n                    \"currency_code\": \"CAD\",\n                    \"is_1099\": false,\n                    \"language\": \"en\",\n                    \"outstanding_balance\": [\n                        {\n                            \"amount\": {\n                                \"amount\": \"5.00\",\n                                \"code\": \"CAD\"\n                            }\n                        }\n                    ],\n                    \"overdue_balance\": [],\n                    \"phone\": \"8335970553\",\n                    \"postal_code\": null,\n                    \"primary_contact_email\": \"hdavid@freshbooks.com\",\n                    \"primary_contact_first_name\": \"Hannah\",\n                    \"primary_contact_last_name\": \"David\",\n                    \"province\": null,\n                    \"street\": null,\n                    \"street2\": null,\n                    \"tax_defaults\": [\n                        {\n                            \"amount\": \"13.56\",\n                            \"created_at\": \"2020-10-06 14:23:06\",\n                            \"enabled\": true,\n                            \"name\": \"GST\",\n                            \"system_taxid\": 36859,\n                            \"tax_authorityid\": null,\n                            \"taxid\": 1,\n                            \"updated_at\": \"2020-10-06 14:23:06\",\n                            \"vendorid\": 1\n                        },\n                        {\n                            \"amount\": \"13\",\n                            \"created_at\": \"2020-10-06 14:23:06\",\n                            \"enabled\": true,\n                            \"name\": \"HST\",\n                            \"system_taxid\": 37696,\n                            \"tax_authorityid\": null,\n                            \"taxid\": 3,\n                            \"updated_at\": \"2020-10-06 14:23:06\",\n                            \"vendorid\": 1\n                        }\n                    ],\n                    \"updated_at\": \"2020-10-06 14:22:49\",\n                    \"vendor_name\": \"Staples\",\n                    \"vendorid\": 1,\n                    \"vis_state\": 0,\n                    \"website\": null\n                }\n            ],\n            \"page\": 1,\n            \"pages\": 1,\n            \"per_page\": 15,\n            \"total\": 1\n        }\n    }\n}"
    }
  ]
}