(JavaScript) Shippo Create Customs Declaration

Demonstrates how to create a customs declaration and send a POST request with the necessary information to the Customs Declarations endpoint.

For more information, see https://goshippo.com/docs/international/

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

var http = new CkHttp();

// Implements the following CURL command:

// curl https://api.goshippo.com/customs/declarations/ \
//     -H "Authorization: ShippoToken <API_TOKEN>" \
//     -H "Content-Type: application/json"  \
//     -d '{          
//           "contents_type": "MERCHANDISE",
//           "non_delivery_option": "RETURN",
//           "certify": true,
//           "certify_signer": "Simon Kreuz",
//           "incoterm": "DDU",
//           "items": [{
//                     "description": "T-shirt",
//                     "quantity": 20,
//                     "net_weight": "5",
//                     "mass_unit": "lb",
//                     "value_amount": "200",
//                     "value_currency": "USD",
//                     "tariff_number": "",
//                     "origin_country": "US"
//             }]
//     }'

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "contents_type": "MERCHANDISE",
//   "non_delivery_option": "RETURN",
//   "certify": true,
//   "certify_signer": "Simon Kreuz",
//   "incoterm": "DDU",
//   "items": [
//     {
//       "description": "T-shirt",
//       "quantity": 20,
//       "net_weight": "5",
//       "mass_unit": "lb",
//       "value_amount": "200",
//       "value_currency": "USD",
//       "tariff_number": "",
//       "origin_country": "US"
//     }
//   ]
// }

var json = new CkJsonObject();
json.UpdateString("contents_type","MERCHANDISE");
json.UpdateString("non_delivery_option","RETURN");
json.UpdateBool("certify",true);
json.UpdateString("certify_signer","Simon Kreuz");
json.UpdateString("incoterm","DDU");
json.UpdateString("items[0].description","T-shirt");
json.UpdateInt("items[0].quantity",20);
json.UpdateString("items[0].net_weight","5");
json.UpdateString("items[0].mass_unit","lb");
json.UpdateString("items[0].value_amount","200");
json.UpdateString("items[0].value_currency","USD");
json.UpdateString("items[0].tariff_number","");
json.UpdateString("items[0].origin_country","US");

http.SetRequestHeader("Authorization","ShippoToken <API_TOKEN>");
http.SetRequestHeader("Content-Type","application/json");

var resp = new CkHttpResponse();
success = http.HttpJson("POST","https://api.goshippo.com/customs/declarations/",json,"application/json",resp);
if (success == false) {
    console.log(http.LastErrorText);
    return;
}

var sbResponseBody = new CkStringBuilder();
resp.GetBodySb(sbResponseBody);
var jResp = new CkJsonObject();
jResp.LoadSb(sbResponseBody);
jResp.EmitCompact = false;

console.log("Response Body:");
console.log(jResp.Emit());

var respStatusCode = resp.StatusCode;
console.log("Response Status Code = " + respStatusCode);
if (respStatusCode >= 400) {
    console.log("Response Header:");
    console.log(resp.Header);
    console.log("Failed.");
    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "object_created": "2019-07-04T16:00:29.043Z",
//   "object_updated": "2019-07-04T16:00:29.043Z",
//   "object_id": "4a1e6ab7b1ba49ed9bc6cb1a8798e0fd",
//   "object_owner": "admin@chilkatsoft.com",
//   "object_state": "VALID",
//   "address_importer": null,
//   "certify_signer": "Simon Kreuz",
//   "certify": true,
//   "items": [
//     "4096c68693364b7ea0af72fb869ee861"
//   ],
//   "non_delivery_option": "RETURN",
//   "contents_type": "MERCHANDISE",
//   "contents_explanation": "",
//   "exporter_reference": "",
//   "importer_reference": "",
//   "invoice": "",
//   "commercial_invoice": false,
//   "license": "",
//   "certificate": "",
//   "notes": "",
//   "eel_pfc": "",
//   "aes_itn": "",
//   "disclaimer": "",
//   "incoterm": "DDU",
//   "metadata": "",
//   "test": true,
//   "duties_payor": null
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

var strVal;

var object_created = jResp.StringOf("object_created");
var object_updated = jResp.StringOf("object_updated");
var object_id = jResp.StringOf("object_id");
var object_owner = jResp.StringOf("object_owner");
var object_state = jResp.StringOf("object_state");
var address_importer = jResp.StringOf("address_importer");
var certify_signer = jResp.StringOf("certify_signer");
var certify = jResp.BoolOf("certify");
var non_delivery_option = jResp.StringOf("non_delivery_option");
var contents_type = jResp.StringOf("contents_type");
var contents_explanation = jResp.StringOf("contents_explanation");
var exporter_reference = jResp.StringOf("exporter_reference");
var importer_reference = jResp.StringOf("importer_reference");
var invoice = jResp.StringOf("invoice");
var commercial_invoice = jResp.BoolOf("commercial_invoice");
var license = jResp.StringOf("license");
var certificate = jResp.StringOf("certificate");
var notes = jResp.StringOf("notes");
var eel_pfc = jResp.StringOf("eel_pfc");
var aes_itn = jResp.StringOf("aes_itn");
var disclaimer = jResp.StringOf("disclaimer");
var incoterm = jResp.StringOf("incoterm");
var metadata = jResp.StringOf("metadata");
var test = jResp.BoolOf("test");
var duties_payor = jResp.StringOf("duties_payor");
var i = 0;
var count_i = jResp.SizeOfArray("items");
while (i < count_i) {
    jResp.I = i;
    strVal = jResp.StringOf("items[i]");
    i = i+1;
}