Xbase++
Xbase++
Quickbooks Create a New Customer
See more QuickBooks Examples
Demonstrates how to create a new customer via the Quickbooks REST API.Chilkat Xbase++ Downloads
LOCAL nSuccess
LOCAL oJsonToken
LOCAL oRest
LOCAL nBTls
LOCAL nPort
LOCAL nBAutoReconnect
LOCAL oSbAuth
LOCAL oJsonReq
LOCAL oSbRequestBody
LOCAL oSbResponseBody
LOCAL nRespStatusCode
LOCAL oJsonResponse
LOCAL cCustomerDomain
LOCAL cCustomerPrimaryEmailAddrAddress
LOCAL cCustomerDisplayName
LOCAL cCustomerCurrencyRefName
LOCAL cCustomerCurrencyRefValue
LOCAL cCustomerDefaultTaxCodeRefValue
LOCAL cCustomerPreferredDeliveryMethod
LOCAL cCustomerGivenName
LOCAL cCustomerFullyQualifiedName
LOCAL nCustomerBillWithParent
LOCAL cCustomerTitle
LOCAL nCustomerJob
LOCAL nCustomerBalanceWithJobs
LOCAL cCustomerPrimaryPhoneFreeFormNumber
LOCAL nCustomerTaxable
LOCAL cCustomerMetaDataCreateTime
LOCAL cCustomerMetaDataLastUpdatedTime
LOCAL cCustomerBillAddrCity
LOCAL cCustomerBillAddrCountry
LOCAL cCustomerBillAddrLine1
LOCAL cCustomerBillAddrPostalCode
LOCAL cCustomerBillAddrCountrySubDivisionCode
LOCAL cCustomerBillAddrId
LOCAL cCustomerMiddleName
LOCAL cCustomerNotes
LOCAL nCustomerActive
LOCAL nCustomerBalance
LOCAL cCustomerSyncToken
LOCAL cCustomerSuffix
LOCAL cCustomerCompanyName
LOCAL cCustomerFamilyName
LOCAL cCustomerPrintOnCheckName
LOCAL nCustomerSparse
LOCAL cCustomerId
LOCAL cTime
nSuccess := 0
// 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.
oJsonToken := CreateObject("Chilkat.JsonObject")
nSuccess := oJsonToken:LoadFile("qa_data/tokens/qb-access-token.json")
oRest := CreateObject("Chilkat.Rest")
// Connect to the REST server.
nBTls := 1
nPort := 443
nBAutoReconnect := 1
nSuccess := oRest:Connect("sandbox-quickbooks.api.intuit.com", nPort, nBTls, nBAutoReconnect)
oSbAuth := CreateObject("Chilkat.StringBuilder")
oSbAuth:Append("Bearer ")
oSbAuth:Append(oJsonToken:StringOf("access_token"))
oRest:Authorization := oSbAuth:GetAsString()
// --------------------------------------------------------------------------
// Note: The above code to setup the initial REST connection
// can be done once. After connecting, any number of REST calls can be made.
// If the connection is lost, the next REST method call will automatically
// reconnect if needed.
// --------------------------------------------------------------------------
// Create the following JSON:
// {
// "FullyQualifiedName": "King Groceries",
// "PrimaryEmailAddr": {
// "Address": "jdrew@myemail.com"
// },
// "DisplayName": "King's Groceries",
// "Suffix": "Jr",
// "Title": "Mr",
// "MiddleName": "B",
// "Notes": "Here are other details.",
// "FamilyName": "King",
// "PrimaryPhone": {
// "FreeFormNumber": "(555) 555-5555"
// },
// "CompanyName": "King Groceries",
// "BillAddr": {
// "CountrySubDivisionCode": "CA",
// "City": "Mountain View",
// "PostalCode": "94042",
// "Line1": "123 Main Street",
// "Country": "USA"
// },
// "GivenName": "James"
// }
//
// Use the this online tool to generate the code from sample JSON:
// Generate Code to Create JSON
oJsonReq := CreateObject("Chilkat.JsonObject")
oJsonReq:UpdateString("FullyQualifiedName", "King Groceries")
oJsonReq:UpdateString("PrimaryEmailAddr.Address", "jdrew@myemail.com")
oJsonReq:UpdateString("DisplayName", "King's Groceries")
oJsonReq:UpdateString("Suffix", "Jr")
oJsonReq:UpdateString("Title", "Mr")
oJsonReq:UpdateString("MiddleName", "B")
oJsonReq:UpdateString("Notes", "Here are other details.")
oJsonReq:UpdateString("FamilyName", "King")
oJsonReq:UpdateString("PrimaryPhone.FreeFormNumber", "(555) 555-5555")
oJsonReq:UpdateString("CompanyName", "King Groceries")
oJsonReq:UpdateString("BillAddr.CountrySubDivisionCode", "CA")
oJsonReq:UpdateString("BillAddr.City", "Mountain View")
oJsonReq:UpdateString("BillAddr.PostalCode", "94042")
oJsonReq:UpdateString("BillAddr.Line1", "123 Main Street")
oJsonReq:UpdateString("BillAddr.Country", "USA")
oJsonReq:UpdateString("GivenName", "James")
oSbRequestBody := CreateObject("Chilkat.StringBuilder")
oJsonReq:EmitSb(oSbRequestBody)
oRest:AddHeader("Content-Type", "application/json")
oRest:AddHeader("Accept", "application/json")
oRest:AllowHeaderFolding := 0
oSbResponseBody := CreateObject("Chilkat.StringBuilder")
nSuccess := oRest:FullRequestSb("POST", "/v3/company/<realmID>/customer", oSbRequestBody, oSbResponseBody)
IF (nSuccess != 1)
? oRest:LastErrorText
oJsonToken:destroy()
oRest:destroy()
oSbAuth:destroy()
oJsonReq:destroy()
oSbRequestBody:destroy()
oSbResponseBody:destroy()
RETURN
ENDIF
nRespStatusCode := oRest:ResponseStatusCode
// Success is indicated by a 200 response status code.
? "response status code = " + Str(nRespStatusCode)
oJsonResponse := CreateObject("Chilkat.JsonObject")
oJsonResponse:LoadSb(oSbResponseBody)
oJsonResponse:EmitCompact := 0
? oJsonResponse:Emit()
IF (oRest:ResponseStatusCode != 200)
? "Failed."
oJsonToken:destroy()
oRest:destroy()
oSbAuth:destroy()
oJsonReq:destroy()
oSbRequestBody:destroy()
oSbResponseBody:destroy()
oJsonResponse:destroy()
RETURN
ENDIF
// Sample output...
// (See the parsing code below..)
//
// Use the this online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
// {
// "Customer": {
// "domain": "QBO",
// "PrimaryEmailAddr": {
// "Address": "jdrew@myemail.com"
// },
// "DisplayName": "King's Groceries",
// "CurrencyRef": {
// "name": "United States Dollar",
// "value": "USD"
// },
// "DefaultTaxCodeRef": {
// "value": "2"
// },
// "PreferredDeliveryMethod": "Print",
// "GivenName": "James",
// "FullyQualifiedName": "King's Groceries",
// "BillWithParent": false,
// "Title": "Mr",
// "Job": false,
// "BalanceWithJobs": 0,
// "PrimaryPhone": {
// "FreeFormNumber": "(555) 555-5555"
// },
// "Taxable": true,
// "MetaData": {
// "CreateTime": "2015-07-23T10:58:12-07:00",
// "LastUpdatedTime": "2015-07-23T10:58:12-07:00"
// },
// "BillAddr": {
// "City": "Mountain View",
// "Country": "USA",
// "Line1": "123 Main Street",
// "PostalCode": "94042",
// "CountrySubDivisionCode": "CA",
// "Id": "112"
// },
// "MiddleName": "B",
// "Notes": "Here are other details.",
// "Active": true,
// "Balance": 0,
// "SyncToken": "0",
// "Suffix": "Jr",
// "CompanyName": "King Groceries",
// "FamilyName": "King",
// "PrintOnCheckName": "King Groceries",
// "sparse": false,
// "Id": "67"
// },
// "time": "2015-07-23T10:58:12.099-07:00"
// }
//
cCustomerDomain := oJsonResponse:StringOf("Customer.domain")
cCustomerPrimaryEmailAddrAddress := oJsonResponse:StringOf("Customer.PrimaryEmailAddr.Address")
cCustomerDisplayName := oJsonResponse:StringOf("Customer.DisplayName")
cCustomerCurrencyRefName := oJsonResponse:StringOf("Customer.CurrencyRef.name")
cCustomerCurrencyRefValue := oJsonResponse:StringOf("Customer.CurrencyRef.value")
cCustomerDefaultTaxCodeRefValue := oJsonResponse:StringOf("Customer.DefaultTaxCodeRef.value")
cCustomerPreferredDeliveryMethod := oJsonResponse:StringOf("Customer.PreferredDeliveryMethod")
cCustomerGivenName := oJsonResponse:StringOf("Customer.GivenName")
cCustomerFullyQualifiedName := oJsonResponse:StringOf("Customer.FullyQualifiedName")
nCustomerBillWithParent := oJsonResponse:BoolOf("Customer.BillWithParent")
cCustomerTitle := oJsonResponse:StringOf("Customer.Title")
nCustomerJob := oJsonResponse:BoolOf("Customer.Job")
nCustomerBalanceWithJobs := oJsonResponse:IntOf("Customer.BalanceWithJobs")
cCustomerPrimaryPhoneFreeFormNumber := oJsonResponse:StringOf("Customer.PrimaryPhone.FreeFormNumber")
nCustomerTaxable := oJsonResponse:BoolOf("Customer.Taxable")
cCustomerMetaDataCreateTime := oJsonResponse:StringOf("Customer.MetaData.CreateTime")
cCustomerMetaDataLastUpdatedTime := oJsonResponse:StringOf("Customer.MetaData.LastUpdatedTime")
cCustomerBillAddrCity := oJsonResponse:StringOf("Customer.BillAddr.City")
cCustomerBillAddrCountry := oJsonResponse:StringOf("Customer.BillAddr.Country")
cCustomerBillAddrLine1 := oJsonResponse:StringOf("Customer.BillAddr.Line1")
cCustomerBillAddrPostalCode := oJsonResponse:StringOf("Customer.BillAddr.PostalCode")
cCustomerBillAddrCountrySubDivisionCode := oJsonResponse:StringOf("Customer.BillAddr.CountrySubDivisionCode")
cCustomerBillAddrId := oJsonResponse:StringOf("Customer.BillAddr.Id")
cCustomerMiddleName := oJsonResponse:StringOf("Customer.MiddleName")
cCustomerNotes := oJsonResponse:StringOf("Customer.Notes")
nCustomerActive := oJsonResponse:BoolOf("Customer.Active")
nCustomerBalance := oJsonResponse:IntOf("Customer.Balance")
cCustomerSyncToken := oJsonResponse:StringOf("Customer.SyncToken")
cCustomerSuffix := oJsonResponse:StringOf("Customer.Suffix")
cCustomerCompanyName := oJsonResponse:StringOf("Customer.CompanyName")
cCustomerFamilyName := oJsonResponse:StringOf("Customer.FamilyName")
cCustomerPrintOnCheckName := oJsonResponse:StringOf("Customer.PrintOnCheckName")
nCustomerSparse := oJsonResponse:BoolOf("Customer.sparse")
cCustomerId := oJsonResponse:StringOf("Customer.Id")
cTime := oJsonResponse:StringOf("time")
oJsonToken:destroy()
oRest:destroy()
oSbAuth:destroy()
oJsonReq:destroy()
oSbRequestBody:destroy()
oSbResponseBody:destroy()
oJsonResponse:destroy()