PHP (Extension) / ShipEngine Walkthrough / Validate when creating a shipment
Back to Collection Items
<?php
include("chilkat_9_5_0.php");
$json->UpdateString('shipments[0].validate_address','validate_and_clean');$json->UpdateString('shipments[0].service_code','usps_priority_mail');$json->UpdateString('shipments[0].ship_from.name','John Doe');$json->UpdateString('shipments[0].ship_from.company_name','Example Corp.');$json->UpdateString('shipments[0].ship_from.address_line1','4009 Marathon Blvd');$json->UpdateString('shipments[0].ship_from.city_locality','Austin');$json->UpdateString('shipments[0].ship_from.state_province','TX');$json->UpdateString('shipments[0].ship_from.postal_code','78756');$json->UpdateString('shipments[0].ship_from.country_code','US');$json->UpdateString('shipments[0].ship_from.phone','512-555-5555');$json->UpdateString('shipments[0].ship_to.name','Amanda Miller');$json->UpdateString('shipments[0].ship_to.address_line1','525 Winchester');$json->UpdateString('shipments[0].ship_to.postal_code','95128');$json->UpdateString('shipments[0].ship_to.country_code','US');$json->UpdateInt('shipments[0].packages[0].weight.value',17);$json->UpdateString('shipments[0].packages[0].weight.unit','pound');$json->UpdateInt('shipments[0].packages[0].dimensions.length',36);$json->UpdateInt('shipments[0].packages[0].dimensions.width',12);$json->UpdateInt('shipments[0].packages[0].dimensions.height',24);$json->UpdateString('shipments[0].packages[0].dimensions.unit','inch');$resp->GetBodySb($sbResponseBody);$jResp->LoadSb($sbResponseBody);$jResp->put_EmitCompact(false);$jResp->put_I($i);$Status = $jResp->stringOf('shipments[i].address_validation.status');$Name = $jResp->stringOf('shipments[i].address_validation.original_address.name');$Phone = $jResp->stringOf('shipments[i].address_validation.original_address.phone');$Company_name = $jResp->stringOf('shipments[i].address_validation.original_address.company_name');$Address_line1 = $jResp->stringOf('shipments[i].address_validation.original_address.address_line1');$Address_line2 = $jResp->stringOf('shipments[i].address_validation.original_address.address_line2');$Address_line3 = $jResp->stringOf('shipments[i].address_validation.original_address.address_line3');$City_locality = $jResp->stringOf('shipments[i].address_validation.original_address.city_locality');$State_province = $jResp->stringOf('shipments[i].address_validation.original_address.state_province');$Postal_code = $jResp->stringOf('shipments[i].address_validation.original_address.postal_code');$Country_code = $jResp->stringOf('shipments[i].address_validation.original_address.country_code');$Address_residential_indicator = $jResp->stringOf('shipments[i].address_validation.original_address.address_residential_indicator');$Matched_addressName = $jResp->stringOf('shipments[i].address_validation.matched_address.name');$Matched_addressPhone = $jResp->stringOf('shipments[i].address_validation.matched_address.phone');$Matched_addressCompany_name = $jResp->stringOf('shipments[i].address_validation.matched_address.company_name');$Matched_addressAddress_line1 = $jResp->stringOf('shipments[i].address_validation.matched_address.address_line1');$Matched_addressAddress_line2 = $jResp->stringOf('shipments[i].address_validation.matched_address.address_line2');$Matched_addressAddress_line3 = $jResp->stringOf('shipments[i].address_validation.matched_address.address_line3');$Matched_addressCity_locality = $jResp->stringOf('shipments[i].address_validation.matched_address.city_locality');$Matched_addressState_province = $jResp->stringOf('shipments[i].address_validation.matched_address.state_province');$Matched_addressPostal_code = $jResp->stringOf('shipments[i].address_validation.matched_address.postal_code');$Matched_addressCountry_code = $jResp->stringOf('shipments[i].address_validation.matched_address.country_code');$Matched_addressAddress_residential_indicator = $jResp->stringOf('shipments[i].address_validation.matched_address.address_residential_indicator');$shipment_id = $jResp->stringOf('shipments[i].shipment_id');$carrier_id = $jResp->stringOf('shipments[i].carrier_id');$service_code = $jResp->stringOf('shipments[i].service_code');$external_shipment_id = $jResp->stringOf('shipments[i].external_shipment_id');$ship_date = $jResp->stringOf('shipments[i].ship_date');$created_at = $jResp->stringOf('shipments[i].created_at');$modified_at = $jResp->stringOf('shipments[i].modified_at');$shipment_status = $jResp->stringOf('shipments[i].shipment_status');$ship_toName = $jResp->stringOf('shipments[i].ship_to.name');$ship_toPhone = $jResp->stringOf('shipments[i].ship_to.phone');$ship_toCompany_name = $jResp->stringOf('shipments[i].ship_to.company_name');$ship_toAddress_line1 = $jResp->stringOf('shipments[i].ship_to.address_line1');$ship_toAddress_line2 = $jResp->stringOf('shipments[i].ship_to.address_line2');$ship_toAddress_line3 = $jResp->stringOf('shipments[i].ship_to.address_line3');$ship_toCity_locality = $jResp->stringOf('shipments[i].ship_to.city_locality');$ship_toState_province = $jResp->stringOf('shipments[i].ship_to.state_province');$ship_toPostal_code = $jResp->stringOf('shipments[i].ship_to.postal_code');$ship_toCountry_code = $jResp->stringOf('shipments[i].ship_to.country_code');$ship_toAddress_residential_indicator = $jResp->stringOf('shipments[i].ship_to.address_residential_indicator');$ship_fromName = $jResp->stringOf('shipments[i].ship_from.name');$ship_fromPhone = $jResp->stringOf('shipments[i].ship_from.phone');$ship_fromCompany_name = $jResp->stringOf('shipments[i].ship_from.company_name');$ship_fromAddress_line1 = $jResp->stringOf('shipments[i].ship_from.address_line1');$ship_fromAddress_line2 = $jResp->stringOf('shipments[i].ship_from.address_line2');$ship_fromAddress_line3 = $jResp->stringOf('shipments[i].ship_from.address_line3');$ship_fromCity_locality = $jResp->stringOf('shipments[i].ship_from.city_locality');$ship_fromState_province = $jResp->stringOf('shipments[i].ship_from.state_province');$ship_fromPostal_code = $jResp->stringOf('shipments[i].ship_from.postal_code');$ship_fromCountry_code = $jResp->stringOf('shipments[i].ship_from.country_code');$ship_fromAddress_residential_indicator = $jResp->stringOf('shipments[i].ship_from.address_residential_indicator');$warehouse_id = $jResp->stringOf('shipments[i].warehouse_id');$return_toName = $jResp->stringOf('shipments[i].return_to.name');$return_toPhone = $jResp->stringOf('shipments[i].return_to.phone');$return_toCompany_name = $jResp->stringOf('shipments[i].return_to.company_name');$return_toAddress_line1 = $jResp->stringOf('shipments[i].return_to.address_line1');$return_toAddress_line2 = $jResp->stringOf('shipments[i].return_to.address_line2');$return_toAddress_line3 = $jResp->stringOf('shipments[i].return_to.address_line3');$return_toCity_locality = $jResp->stringOf('shipments[i].return_to.city_locality');$return_toState_province = $jResp->stringOf('shipments[i].return_to.state_province');$return_toPostal_code = $jResp->stringOf('shipments[i].return_to.postal_code');$return_toCountry_code = $jResp->stringOf('shipments[i].return_to.country_code');$return_toAddress_residential_indicator = $jResp->stringOf('shipments[i].return_to.address_residential_indicator');$confirmation = $jResp->stringOf('shipments[i].confirmation');$customs = $jResp->stringOf('shipments[i].customs');$external_order_id = $jResp->stringOf('shipments[i].external_order_id');$order_source_code = $jResp->stringOf('shipments[i].order_source_code');$Bill_to_account = $jResp->stringOf('shipments[i].advanced_options.bill_to_account');$Bill_to_country_code = $jResp->stringOf('shipments[i].advanced_options.bill_to_country_code');$Bill_to_party = $jResp->stringOf('shipments[i].advanced_options.bill_to_party');$Bill_to_postal_code = $jResp->stringOf('shipments[i].advanced_options.bill_to_postal_code');$Contains_alcohol = $jResp->BoolOf('shipments[i].advanced_options.contains_alcohol');$Delivered_duty_paid = $jResp->BoolOf('shipments[i].advanced_options.delivered_duty_paid');$Non_machinable = $jResp->BoolOf('shipments[i].advanced_options.non_machinable');$Saturday_delivery = $jResp->BoolOf('shipments[i].advanced_options.saturday_delivery');$Dry_ice = $jResp->BoolOf('shipments[i].advanced_options.dry_ice');$Dry_ice_weight = $jResp->stringOf('shipments[i].advanced_options.dry_ice_weight');$Freight_class = $jResp->stringOf('shipments[i].advanced_options.freight_class');$Custom_field1 = $jResp->stringOf('shipments[i].advanced_options.custom_field1');$Custom_field2 = $jResp->stringOf('shipments[i].advanced_options.custom_field2');$Custom_field3 = $jResp->stringOf('shipments[i].advanced_options.custom_field3');$insurance_provider = $jResp->stringOf('shipments[i].insurance_provider');$Value = $jResp->IntOf('shipments[i].total_weight.value');$Unit = $jResp->stringOf('shipments[i].total_weight.unit');$j = 0;$count_j = $jResp->SizeOfArray('shipments[i].errors');$jResp->put_J($j);$j = $j + 1;$j = 0;$count_j = $jResp->SizeOfArray('shipments[i].address_validation.messages');$jResp->put_J($j);$j = $j + 1;$j = 0;$count_j = $jResp->SizeOfArray('shipments[i].tags');$jResp->put_J($j);$j = $j + 1;$j = 0;$count_j = $jResp->SizeOfArray('shipments[i].packages');$jResp->put_J($j);$package_code = $jResp->stringOf('shipments[i].packages[j].package_code');$weightValue = $jResp->IntOf('shipments[i].packages[j].weight.value');$weightUnit = $jResp->stringOf('shipments[i].packages[j].weight.unit');$dimensionsUnit = $jResp->stringOf('shipments[i].packages[j].dimensions.unit');$Length = $jResp->IntOf('shipments[i].packages[j].dimensions.length');$Width = $jResp->IntOf('shipments[i].packages[j].dimensions.width');$Height = $jResp->IntOf('shipments[i].packages[j].dimensions.height');$v_Currency = $jResp->stringOf('shipments[i].packages[j].insured_value.currency');$Amount = $jResp->IntOf('shipments[i].packages[j].insured_value.amount');$Reference1 = $jResp->stringOf('shipments[i].packages[j].label_messages.reference1');$Reference2 = $jResp->stringOf('shipments[i].packages[j].label_messages.reference2');$Reference3 = $jResp->stringOf('shipments[i].packages[j].label_messages.reference3');$external_package_id = $jResp->stringOf('shipments[i].packages[j].external_package_id');$j = $j + 1;$j = 0;$count_j = $jResp->SizeOfArray('shipments[i].items');$jResp->put_J($j);$j = $j + 1;$i = $i + 1;
?>
Curl Command
curl -X POST
-H "API-Key: {{API_KEY}}"
-H "Content-Type: application/json"
-d '{
"shipments": [{
"validate_address": "validate_and_clean",
"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 Winchester",
"postal_code": "95128",
"country_code": "US"
},
"packages": [
{
"weight": {
"value": 17,
"unit": "pound"
},
"dimensions": {
"length": 36,
"width": 12,
"height": 24,
"unit": "inch"
}
}
]
}]
}'
https://api.shipengine.com/v1/shipments
Postman Collection Item JSON
{
"name": "Validate when creating a shipment",
"event": [
{
"listen": "test",
"script": {
"exec": [
"let response = pm.response.json();",
"",
"if (response.shipments.length > 0) {",
" pm.collectionVariables.set(\"shipment_id\", response.shipments[0].shipment_id);",
"}"
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipments\": [{\n\t\t\"validate_address\": \"validate_and_clean\",\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 Winchester\",\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}\n\t\t]\n\t}]\n}"
},
"url": {
"raw": "https://api.shipengine.com/v1/shipments",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"shipments"
]
},
"description": "You can validate the address at the same time as creating a shipment in ShipEngine by setting the `validate_address` field to either `validate_only` or `validate_and_clean`."
},
"response": [
{
"name": "Validate when creating a shipment",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipments\": [{\n\t\t\"validate_address\": \"validate_and_clean\",\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 Winchester\",\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}\n\t\t]\n\t}]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.shipengine.com/v1/shipments",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"shipments"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Wed, 18 Sep 2019 16:01:54 GMT"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Content-Length",
"value": "4156"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Access-Control-Allow-Origin",
"value": "https://www.shipengine.com"
},
{
"key": "Vary",
"value": "Origin"
},
{
"key": "x-shipengine-requestid",
"value": "9b4734c7-f7d7-4ce9-8597-e9e6696d0053"
}
],
"cookie": [
],
"body": "{\n \"has_errors\": false,\n \"shipments\": [\n {\n \"errors\": [],\n \"address_validation\": {\n \"status\": \"verified\",\n \"original_address\": {\n \"name\": \"Amanda Miller\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 Winchester\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": null,\n \"state_province\": null,\n \"postal_code\": \"95128\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"matched_address\": {\n \"name\": \"AMANDA MILLER\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 S WINCHESTER BLVD\",\n \"address_line2\": \"\",\n \"address_line3\": null,\n \"city_locality\": \"SAN JOSE\",\n \"state_province\": \"CA\",\n \"postal_code\": \"95128-2537\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"no\"\n },\n \"messages\": []\n },\n \"shipment_id\": \"se-4159801\",\n \"carrier_id\": \"se-121861\",\n \"service_code\": \"usps_priority_mail\",\n \"external_shipment_id\": null,\n \"ship_date\": \"2019-09-18T00:00:00Z\",\n \"created_at\": \"2019-09-18T16:01:54.9171198Z\",\n \"modified_at\": \"2019-09-18T16:01:54.9171198Z\",\n \"shipment_status\": \"pending\",\n \"ship_to\": {\n \"name\": \"AMANDA MILLER\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 S WINCHESTER BLVD\",\n \"address_line2\": \"\",\n \"address_line3\": null,\n \"city_locality\": \"SAN JOSE\",\n \"state_province\": \"CA\",\n \"postal_code\": \"95128-2537\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"no\"\n },\n \"ship_from\": {\n \"name\": \"John Doe\",\n \"phone\": \"512-555-5555\",\n \"company_name\": \"Example Corp.\",\n \"address_line1\": \"4009 Marathon Blvd\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": \"Austin\",\n \"state_province\": \"TX\",\n \"postal_code\": \"78756\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"warehouse_id\": null,\n \"return_to\": {\n \"name\": \"John Doe\",\n \"phone\": \"512-555-5555\",\n \"company_name\": \"Example Corp.\",\n \"address_line1\": \"4009 Marathon Blvd\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": \"Austin\",\n \"state_province\": \"TX\",\n \"postal_code\": \"78756\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"confirmation\": \"none\",\n \"customs\": null,\n \"external_order_id\": null,\n \"order_source_code\": null,\n \"advanced_options\": {\n \"bill_to_account\": null,\n \"bill_to_country_code\": null,\n \"bill_to_party\": null,\n \"bill_to_postal_code\": null,\n \"contains_alcohol\": false,\n \"delivered_duty_paid\": false,\n \"non_machinable\": false,\n \"saturday_delivery\": false,\n \"dry_ice\": false,\n \"dry_ice_weight\": null,\n \"freight_class\": null,\n \"custom_field1\": null,\n \"custom_field2\": null,\n \"custom_field3\": null\n },\n \"insurance_provider\": \"none\",\n \"tags\": [],\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 \"label_messages\": {\n \"reference1\": null,\n \"reference2\": null,\n \"reference3\": null\n },\n \"external_package_id\": null\n }\n ],\n \"total_weight\": {\n \"value\": 17,\n \"unit\": \"pound\"\n },\n \"items\": []\n }\n ]\n}"
}
]
}