Back to Collection Items
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
Chilkat.Http http = new Chilkat.Http();
bool success;
// 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"
// }
// ]
// }
// ]
// }
// }
Chilkat.JsonObject json = new 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");
Chilkat.HttpResponse resp = http.PostJson3("Key}}","application/json",json);
if (http.LastMethodSuccess == false) {
Debug.WriteLine(http.LastErrorText);
return;
}
Debug.WriteLine(Convert.ToString(resp.StatusCode));
Debug.WriteLine(resp.BodyStr);
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": [
]
}
