Back to Collection Items
func chilkatTest() {
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
let http = CkoHttp()!
var success: Bool
// 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"
// }
// ]
// }
// ]
// }
// }
let json = CkoJsonObject()!
json.update("order.external_order_identifier", value: "ABC-105")
json.update("order.ordered_at", value: "2014-01-16 14:37:56 -0600")
json.update("order.order_status", value: "awaiting_shipment")
json.update("order.subtotal_including_tax", value: "10.00")
json.update("order.total_including_tax", value: "10.00")
json.update("order.total_excluding_tax", value: "10.00")
json.update("order.discount_amount", value: "0.00")
json.update("order.coupon_discount", value: "1.00")
json.update("order.subtotal_excluding_tax", value: "0.00")
json.update("order.subtotal_tax", value: "0.00")
json.update("order.total_tax", value: "0")
json.update("order.base_shipping_cost", value: "0.00")
json.update("order.shipping_cost_including_tax", value: "0.00")
json.update("order.shipping_cost_excluding_tax", value: "0.00")
json.update("order.shipping_cost_tax", value: "0.00")
json.update("order.base_handling_cost", value: "0.00")
json.update("order.handling_cost_excluding_tax", value: "0.00")
json.update("order.handling_cost_including_tax", value: "0.00")
json.update("order.handling_cost_tax", value: "0.00")
json.update("order.base_wrapping_cost", value: "0.00")
json.update("order.wrapping_cost_excluding_tax", value: "0.00")
json.update("order.wrapping_cost_including_tax", value: "0.00")
json.update("order.wrapping_cost_tax", value: "0.00")
json.update("order.notes", value: "Please send promptly.")
json.update("order.billing_company", value: "Acme Inc.")
json.update("order.billing_first_name", value: "Fred")
json.update("order.billing_last_name", value: "Jones")
json.update("order.billing_address", value: "1234 Street")
json.update("order.billing_address2", value: "Suite 100")
json.update("order.billing_city", value: "Austin")
json.update("order.billing_state", value: "TX")
json.update("order.billing_postal_code", value: "78701")
json.update("order.billing_country", value: "USA")
json.update("order.billing_phone_number", value: "512-123-1234")
json.update("order.billing_email", value: "test@test.com")
json.update("order.recipients[0].first_name", value: "Jack")
json.update("order.recipients[0].last_name", value: "Ship")
json.update("order.recipients[0].company", value: "ShippingEasy")
json.update("order.recipients[0].email", value: "jack@shippingeasy.com")
json.update("order.recipients[0].phone_number", value: "855-202-2275")
json.update("order.recipients[0].residential", value: "true")
json.update("order.recipients[0].address", value: "3700 N Capital of Texas Hwy Ste 550")
json.update("order.recipients[0].address2", value: "")
json.update("order.recipients[0].province", value: "")
json.update("order.recipients[0].state", value: "TX")
json.update("order.recipients[0].city", value: "Austin")
json.update("order.recipients[0].postal_code", value: "78746")
json.update("order.recipients[0].postal_code_plus_4", value: "1234")
json.update("order.recipients[0].country", value: "United States")
json.update("order.recipients[0].shipping_method", value: "Ground")
json.update("order.recipients[0].base_cost", value: "10.00")
json.update("order.recipients[0].cost_excluding_tax", value: "10.00")
json.update("order.recipients[0].cost_tax", value: "0.00")
json.update("order.recipients[0].base_handling_cost", value: "0.00")
json.update("order.recipients[0].handling_cost_excluding_tax", value: "0.00")
json.update("order.recipients[0].handling_cost_including_tax", value: "0.00")
json.update("order.recipients[0].handling_cost_tax", value: "0.00")
json.update("order.recipients[0].shipping_zone_id", value: "123")
json.update("order.recipients[0].shipping_zone_name", value: "XYZ")
json.update("order.recipients[0].items_total", value: "1")
json.update("order.recipients[0].items_shipped", value: "0")
json.update("order.recipients[0].line_items[0].item_name", value: "Pencil Holder")
json.update("order.recipients[0].line_items[0].sku", value: "9876543")
json.update("order.recipients[0].line_items[0].bin_picking_number", value: "7")
json.update("order.recipients[0].line_items[0].unit_price", value: "1.30")
json.update("order.recipients[0].line_items[0].total_excluding_tax", value: "1.30")
json.update("order.recipients[0].line_items[0].weight_in_ounces", value: "10")
json.update("order.recipients[0].line_items[0].product_options.pa_size", value: "large")
json.update("order.recipients[0].line_items[0].product_options.Colour", value: "Blue")
json.update("order.recipients[0].line_items[0].quantity", value: "1")
var resp: CkoHttpResponse? = http.postJson3("Key}}", contentType: "application/json", json: json)
if http.lastMethodSuccess == false {
print("\(http.lastErrorText!)")
return
}
print("\(resp!.statusCode.intValue)")
print("\(resp!.bodyStr!)")
resp = nil
}
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": [
]
}