uShip

A uShip API wrapper for Node.js. See the API documentation at https://developer.uship.com/docs

Installation

npm install uship

Testing

Get an API key from your settings page: https://developer.uship.com/apps/mykeys. You may need to contact api-support@uship.com. See: https://developer.uship.com/docs.

Copy config.json.sample to config.json and update the file with your account settings.

npm i -g mocha
npm test

Usage

The module wraps the api and returns when.js promises.

Estimate:

var uShip = require("uship");
var uship = new uShip(API_KEY, API_SECRET, USHIP_USERNAME, USHIP_PASSWORD);
var data = {
route: {
items: [
{
address: {
postalCode: "78704",
country: "US"
}
},
{
address: {
postalCode: "85704",
country: "US"
}
}
]
},
items: [
{
commodity: "CarsLightTrucks",
year: "1998",
makeName: "Ford",
modelName: "Ranger"
}
]
};
uship.estimate(data).then(function(result){
console.log(JSON.stringify(result));
});
/*
Outputs: {
"route":{
"distance":{
"kilometers":1445.1873,
"label":"898 mi.",
"shortLabel":"898 mi."
},
"items":[
{
"address":{
"majorMunicipality":"Austin",
"postalCode":"78704",
"stateProvince":"TX",
"stateProvinceLabel":"Texas",
"country":"US",
"countryLabel":"United States",
"latitude":30.244144,
"longitude":-97.76286,
"label":"Austin, TX",
"shortLabel":"Austin, TX"
}
},
{
"address":{
"majorMunicipality":"Tucson",
"postalCode":"85704",
"stateProvince":"AZ",
"stateProvinceLabel":"Arizona",
"country":"US",
"countryLabel":"United States",
"latitude":32.32818,
"longitude":-110.98608,
"label":"Tucson, AZ",
"shortLabel":"Tucson, AZ"
}
}
]
},
"price":{
"value":631.21,
"label":"$631.21",
"shortLabel":"$632"
}
}
*/

RateRequest:

var shipmentDetails = {
route: {
items: [
{
address: {
postalCode: "78703",
country: "US"
},
timeFrame: {
earliestArrival: "2015/07/07",
latestArrival: "2015/07/07",
timeFrameType: "on"
}
},
{
address: {
postalCode: "78653",
country: "US"
},
timeFrame: {
earliestArrival: "2015/07/10",
latestArrival: "2015/07/10",
timeFrameType: "on"
}
}
]
},
items: [
{
commodity: "CarsLightTrucks",
year: "2011",
makeName: "Ford",
modelName: "Escape",
unitCount: 1,
isRunning: true,
isConvertible: true,
isModified: true
}
],
thirdPartyId: ""
};
uShip.rateRequest(shipmentDetails).then(function (result) {
console.log(result.location);
})
/* Output
Location Header: https://api.uship.com/v2/rateRequests/rateRequestID/rates
*/

Supported Methods

Shipping Price Estimates (API Documentation)

Create Rate Request (API Documentation)

• uShip::estimate(data)
• uShip::rateRequest(data)

Todo

• Other methods
• Extend documentation