Foxpro / ShipEngine Walkthrough / Label messages (reference fields)
Back to Collection Items
LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp
LOCAL loSbResponseBody
LOCAL loJResp
LOCAL lnRespStatusCode
LOCAL lnValue
LOCAL lcUnit
LOCAL lcDimensionsUnit
LOCAL lnLength
LOCAL lnWidth
LOCAL lnHeight
LOCAL lcInsured_valueCurrency
LOCAL lnInsured_valueAmount
LOCAL lcReference1
LOCAL lcReference2
LOCAL lcReference3
LOCAL lcExternal_package_id
LOCAL lcLabel_id
LOCAL lcStatus
LOCAL lcShipment_id
LOCAL lcShip_date
LOCAL lcCreated_at
LOCAL lcV_Currency
LOCAL lcAmount
LOCAL lcInsurance_costCurrency
LOCAL lnInsurance_costAmount
LOCAL lcTracking_number
LOCAL lnIs_return_label
LOCAL lcRma_number
LOCAL lnIs_international
LOCAL lcBatch_id
LOCAL lcCarrier_id
LOCAL lcService_code
LOCAL lcPackage_code
LOCAL lnVoided
LOCAL lcVoided_at
LOCAL lcLabel_format
LOCAL lcLabel_layout
LOCAL lnTrackable
LOCAL lcCarrier_code
LOCAL lcTracking_status
LOCAL lcV_Pdf
LOCAL lcPng
LOCAL lcZpl
LOCAL lcHref
LOCAL lcForm_download
LOCAL lcInsurance_claim
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')
* Use this online tool to generate code from sample JSON: Generate Code to Create JSON
* The following JSON is sent in the request body.
* {
* "shipment": {
* "service_code": "usps_priority_mail",
* "ship_from": {
* "name": "John Doe",
* "company_name": "Example Corp.",
* "address_line1": "4009 Marathon Blvd",
* "city_locality": "Austin",
* "state_province": "TX",
* "postal_code": "78756",
* "country_code": "US",
* "phone": "512-555-5555"
* },
* "ship_to": {
* "name": "Amanda Miller",
* "address_line1": "525 S Winchester Blvd",
* "city_locality": "San Jose",
* "state_province": "CA",
* "postal_code": "95128",
* "country_code": "US"
* },
* "packages": [
* {
* "weight": {
* "value": 17,
* "unit": "pound"
* },
* "dimensions": {
* "length": 36,
* "width": 12,
* "height": 24,
* "unit": "inch"
* },
* "label_messages": {
* "reference1": "AAAAAAAAAAAAAAA",
* "reference2": "BBBBBBBBBBBBBBB",
* "reference3": "CCCCCCCCCCCCCCC"
* }
* }
* ]
* }
* }
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("shipment.service_code","usps_priority_mail")
loJson.UpdateString("shipment.ship_from.name","John Doe")
loJson.UpdateString("shipment.ship_from.company_name","Example Corp.")
loJson.UpdateString("shipment.ship_from.address_line1","4009 Marathon Blvd")
loJson.UpdateString("shipment.ship_from.city_locality","Austin")
loJson.UpdateString("shipment.ship_from.state_province","TX")
loJson.UpdateString("shipment.ship_from.postal_code","78756")
loJson.UpdateString("shipment.ship_from.country_code","US")
loJson.UpdateString("shipment.ship_from.phone","512-555-5555")
loJson.UpdateString("shipment.ship_to.name","Amanda Miller")
loJson.UpdateString("shipment.ship_to.address_line1","525 S Winchester Blvd")
loJson.UpdateString("shipment.ship_to.city_locality","San Jose")
loJson.UpdateString("shipment.ship_to.state_province","CA")
loJson.UpdateString("shipment.ship_to.postal_code","95128")
loJson.UpdateString("shipment.ship_to.country_code","US")
loJson.UpdateInt("shipment.packages[0].weight.value",17)
loJson.UpdateString("shipment.packages[0].weight.unit","pound")
loJson.UpdateInt("shipment.packages[0].dimensions.length",36)
loJson.UpdateInt("shipment.packages[0].dimensions.width",12)
loJson.UpdateInt("shipment.packages[0].dimensions.height",24)
loJson.UpdateString("shipment.packages[0].dimensions.unit","inch")
loJson.UpdateString("shipment.packages[0].label_messages.reference1","AAAAAAAAAAAAAAA")
loJson.UpdateString("shipment.packages[0].label_messages.reference2","BBBBBBBBBBBBBBB")
loJson.UpdateString("shipment.packages[0].label_messages.reference3","CCCCCCCCCCCCCCC")
loHttp.SetRequestHeader("API-Key","{{API_KEY}}")
loHttp.SetRequestHeader("Content-Type","application/json")
loResp = loHttp.PostJson3("https://api.shipengine.com/v1/labels","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)
* {
* "label_id": "se-1387921",
* "status": "completed",
* "shipment_id": "se-4159604",
* "ship_date": "2019-09-18T00:00:00Z",
* "created_at": "2019-09-18T15:56:29.2745108Z",
* "shipment_cost": {
* "currency": "usd",
* "amount": 98.14
* },
* "insurance_cost": {
* "currency": "usd",
* "amount": 0
* },
* "tracking_number": "9405511899564298877610",
* "is_return_label": false,
* "rma_number": null,
* "is_international": false,
* "batch_id": "",
* "carrier_id": "se-121861",
* "service_code": "usps_priority_mail",
* "package_code": "package",
* "voided": false,
* "voided_at": null,
* "label_format": "pdf",
* "label_layout": "4x6",
* "trackable": true,
* "carrier_code": "stamps_com",
* "tracking_status": "in_transit",
* "label_download": {
* "pdf": "https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.pdf",
* "png": "https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.png",
* "zpl": "https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.zpl",
* "href": "https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.pdf"
* },
* "form_download": null,
* "insurance_claim": null,
* "packages": [
* {
* "package_code": "package",
* "weight": {
* "value": 17,
* "unit": "pound"
* },
* "dimensions": {
* "unit": "inch",
* "length": 36,
* "width": 12,
* "height": 24
* },
* "insured_value": {
* "currency": "usd",
* "amount": 0
* },
* "tracking_number": "9405511899564298877610",
* "label_messages": {
* "reference1": "AAAAAAAAAAAAAAA",
* "reference2": "BBBBBBBBBBBBBBB",
* "reference3": "CCCCCCCCCCCCCCC"
* },
* "external_package_id": null
* }
* ]
* }
* Sample code for parsing the JSON response...
* Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
lcLabel_id = loJResp.StringOf("label_id")
lcStatus = loJResp.StringOf("status")
lcShipment_id = loJResp.StringOf("shipment_id")
lcShip_date = loJResp.StringOf("ship_date")
lcCreated_at = loJResp.StringOf("created_at")
lcV_Currency = loJResp.StringOf("shipment_cost.currency")
lcAmount = loJResp.StringOf("shipment_cost.amount")
lcInsurance_costCurrency = loJResp.StringOf("insurance_cost.currency")
lnInsurance_costAmount = loJResp.IntOf("insurance_cost.amount")
lcTracking_number = loJResp.StringOf("tracking_number")
lnIs_return_label = loJResp.BoolOf("is_return_label")
lcRma_number = loJResp.StringOf("rma_number")
lnIs_international = loJResp.BoolOf("is_international")
lcBatch_id = loJResp.StringOf("batch_id")
lcCarrier_id = loJResp.StringOf("carrier_id")
lcService_code = loJResp.StringOf("service_code")
lcPackage_code = loJResp.StringOf("package_code")
lnVoided = loJResp.BoolOf("voided")
lcVoided_at = loJResp.StringOf("voided_at")
lcLabel_format = loJResp.StringOf("label_format")
lcLabel_layout = loJResp.StringOf("label_layout")
lnTrackable = loJResp.BoolOf("trackable")
lcCarrier_code = loJResp.StringOf("carrier_code")
lcTracking_status = loJResp.StringOf("tracking_status")
lcV_Pdf = loJResp.StringOf("label_download.pdf")
lcPng = loJResp.StringOf("label_download.png")
lcZpl = loJResp.StringOf("label_download.zpl")
lcHref = loJResp.StringOf("label_download.href")
lcForm_download = loJResp.StringOf("form_download")
lcInsurance_claim = loJResp.StringOf("insurance_claim")
i = 0
lnCount_i = loJResp.SizeOfArray("packages")
DO WHILE i < lnCount_i
loJResp.I = i
lcPackage_code = loJResp.StringOf("packages[i].package_code")
lnValue = loJResp.IntOf("packages[i].weight.value")
lcUnit = loJResp.StringOf("packages[i].weight.unit")
lcDimensionsUnit = loJResp.StringOf("packages[i].dimensions.unit")
lnLength = loJResp.IntOf("packages[i].dimensions.length")
lnWidth = loJResp.IntOf("packages[i].dimensions.width")
lnHeight = loJResp.IntOf("packages[i].dimensions.height")
lcInsured_valueCurrency = loJResp.StringOf("packages[i].insured_value.currency")
lnInsured_valueAmount = loJResp.IntOf("packages[i].insured_value.amount")
lcTracking_number = loJResp.StringOf("packages[i].tracking_number")
lcReference1 = loJResp.StringOf("packages[i].label_messages.reference1")
lcReference2 = loJResp.StringOf("packages[i].label_messages.reference2")
lcReference3 = loJResp.StringOf("packages[i].label_messages.reference3")
lcExternal_package_id = loJResp.StringOf("packages[i].external_package_id")
i = i + 1
ENDDO
RELEASE loHttp
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp
Curl Command
curl -X POST
-H "API-Key: {{API_KEY}}"
-H "Content-Type: application/json"
-d '{
"shipment": {
"service_code": "usps_priority_mail",
"ship_from": {
"name": "John Doe",
"company_name": "Example Corp.",
"address_line1": "4009 Marathon Blvd",
"city_locality": "Austin",
"state_province": "TX",
"postal_code": "78756",
"country_code": "US",
"phone": "512-555-5555"
},
"ship_to": {
"name": "Amanda Miller",
"address_line1": "525 S Winchester Blvd",
"city_locality": "San Jose",
"state_province": "CA",
"postal_code": "95128",
"country_code": "US"
},
"packages": [
{
"weight": {
"value": 17,
"unit": "pound"
},
"dimensions": {
"length": 36,
"width": 12,
"height": 24,
"unit": "inch"
},
"label_messages": {
"reference1": "AAAAAAAAAAAAAAA",
"reference2": "BBBBBBBBBBBBBBB",
"reference3": "CCCCCCCCCCCCCCC"
}
}
]
}
}'
https://api.shipengine.com/v1/labels
Postman Collection Item JSON
{
"name": "Label messages (reference fields)",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipment\": {\n\t\t\"service_code\": \"usps_priority_mail\",\n\t\t\"ship_from\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"company_name\": \"Example Corp.\",\n\t\t\t\"address_line1\": \"4009 Marathon Blvd\",\n\t\t\t\"city_locality\": \"Austin\",\n\t\t\t\"state_province\": \"TX\",\n\t\t\t\"postal_code\": \"78756\",\n\t\t\t\"country_code\": \"US\",\n\t\t\t\"phone\": \"512-555-5555\"\n\t\t},\n\t\t\"ship_to\": {\n\t\t\t\"name\": \"Amanda Miller\",\n\t\t\t\"address_line1\": \"525 S Winchester Blvd\",\n\t\t\t\"city_locality\": \"San Jose\",\n\t\t\t\"state_province\": \"CA\",\n\t\t\t\"postal_code\": \"95128\",\n\t\t\t\"country_code\": \"US\"\n\t\t},\n\t\t\"packages\": [\n\t\t\t{\n\t\t\t\t\"weight\": {\n\t\t\t\t\t\"value\": 17,\n\t\t\t\t\t\"unit\": \"pound\"\n\t\t\t\t},\n\t\t\t\t\"dimensions\": {\n\t\t\t\t\t\"length\": 36,\n\t\t\t\t\t\"width\": 12,\n\t\t\t\t\t\"height\": 24,\n\t\t\t\t\t\"unit\": \"inch\"\n\t\t\t\t},\n\t\t\t\t\"label_messages\": {\n\t\t\t\t\t\"reference1\": \"AAAAAAAAAAAAAAA\",\n\t\t\t\t\t\"reference2\": \"BBBBBBBBBBBBBBB\",\n\t\t\t\t\t\"reference3\": \"CCCCCCCCCCCCCCC\"\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t}\n}"
},
"url": {
"raw": "https://api.shipengine.com/v1/labels",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"labels"
]
},
"description": "Label messages can be used for a number of reasons; but, primarily are used for reference numbers or internal tracking messages. You can add separate label messages to each package in a shipment."
},
"response": [
{
"name": "Label messages (reference fields)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipment\": {\n\t\t\"service_code\": \"usps_priority_mail\",\n\t\t\"ship_from\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"company_name\": \"Example Corp.\",\n\t\t\t\"address_line1\": \"4009 Marathon Blvd\",\n\t\t\t\"city_locality\": \"Austin\",\n\t\t\t\"state_province\": \"TX\",\n\t\t\t\"postal_code\": \"78756\",\n\t\t\t\"country_code\": \"US\",\n\t\t\t\"phone\": \"512-555-5555\"\n\t\t},\n\t\t\"ship_to\": {\n\t\t\t\"name\": \"Amanda Miller\",\n\t\t\t\"address_line1\": \"525 S Winchester Blvd\",\n\t\t\t\"city_locality\": \"San Jose\",\n\t\t\t\"state_province\": \"CA\",\n\t\t\t\"postal_code\": \"95128\",\n\t\t\t\"country_code\": \"US\"\n\t\t},\n\t\t\"packages\": [\n\t\t\t{\n\t\t\t\t\"weight\": {\n\t\t\t\t\t\"value\": 17,\n\t\t\t\t\t\"unit\": \"pound\"\n\t\t\t\t},\n\t\t\t\t\"dimensions\": {\n\t\t\t\t\t\"length\": 36,\n\t\t\t\t\t\"width\": 12,\n\t\t\t\t\t\"height\": 24,\n\t\t\t\t\t\"unit\": \"inch\"\n\t\t\t\t},\n\t\t\t\t\"label_messages\": {\n\t\t\t\t\t\"reference1\": \"AAAAAAAAAAAAAAA\",\n\t\t\t\t\t\"reference2\": \"BBBBBBBBBBBBBBB\",\n\t\t\t\t\t\"reference3\": \"CCCCCCCCCCCCCCC\"\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t}\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.shipengine.com/v1/labels",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"labels"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Wed, 18 Sep 2019 15:56:30 GMT"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Content-Length",
"value": "1859"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Access-Control-Allow-Origin",
"value": "https://www.shipengine.com"
},
{
"key": "Vary",
"value": "Origin"
},
{
"key": "server",
"value": "Microsoft-IIS/8.0"
},
{
"key": "x-newrelic-app-data",
"value": "PxQGVFZXCgITVVZbAwMCV1YGFB9AMQYAZBBZDEtZV0ZaCldOZgRRIzR/GC0HAV1fQ0sxF0VSXwcXVHpSAAMPQBxSFlIUCRoDB1MKVQhYAk5cAAZNRCd5A3NXUVMEc3FVUQBzdVtETwRRDksHZQ=="
},
{
"key": "x-powered-by",
"value": "ASP.NET"
},
{
"key": "x-shipengine-environment",
"value": "j"
},
{
"key": "x-shipengine-requestid",
"value": "3be69b3d-c0d6-49e8-8628-2c0c1ffe93e7"
},
{
"key": "x-shipengine-server",
"value": "SS-J-WEB03"
}
],
"cookie": [
],
"body": "{\n \"label_id\": \"se-1387921\",\n \"status\": \"completed\",\n \"shipment_id\": \"se-4159604\",\n \"ship_date\": \"2019-09-18T00:00:00Z\",\n \"created_at\": \"2019-09-18T15:56:29.2745108Z\",\n \"shipment_cost\": {\n \"currency\": \"usd\",\n \"amount\": 98.14\n },\n \"insurance_cost\": {\n \"currency\": \"usd\",\n \"amount\": 0\n },\n \"tracking_number\": \"9405511899564298877610\",\n \"is_return_label\": false,\n \"rma_number\": null,\n \"is_international\": false,\n \"batch_id\": \"\",\n \"carrier_id\": \"se-121861\",\n \"service_code\": \"usps_priority_mail\",\n \"package_code\": \"package\",\n \"voided\": false,\n \"voided_at\": null,\n \"label_format\": \"pdf\",\n \"label_layout\": \"4x6\",\n \"trackable\": true,\n \"carrier_code\": \"stamps_com\",\n \"tracking_status\": \"in_transit\",\n \"label_download\": {\n \"pdf\": \"https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.pdf\",\n \"png\": \"https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.png\",\n \"zpl\": \"https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.zpl\",\n \"href\": \"https://api.shipengine.com/v1/downloads/10/J963EZk9hkGqG4aN3JQ3bw/label-1387921.pdf\"\n },\n \"form_download\": null,\n \"insurance_claim\": null,\n \"packages\": [\n {\n \"package_code\": \"package\",\n \"weight\": {\n \"value\": 17,\n \"unit\": \"pound\"\n },\n \"dimensions\": {\n \"unit\": \"inch\",\n \"length\": 36,\n \"width\": 12,\n \"height\": 24\n },\n \"insured_value\": {\n \"currency\": \"usd\",\n \"amount\": 0\n },\n \"tracking_number\": \"9405511899564298877610\",\n \"label_messages\": {\n \"reference1\": \"AAAAAAAAAAAAAAA\",\n \"reference2\": \"BBBBBBBBBBBBBBB\",\n \"reference3\": \"CCCCCCCCCCCCCCC\"\n },\n \"external_package_id\": null\n }\n ]\n}"
}
]
}
