(Visual FoxPro) Upsert Catalog Object

Creates or updates the target CatalogObject.

For more information, see https://developer.squareup.com/reference/square/catalog-api/upsert-catalog-object

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

LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp
LOCAL loSbResponseBody
LOCAL loJResp
LOCAL lnRespStatusCode
LOCAL lcClient_object_id
LOCAL lcObject_id
LOCAL lcCatalog_objectType
LOCAL lcCatalog_objectId
LOCAL lcCatalog_objectUpdated_at
LOCAL lnCatalog_objectVersion
LOCAL lnCatalog_objectIs_deleted
LOCAL lcCatalog_objectItem_dataName
LOCAL lcCatalog_objectItem_dataDescription
LOCAL lcCatalog_objectItem_dataAbbreviation
LOCAL i
LOCAL lnCount_i

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')

* Implements the following CURL command:

* curl https://connect.squareup.com/v2/catalog/object \
*   -X POST \
*   -H 'Square-Version: 2020-07-22' \
*   -H 'Authorization: Bearer ACCESS_TOKEN' \
*   -H 'Content-Type: application/json' \
*   -d '{
*     "idempotency_key": "af3d1afc-7212-4300-b463-0bfc5314a5ae",
*     "object": {
*       "type": "ITEM",
*       "id": "#Cocoa",
*       "item_data": {
*         "name": "Cocoa",
*         "description": "Hot chocolate",
*         "abbreviation": "Ch"
*       }
*     }
*   }'

* Use the following online tool to generate HTTP code from a CURL command
* Convert a cURL Command to HTTP Source Code

* Use this online tool to generate code from sample JSON:
* Generate Code to Create JSON

* The following JSON is sent in the request body.

* {
*   "idempotency_key": "af3d1afc-7212-4300-b463-0bfc5314a5ae",
*   "object": {
*     "type": "ITEM",
*     "id": "#Cocoa",
*     "item_data": {
*       "name": "Cocoa",
*       "description": "Hot chocolate",
*       "abbreviation": "Ch"
*     }
*   }
* }

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("idempotency_key","af3d1afc-7212-4300-b463-0bfc5314a5ae")
loJson.UpdateString("object.type","ITEM")
loJson.UpdateString("object.id","#Cocoa")
loJson.UpdateString("object.item_data.name","Cocoa")
loJson.UpdateString("object.item_data.description","Hot chocolate")
loJson.UpdateString("object.item_data.abbreviation","Ch")

* Adds the "Authorization: Bearer ACCESS_TOKEN" header.
loHttp.AuthToken = "ACCESS_TOKEN"
loHttp.SetRequestHeader("Square-Version","2020-07-22")
loHttp.SetRequestHeader("Content-Type","application/json")

* This example uses the sandbox: connect.squareupsandbox.com
* Production should use connect.squareup.com
loResp = loHttp.PostJson3("https://connect.squareupsandbox.com/v2/catalog/object","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    CANCEL
ENDIF

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbResponseBody = CreateObject('Chilkat.StringBuilder')
loResp.GetBodySb(loSbResponseBody)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJResp = CreateObject('Chilkat.JsonObject')
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = 0

? "Response Body:"
? loJResp.Emit()

lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + STR(lnRespStatusCode)
IF (lnRespStatusCode >= 400) THEN
    ? "Response Header:"
    ? loResp.Header
    ? "Failed."
    RELEASE loResp
    RELEASE loHttp
    RELEASE loJson
    RELEASE loSbResponseBody
    RELEASE loJResp
    CANCEL
ENDIF

RELEASE loResp

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

* {
*   "catalog_object": {
*     "type": "ITEM",
*     "id": "7SB3ZQYJ5GDMVFL7JK46JCHT",
*     "updated_at": "2016-11-16T22:32:42.996Z",
*     "version": 1479335562996,
*     "is_deleted": false,
*     "item_data": {
*       "name": "Cocoa",
*       "description": "Hot chocolate",
*       "abbreviation": "Ch"
*     }
*   },
*   "id_mappings": [
*     {
*       "client_object_id": "#Cocoa",
*       "object_id": "7SB3ZQYJ5GDMVFL7JK46JCHT"
*     }
*   ]
* }

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

lcCatalog_objectType = loJResp.StringOf("catalog_object.type")
lcCatalog_objectId = loJResp.StringOf("catalog_object.id")
lcCatalog_objectUpdated_at = loJResp.StringOf("catalog_object.updated_at")
lnCatalog_objectVersion = loJResp.IntOf("catalog_object.version")
lnCatalog_objectIs_deleted = loJResp.BoolOf("catalog_object.is_deleted")
lcCatalog_objectItem_dataName = loJResp.StringOf("catalog_object.item_data.name")
lcCatalog_objectItem_dataDescription = loJResp.StringOf("catalog_object.item_data.description")
lcCatalog_objectItem_dataAbbreviation = loJResp.StringOf("catalog_object.item_data.abbreviation")
i = 0
lnCount_i = loJResp.SizeOfArray("id_mappings")
DO WHILE i < lnCount_i
    loJResp.I = i
    lcClient_object_id = loJResp.StringOf("id_mappings[i].client_object_id")
    lcObject_id = loJResp.StringOf("id_mappings[i].object_id")
    i = i + 1
ENDDO

RELEASE loHttp
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp