(MFC) QuickBooks - Full Update an Employee

Demonstrates how to update any of the writable fields of an existing employee. The example first reads the JSON data for the employee, makes some changes, and then POST's the updated JSON to update the employee.

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

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkJsonObject.h>
#include <CkRest.h>
#include <CkStringBuilder.h>

void ChilkatSample(void)
    {
    CkString strOut;

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

    CkJsonObject jsonToken;
    bool success = jsonToken.LoadFile("qa_data/tokens/qb-access-token.json");

    CkRest 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.
    bool bAutoReconnect = true;
    success = rest.Connect("sandbox-quickbooks.api.intuit.com",443,true,bAutoReconnect);
    if (success != true) {
        strOut.append(rest.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    CkStringBuilder sbAuth;
    sbAuth.Append("Bearer ");
    sbAuth.Append(jsonToken.stringOf("access_token"));
    rest.put_Authorization(sbAuth.getAsString());

    rest.AddHeader("Accept","application/json");
    rest.put_AllowHeaderFolding(false);

    // First get the data for the employee we'll be updating..
    // The company ID is 123146096291789
    // The employee ID is 58
    const char *responseBody = rest.fullRequestNoBody("GET","/v3/company/123146096291789/employee/58?minorversion=45");
    if (rest.get_LastMethodSuccess() != true) {
        strOut.append(rest.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // We should expect a 200 response if successful.
    if (rest.get_ResponseStatusCode() != 200) {
        strOut.append("Request Header: ");
        strOut.append("\r\n");
        strOut.append(rest.lastRequestHeader());
        strOut.append("\r\n");
        strOut.append("----");
        strOut.append("\r\n");
        strOut.append("Response StatusCode = ");
        strOut.appendInt(rest.get_ResponseStatusCode());
        strOut.append("\r\n");
        strOut.append("Response StatusLine: ");
        strOut.append(rest.responseStatusText());
        strOut.append("\r\n");
        strOut.append("Response Header:");
        strOut.append("\r\n");
        strOut.append(rest.responseHeader());
        strOut.append("\r\n");
        strOut.append(responseBody);
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // Load the JSON response into a JSON object for parsing/updating
    CkJsonObject json;
    json.Load(responseBody);

    // Show the JSON..
    json.put_EmitCompact(false);
    strOut.append(json.emit());
    strOut.append("\r\n");
    strOut.append("----");
    strOut.append("\r\n");

    // The JSON passed in the HTTP POST for updating is the inner content of the Employee
    CkJsonObject *updateJson = json.ObjectOf("Employee");

    // Add or update the Line1 of the PrimaryAddr.
    updateJson->UpdateString("PrimaryAddr.Line1","2W 298 Campton Hills Rd.");

    // Examine the JSON we'll be sending in the body of the POST.
    updateJson->put_EmitCompact(false);
    strOut.append(updateJson->emit());
    strOut.append("\r\n");
    strOut.append("----");
    strOut.append("\r\n");

    // Now we're going to POST the changes to update the Quickbooks account.
    rest.ClearAllHeaders();
    rest.put_Authorization(sbAuth.getAsString());
    rest.AddHeader("Accept","application/json");
    rest.AddHeader("Content-Type","application/json");

    // The updated JSON is passed as the HTTP request body.
    // (The employee ID is specified in the JSON body of the request, and therefore is is not in the path.)
    responseBody = rest.fullRequestString("POST","/v3/company/123146096291789/employee?minorversion=45",updateJson->emit());
    if (rest.get_LastMethodSuccess() != true) {
        strOut.append(rest.lastErrorText());
        strOut.append("\r\n");
        delete updateJson;
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // We should expect a 200 response if successful.
    if (rest.get_ResponseStatusCode() != 200) {
        strOut.append("Request Header: ");
        strOut.append("\r\n");
        strOut.append(rest.lastRequestHeader());
        strOut.append("\r\n");
        strOut.append("----");
        strOut.append("\r\n");
        strOut.append("Response StatusCode = ");
        strOut.appendInt(rest.get_ResponseStatusCode());
        strOut.append("\r\n");
        strOut.append("Response StatusLine: ");
        strOut.append(rest.responseStatusText());
        strOut.append("\r\n");
        strOut.append("Response Header:");
        strOut.append("\r\n");
        strOut.append(rest.responseHeader());
        strOut.append("\r\n");
        strOut.append(responseBody);
        strOut.append("\r\n");
        delete updateJson;
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    delete updateJson;

    // Load the JSON response into a JSON object to emit in indented form..
    json.Load(responseBody);
    strOut.append(json.emit());
    strOut.append("\r\n");

    // Use this online tool to generate parsing code from sample JSON: 
    // Generate Parsing Code from JSON

    strOut.append("Success.");
    strOut.append("\r\n");


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }