Back to Collection Items
<?php
// 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 new COM('Chilkat_9_5_0.Chilkat.Http')
$http = new COM("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.
// {
// "order": {
// "external_order_identifier": "ABC-105",
// "ordered_at": "2014-01-16 14:37:56 -0600",
// "order_status": "awaiting_shipment",
// "subtotal_including_tax": "10.00",
// "total_including_tax": "10.00",
// "total_excluding_tax": "10.00",
// "discount_amount": "0.00",
// "coupon_discount": "1.00",
// "subtotal_excluding_tax": "0.00",
// "subtotal_tax": "0.00",
// "total_tax": "0",
// "base_shipping_cost": "0.00",
// "shipping_cost_including_tax": "0.00",
// "shipping_cost_excluding_tax": "0.00",
// "shipping_cost_tax": "0.00",
// "base_handling_cost": "0.00",
// "handling_cost_excluding_tax": "0.00",
// "handling_cost_including_tax": "0.00",
// "handling_cost_tax": "0.00",
// "base_wrapping_cost": "0.00",
// "wrapping_cost_excluding_tax": "0.00",
// "wrapping_cost_including_tax": "0.00",
// "wrapping_cost_tax": "0.00",
// "notes": "Please send promptly.",
// "billing_company": "Acme Inc.",
// "billing_first_name": "Fred",
// "billing_last_name": "Jones",
// "billing_address": "1234 Street",
// "billing_address2": "Suite 100",
// "billing_city": "Austin",
// "billing_state": "TX",
// "billing_postal_code": "78701",
// "billing_country": "USA",
// "billing_phone_number": "512-123-1234",
// "billing_email": "test@test.com",
// "recipients": [
// {
// "first_name": "Jack",
// "last_name": "Ship",
// "company": "ShippingEasy",
// "email": "jack@shippingeasy.com",
// "phone_number": "855-202-2275",
// "residential": "true",
// "address": "3700 N Capital of Texas Hwy Ste 550",
// "address2": "",
// "province": "",
// "state": "TX",
// "city": "Austin",
// "postal_code": "78746",
// "postal_code_plus_4": "1234",
// "country": "United States",
// "shipping_method": "Ground",
// "base_cost": "10.00",
// "cost_excluding_tax": "10.00",
// "cost_tax": "0.00",
// "base_handling_cost": "0.00",
// "handling_cost_excluding_tax": "0.00",
// "handling_cost_including_tax": "0.00",
// "handling_cost_tax": "0.00",
// "shipping_zone_id": "123",
// "shipping_zone_name": "XYZ",
// "items_total": "1",
// "items_shipped": "0",
// "line_items": [
// {
// "item_name": "Pencil Holder",
// "sku": "9876543",
// "bin_picking_number": "7",
// "unit_price": "1.30",
// "total_excluding_tax": "1.30",
// "weight_in_ounces": "10",
// "product_options": {
// "pa_size": "large",
// "Colour": "Blue"
// },
// "quantity": "1"
// }
// ]
// }
// ]
// }
// }
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$json = new COM("Chilkat.JsonObject");
$json->UpdateString('order.external_order_identifier','ABC-105');
$json->UpdateString('order.ordered_at','2014-01-16 14:37:56 -0600');
$json->UpdateString('order.order_status','awaiting_shipment');
$json->UpdateString('order.subtotal_including_tax','10.00');
$json->UpdateString('order.total_including_tax','10.00');
$json->UpdateString('order.total_excluding_tax','10.00');
$json->UpdateString('order.discount_amount','0.00');
$json->UpdateString('order.coupon_discount','1.00');
$json->UpdateString('order.subtotal_excluding_tax','0.00');
$json->UpdateString('order.subtotal_tax','0.00');
$json->UpdateString('order.total_tax','0');
$json->UpdateString('order.base_shipping_cost','0.00');
$json->UpdateString('order.shipping_cost_including_tax','0.00');
$json->UpdateString('order.shipping_cost_excluding_tax','0.00');
$json->UpdateString('order.shipping_cost_tax','0.00');
$json->UpdateString('order.base_handling_cost','0.00');
$json->UpdateString('order.handling_cost_excluding_tax','0.00');
$json->UpdateString('order.handling_cost_including_tax','0.00');
$json->UpdateString('order.handling_cost_tax','0.00');
$json->UpdateString('order.base_wrapping_cost','0.00');
$json->UpdateString('order.wrapping_cost_excluding_tax','0.00');
$json->UpdateString('order.wrapping_cost_including_tax','0.00');
$json->UpdateString('order.wrapping_cost_tax','0.00');
$json->UpdateString('order.notes','Please send promptly.');
$json->UpdateString('order.billing_company','Acme Inc.');
$json->UpdateString('order.billing_first_name','Fred');
$json->UpdateString('order.billing_last_name','Jones');
$json->UpdateString('order.billing_address','1234 Street');
$json->UpdateString('order.billing_address2','Suite 100');
$json->UpdateString('order.billing_city','Austin');
$json->UpdateString('order.billing_state','TX');
$json->UpdateString('order.billing_postal_code','78701');
$json->UpdateString('order.billing_country','USA');
$json->UpdateString('order.billing_phone_number','512-123-1234');
$json->UpdateString('order.billing_email','test@test.com');
$json->UpdateString('order.recipients[0].first_name','Jack');
$json->UpdateString('order.recipients[0].last_name','Ship');
$json->UpdateString('order.recipients[0].company','ShippingEasy');
$json->UpdateString('order.recipients[0].email','jack@shippingeasy.com');
$json->UpdateString('order.recipients[0].phone_number','855-202-2275');
$json->UpdateString('order.recipients[0].residential','true');
$json->UpdateString('order.recipients[0].address','3700 N Capital of Texas Hwy Ste 550');
$json->UpdateString('order.recipients[0].address2','');
$json->UpdateString('order.recipients[0].province','');
$json->UpdateString('order.recipients[0].state','TX');
$json->UpdateString('order.recipients[0].city','Austin');
$json->UpdateString('order.recipients[0].postal_code','78746');
$json->UpdateString('order.recipients[0].postal_code_plus_4','1234');
$json->UpdateString('order.recipients[0].country','United States');
$json->UpdateString('order.recipients[0].shipping_method','Ground');
$json->UpdateString('order.recipients[0].base_cost','10.00');
$json->UpdateString('order.recipients[0].cost_excluding_tax','10.00');
$json->UpdateString('order.recipients[0].cost_tax','0.00');
$json->UpdateString('order.recipients[0].base_handling_cost','0.00');
$json->UpdateString('order.recipients[0].handling_cost_excluding_tax','0.00');
$json->UpdateString('order.recipients[0].handling_cost_including_tax','0.00');
$json->UpdateString('order.recipients[0].handling_cost_tax','0.00');
$json->UpdateString('order.recipients[0].shipping_zone_id','123');
$json->UpdateString('order.recipients[0].shipping_zone_name','XYZ');
$json->UpdateString('order.recipients[0].items_total','1');
$json->UpdateString('order.recipients[0].items_shipped','0');
$json->UpdateString('order.recipients[0].line_items[0].item_name','Pencil Holder');
$json->UpdateString('order.recipients[0].line_items[0].sku','9876543');
$json->UpdateString('order.recipients[0].line_items[0].bin_picking_number','7');
$json->UpdateString('order.recipients[0].line_items[0].unit_price','1.30');
$json->UpdateString('order.recipients[0].line_items[0].total_excluding_tax','1.30');
$json->UpdateString('order.recipients[0].line_items[0].weight_in_ounces','10');
$json->UpdateString('order.recipients[0].line_items[0].product_options.pa_size','large');
$json->UpdateString('order.recipients[0].line_items[0].product_options.Colour','Blue');
$json->UpdateString('order.recipients[0].line_items[0].quantity','1');
// resp is a Chilkat.HttpResponse
$resp = $http->PostJson3('Key}}','application/json',$json);
if ($http->LastMethodSuccess == 0) {
print $http->LastErrorText . "\n";
exit;
}
print $resp->StatusCode . "\n";
print $resp->BodyStr . "\n";
?>
Curl Command
curl -X POST
-d '{
"order": {
"external_order_identifier": "ABC-105",
"ordered_at": "2014-01-16 14:37:56 -0600",
"order_status": "awaiting_shipment",
"subtotal_including_tax": "10.00",
"total_including_tax": "10.00",
"total_excluding_tax": "10.00",
"discount_amount": "0.00",
"coupon_discount": "1.00",
"subtotal_excluding_tax": "0.00",
"subtotal_tax": "0.00",
"total_tax": "0",
"base_shipping_cost": "0.00",
"shipping_cost_including_tax": "0.00",
"shipping_cost_excluding_tax": "0.00",
"shipping_cost_tax": "0.00",
"base_handling_cost": "0.00",
"handling_cost_excluding_tax": "0.00",
"handling_cost_including_tax": "0.00",
"handling_cost_tax": "0.00",
"base_wrapping_cost": "0.00",
"wrapping_cost_excluding_tax": "0.00",
"wrapping_cost_including_tax": "0.00",
"wrapping_cost_tax": "0.00",
"notes": "Please send promptly.",
"billing_company": "Acme Inc.",
"billing_first_name": "Fred",
"billing_last_name": "Jones",
"billing_address": "1234 Street",
"billing_address2": "Suite 100",
"billing_city": "Austin",
"billing_state": "TX",
"billing_postal_code": "78701",
"billing_country": "USA",
"billing_phone_number": "512-123-1234",
"billing_email": "test@test.com",
"recipients": [
{
"first_name": "Jack",
"last_name": "Ship",
"company": "ShippingEasy",
"email": "jack@shippingeasy.com",
"phone_number": "855-202-2275",
"residential": "true",
"address": "3700 N Capital of Texas Hwy Ste 550",
"address2": "",
"province": "",
"state": "TX",
"city": "Austin",
"postal_code": "78746",
"postal_code_plus_4": "1234",
"country": "United States",
"shipping_method": "Ground",
"base_cost": "10.00",
"cost_excluding_tax": "10.00",
"cost_tax": "0.00",
"base_handling_cost": "0.00",
"handling_cost_excluding_tax": "0.00",
"handling_cost_including_tax": "0.00",
"handling_cost_tax": "0.00",
"shipping_zone_id": "123",
"shipping_zone_name": "XYZ",
"items_total": "1",
"items_shipped": "0",
"line_items": [
{
"item_name": "Pencil Holder",
"sku": "9876543",
"bin_picking_number": "7",
"unit_price": "1.30",
"total_excluding_tax": "1.30",
"weight_in_ounces": "10",
"product_options": {
"pa_size": "large",
"Colour": "Blue"
},
"quantity": "1"
}
]
}
]
}
}'
https://app.shippingeasy.com/api/stores/{{Store API Key}}/orders?api_signature={{api_signature}}&api_timestamp={{api_timestamp}}&api_key={{API Key}}
Postman Collection Item JSON
{
"name": "Create Order",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
"// calculate timestamp",
"const timestamp = parseInt(Date.now() / 1000);",
"console.log(\"timestamp: \" + timestamp);",
"pm.variables.set(\"api_timestamp\", timestamp);",
"",
"// Set your API key and API secret as Postman environment variables, your key and secret are available at https://app.shippingeasy.com/settings/api_credentials",
"const apiKey = pm.environment.get(\"API Key\");",
"const apiSecret = pm.environment.get(\"API Secret\");",
"const storeApiKey = pm.environment.get(\"Store API Key\");",
"",
"// build signature string - https://shippingeasy.readme.io/docs/authentication-signing-requests#how-to-calculate-a-signature",
"const signatureString = pm.request.method + \"&\" +",
" \"/api/stores/\" + storeApiKey + \"/orders&\" +",
" \"api_key=\" + apiKey + \"&\" +",
" \"api_timestamp=\" + timestamp + \"&\" +",
" pm.request.body.toString();",
"console.log(\"signature string: \" + signatureString);",
"",
"// generate signature",
"const apiSignature = CryptoJS.HmacSHA256(signatureString, apiSecret).toString(CryptoJS.enc.Hex);",
"console.log(\"api request signature: \" + apiSignature);",
"pm.variables.set(\"api_signature\", apiSignature);"
]
}
}
],
"request": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"order\": {\n \"external_order_identifier\": \"ABC-105\",\n \"ordered_at\": \"2014-01-16 14:37:56 -0600\",\n \"order_status\": \"awaiting_shipment\",\n \"subtotal_including_tax\": \"10.00\",\n \"total_including_tax\": \"10.00\",\n \"total_excluding_tax\": \"10.00\",\n \"discount_amount\": \"0.00\",\n \"coupon_discount\": \"1.00\",\n \"subtotal_excluding_tax\": \"0.00\",\n \"subtotal_tax\": \"0.00\",\n \"total_tax\": \"0\",\n \"base_shipping_cost\": \"0.00\",\n \"shipping_cost_including_tax\": \"0.00\",\n \"shipping_cost_excluding_tax\": \"0.00\",\n \"shipping_cost_tax\": \"0.00\",\n \"base_handling_cost\": \"0.00\",\n \"handling_cost_excluding_tax\": \"0.00\",\n \"handling_cost_including_tax\": \"0.00\",\n \"handling_cost_tax\": \"0.00\",\n \"base_wrapping_cost\": \"0.00\",\n \"wrapping_cost_excluding_tax\": \"0.00\",\n \"wrapping_cost_including_tax\": \"0.00\",\n \"wrapping_cost_tax\": \"0.00\",\n \"notes\": \"Please send promptly.\",\n \"billing_company\": \"Acme Inc.\",\n \"billing_first_name\": \"Fred\",\n \"billing_last_name\": \"Jones\",\n \"billing_address\": \"1234 Street\",\n \"billing_address2\": \"Suite 100\",\n \"billing_city\": \"Austin\",\n \"billing_state\": \"TX\",\n \"billing_postal_code\": \"78701\",\n \"billing_country\": \"USA\",\n \"billing_phone_number\": \"512-123-1234\",\n \"billing_email\": \"test@test.com\",\n \"recipients\": [\n {\n \"first_name\": \"Jack\",\n \"last_name\": \"Ship\",\n \"company\": \"ShippingEasy\",\n \"email\": \"jack@shippingeasy.com\",\n \"phone_number\": \"855-202-2275\",\n \"residential\": \"true\",\n \"address\": \"3700 N Capital of Texas Hwy Ste 550\",\n \"address2\": \"\",\n \"province\": \"\",\n \"state\": \"TX\",\n \"city\": \"Austin\",\n \"postal_code\": \"78746\",\n \"postal_code_plus_4\": \"1234\",\n \"country\": \"United States\",\n \"shipping_method\": \"Ground\",\n \"base_cost\": \"10.00\",\n \"cost_excluding_tax\": \"10.00\",\n \"cost_tax\": \"0.00\",\n \"base_handling_cost\": \"0.00\",\n \"handling_cost_excluding_tax\": \"0.00\",\n \"handling_cost_including_tax\": \"0.00\",\n \"handling_cost_tax\": \"0.00\",\n \"shipping_zone_id\": \"123\",\n \"shipping_zone_name\": \"XYZ\",\n \"items_total\": \"1\",\n \"items_shipped\": \"0\",\n \"line_items\": [\n {\n \"item_name\": \"Pencil Holder\",\n \"sku\": \"9876543\",\n \"bin_picking_number\": \"7\",\n \"unit_price\": \"1.30\",\n \"total_excluding_tax\": \"1.30\",\n \"weight_in_ounces\": \"10\",\n \"product_options\": {\n \"pa_size\": \"large\",\n \"Colour\": \"Blue\"\n },\n \"quantity\": \"1\"\n }\n ]\n }\n ]\n }\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "app.shippingeasy.com/api/stores/{{Store API Key}}/orders?api_signature={{api_signature}}&api_timestamp={{api_timestamp}}&api_key={{API Key}}",
"host": [
"app",
"shippingeasy",
"com"
],
"path": [
"api",
"stores",
"{{Store API Key}}",
"orders"
],
"query": [
{
"key": "api_signature",
"value": "{{api_signature}}"
},
{
"key": "api_timestamp",
"value": "{{api_timestamp}}"
},
{
"key": "api_key",
"value": "{{API Key}}"
}
]
},
"description": "Create an order in ShippingEasy."
},
"response": [
]
}
