(.NET Core C#) Shippo Create a Batch

Demonstrates how to create and purchase up to 10,000 shipments in a single API request.

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

Chilkat .NET Downloads Chilkat .NET Assemblies Chilkat for .NET Core Chilkat for Mono

// 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.

// {
//   "default_carrier_account": "078870331023437cb917f5187429b093",
//   "default_servicelevel_token": "usps_priority",
//   "label_filetype": "PDF_4x6",
//   "metadata": "BATCH #170",
//   "batch_shipments": [
//     {
//       "shipment": {
//         "address_from": {
//           "name": "Mr Hippo",
//           "street1": "965 Mission St",
//           "street2": "Ste 201",
//           "city": "San Francisco",
//           "state": "CA",
//           "zip": "94103",
//           "country": "US",
//           "phone": "4151234567",
//           "email": "mrhippo@goshippo.com"
//         },
//         "address_to": {
//           "name": "Mrs Hippo",
//           "company": "",
//           "street1": "Broadway 1",
//           "street2": "",
//           "city": "New York",
//           "state": "NY",
//           "zip": "10007",
//           "country": "US",
//           "phone": "4151234567",
//           "email": "mrshippo@goshippo.com"
//         },
//         "parcels": [
//           {
//             "length": "5",
//             "width": "5",
//             "height": "5",
//             "distance_unit": "in",
//             "weight": "2",
//             "mass_unit": "oz"
//           }
//         ]
//       }
//     },
//     {
//       "shipment": {
//         "address_from": {
//           "name": "Mr Hippo",
//           "street1": "1092 Indian Summer Ct",
//           "city": "San Jose",
//           "state": "CA",
//           "zip": "95122",
//           "country": "US",
//           "phone": "4151234567",
//           "email": "mrhippo@goshippo.com"
//         },
//         "address_to": {
//           "name": "Mrs Hippo",
//           "company": "",
//           "street1": "Broadway 1",
//           "street2": "",
//           "city": "New York",
//           "state": "NY",
//           "zip": "10007",
//           "country": "US",
//           "phone": "4151234567",
//           "email": "mrshippo@goshippo.com"
//         },
//         "parcels": [
//           {
//             "length": "5",
//             "width": "5",
//             "height": "5",
//             "distance_unit": "in",
//             "weight": "20",
//             "mass_unit": "lb"
//           }
//         ]
//       },
//       "carrier_account": "a4391cd4ab974f478f55dc08b5c8e3b3",
//       "servicelevel_token": "fedex_2_day"
//     }
//   ]
// }

Chilkat.JsonObject json = new Chilkat.JsonObject();
json.UpdateString("default_carrier_account","078870331023437cb917f5187429b093");
json.UpdateString("default_servicelevel_token","usps_priority");
json.UpdateString("label_filetype","PDF_4x6");
json.UpdateString("metadata","BATCH #170");
json.UpdateString("batch_shipments[0].shipment.address_from.name","Mr Hippo");
json.UpdateString("batch_shipments[0].shipment.address_from.street1","965 Mission St");
json.UpdateString("batch_shipments[0].shipment.address_from.street2","Ste 201");
json.UpdateString("batch_shipments[0].shipment.address_from.city","San Francisco");
json.UpdateString("batch_shipments[0].shipment.address_from.state","CA");
json.UpdateString("batch_shipments[0].shipment.address_from.zip","94103");
json.UpdateString("batch_shipments[0].shipment.address_from.country","US");
json.UpdateString("batch_shipments[0].shipment.address_from.phone","4151234567");
json.UpdateString("batch_shipments[0].shipment.address_from.email","mrhippo@goshippo.com");
json.UpdateString("batch_shipments[0].shipment.address_to.name","Mrs Hippo");
json.UpdateString("batch_shipments[0].shipment.address_to.company","");
json.UpdateString("batch_shipments[0].shipment.address_to.street1","Broadway 1");
json.UpdateString("batch_shipments[0].shipment.address_to.street2","");
json.UpdateString("batch_shipments[0].shipment.address_to.city","New York");
json.UpdateString("batch_shipments[0].shipment.address_to.state","NY");
json.UpdateString("batch_shipments[0].shipment.address_to.zip","10007");
json.UpdateString("batch_shipments[0].shipment.address_to.country","US");
json.UpdateString("batch_shipments[0].shipment.address_to.phone","4151234567");
json.UpdateString("batch_shipments[0].shipment.address_to.email","mrshippo@goshippo.com");
json.UpdateString("batch_shipments[0].shipment.parcels[0].length","5");
json.UpdateString("batch_shipments[0].shipment.parcels[0].width","5");
json.UpdateString("batch_shipments[0].shipment.parcels[0].height","5");
json.UpdateString("batch_shipments[0].shipment.parcels[0].distance_unit","in");
json.UpdateString("batch_shipments[0].shipment.parcels[0].weight","2");
json.UpdateString("batch_shipments[0].shipment.parcels[0].mass_unit","oz");
json.UpdateString("batch_shipments[1].shipment.address_from.name","Mr Hippo");
json.UpdateString("batch_shipments[1].shipment.address_from.street1","1092 Indian Summer Ct");
json.UpdateString("batch_shipments[1].shipment.address_from.city","San Jose");
json.UpdateString("batch_shipments[1].shipment.address_from.state","CA");
json.UpdateString("batch_shipments[1].shipment.address_from.zip","95122");
json.UpdateString("batch_shipments[1].shipment.address_from.country","US");
json.UpdateString("batch_shipments[1].shipment.address_from.phone","4151234567");
json.UpdateString("batch_shipments[1].shipment.address_from.email","mrhippo@goshippo.com");
json.UpdateString("batch_shipments[1].shipment.address_to.name","Mrs Hippo");
json.UpdateString("batch_shipments[1].shipment.address_to.company","");
json.UpdateString("batch_shipments[1].shipment.address_to.street1","Broadway 1");
json.UpdateString("batch_shipments[1].shipment.address_to.street2","");
json.UpdateString("batch_shipments[1].shipment.address_to.city","New York");
json.UpdateString("batch_shipments[1].shipment.address_to.state","NY");
json.UpdateString("batch_shipments[1].shipment.address_to.zip","10007");
json.UpdateString("batch_shipments[1].shipment.address_to.country","US");
json.UpdateString("batch_shipments[1].shipment.address_to.phone","4151234567");
json.UpdateString("batch_shipments[1].shipment.address_to.email","mrshippo@goshippo.com");
json.UpdateString("batch_shipments[1].shipment.parcels[0].length","5");
json.UpdateString("batch_shipments[1].shipment.parcels[0].width","5");
json.UpdateString("batch_shipments[1].shipment.parcels[0].height","5");
json.UpdateString("batch_shipments[1].shipment.parcels[0].distance_unit","in");
json.UpdateString("batch_shipments[1].shipment.parcels[0].weight","20");
json.UpdateString("batch_shipments[1].shipment.parcels[0].mass_unit","lb");
json.UpdateString("batch_shipments[1].carrier_account","a4391cd4ab974f478f55dc08b5c8e3b3");
json.UpdateString("batch_shipments[1].servicelevel_token","fedex_2_day");

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

Chilkat.HttpResponse resp = http.PostJson3("https://api.goshippo.com/batches/","application/json",json);
if (http.LastMethodSuccess == false) {
    Debug.WriteLine(http.LastErrorText);
    return;
}

Chilkat.StringBuilder sbResponseBody = new Chilkat.StringBuilder();
resp.GetBodySb(sbResponseBody);
Chilkat.JsonObject jResp = new Chilkat.JsonObject();
jResp.LoadSb(sbResponseBody);
jResp.EmitCompact = false;

Debug.WriteLine("Response Body:");
Debug.WriteLine(jResp.Emit());

int respStatusCode = resp.StatusCode;
Debug.WriteLine("Response Status Code = " + Convert.ToString(respStatusCode));
if (respStatusCode >= 400) {
    Debug.WriteLine("Response Header:");
    Debug.WriteLine(resp.Header);
    Debug.WriteLine("Failed.");

    return;
}

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

// {
//   "object_id": "a015eb693cca465dbb6523ce6d2e3c65",
//   "object_owner": "admin",
//   "status": "VALIDATING",
//   "object_created": "2016-09-12T15:25:43.465Z",
//   "object_updated": "2016-09-12T15:25:43.465Z",
//   "metadata": "BATCH #170",
//   "default_carrier_account": "078870331023437cb917f5187429b093",
//   "default_servicelevel_token": "usps_priority",
//   "label_filetype": "PDF_4x6",
//   "batch_shipments": {
//     "next": null,
//     "previous": null,
//     "results": [
//     ]
//   },
//   "object_results": {
//     "purchase_succeeded": 0,
//     "purchase_failed": 0,
//     "creation_failed": 0,
//     "creation_succeeded": 0
//   },
//   "label_url": [
//   ]
// }

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

string object_id = jResp.StringOf("object_id");
string object_owner = jResp.StringOf("object_owner");
string status = jResp.StringOf("status");
string object_created = jResp.StringOf("object_created");
string object_updated = jResp.StringOf("object_updated");
string metadata = jResp.StringOf("metadata");
string default_carrier_account = jResp.StringOf("default_carrier_account");
string default_servicelevel_token = jResp.StringOf("default_servicelevel_token");
string label_filetype = jResp.StringOf("label_filetype");
string batch_shipmentsNext = jResp.StringOf("batch_shipments.next");
string batch_shipmentsPrevious = jResp.StringOf("batch_shipments.previous");
int object_resultsPurchase_succeeded = jResp.IntOf("object_results.purchase_succeeded");
int object_resultsPurchase_failed = jResp.IntOf("object_results.purchase_failed");
int object_resultsCreation_failed = jResp.IntOf("object_results.creation_failed");
int object_resultsCreation_succeeded = jResp.IntOf("object_results.creation_succeeded");
int i = 0;
int count_i = jResp.SizeOfArray("batch_shipments.results");
while (i < count_i) {
    jResp.I = i;
    i = i + 1;
}

i = 0;
count_i = jResp.SizeOfArray("label_url");
while (i < count_i) {
    jResp.I = i;
    i = i + 1;
}