node-shipstation

A small node module that helps integrate your application with shipstation. There are still several API endpoints with shipstation that are not implemented. Feel free to fork and make pull requests, or add issues as you please.

Install

npm install node-shipstation

Usage

After having installed it, simply require it, set it up with your own apiKey and apiSecret, and start calling methods!

var shipstationAPI = require('node-shipstation');
var shipstation = new shipstationAPI(
  'apiKey',
  'apiSecret');

shipstation.callMethods();

Functions and responses

| Functions | Returns to callback | Explanation | | ---------------- | ---------------- | ---------------- | | get (link, options, callback) | callback(err, res, body) | Base function for using get on shipstation API. Can be used if non-implemented API call needed. | | put (link, data, callback) | callback(err, res, body)| Base function for using put on shipstation API. Can be used if non-implemented API call needed. | | post (link, data, callback) | callback(err, res, body) | Base function for using post on shipstation API. Can be used if non-implemented API call needed. | | del (link, options, callback) | callback(err, res, body) | Base function for using delete on shipstation API. Can be used if non-implemented API call needed. | | addAccount (account, callback) | callback(err, res, body) | Registers a new account and generates an apiKey and apiSecret. account | | getTags (callback) | callback(err, res, body) | Gets all tags in the account. | | getCarriers ([options], callback) | callback(err, res, body) | Gets all carriers. | | getCarrier (carrier_code, callback) | callback(err, res, body) | Gets a carrier by carrier_code. | | addFunds ({carrierCode, amount}, callback) | callback(err, res, body) | Adds the specified amount of funds to the carrier by carrier_code. | | getPackages (carrierCode, callback) | callback(err, res, body) | Gets all packages for the carrier by carrier_code. | | getServices (carrierCode, callback) | callback(err, res, body) | Gets all services for the carrier by carrier_code. | | getCustomers ([options], callback) | callback(err, res, body) | Gets all customers. | | getCustomer (id, callback) | callback(err, res, body) | Gets a customer by id. | | getOrders ([options], callback) | callback(err, res, body) | Gets all orders. options | | getOrdersByTag ({orderStatus, tagId}, callback) | callback(err, res, body) | Gets all orders with the specified orderStatus and tagId. | | getOrder (id, callback) | callback(err, res, body) | Gets an order by id. | | addOrder (order, callback) | callback(err, res, body) | Adds an order. order | | updateOrder (id, changes, callback) | callback(err, res, body) | Updates an order with the changes passed to the method. | | deleteOrder (id, callback) | callback(err, res, body) | Deletes an order by id. | | setOrderHold ({orderId, holdUntilDate}, callback) | callback(err, res, body) | Sets a hold on the specified order until the specified date string. | | setLabelForOrder (label, callback) | callback(err, res, body) | Sets the label for the specified order. label | | setOrderShipped (details, callback) | callback(err, res, body) | Sets the specified order as shipped. details | | addTagToOrder ({orderId, tagId}, callback) | callback(err, res, body) | Adds the specified tag to the specified order. | | removeTagFromOrder ({orderId, tagId}, callback) | callback(err, res, body) | Removes the specified tag from the specified order. | | getProducts ([options], callback) | callback(err, res, body) | Gets all products. | | getProduct (id, callback) | callback(err, res, body) | Gets a product by id. | | getShipments ([options], callback) | callback(err, res, body) | Gets all shipments. | | addShippingLabel (label, callback) | callback(err, res, body) | Creates a shipping label/shipment. label | | getShippingRates (request, callback) | callback(err, res, body) | Gets shipping rates for the specified request. request | | voidShippingLabel (id, callback) | callback(err, res, body) | Voids the specified shipping label/shipment. | | getStores ([options], callback) | callback(err, res, body) | Gets all stores. | | getStore (id, callback) | callback(err, res, body) | Gets a store by id. | | updateStore (id, store, callback) | callback(err, res, body) | Updates the specified store. store | | getStoreRefreshStatus (id, callback) | callback(err, res, body) | Gets the specified store's refresh status | | refreshStore (id, callback) | callback(err, res, body) | Refreshes the specified store | | deactivateStore (id, callback) | callback(err, res, body) | Deactivates the specified store | | reactivateStore (id, callback) | callback(err, res, body) | Reactivates the specified store | | getMarketplaces (callback) | callback(err, res, body) | Lists the marketplaces that can be integrated with ShipStation. | | getWarehouses ([options], callback) | callback(err, res, body) | Get all warehouses. | | getWarehouse (id, callback) | callback(err, res, body) | Gets a warehouse by id. | | updateWarehouse (id, warehouse, callback) | callback(err, res, body) | Updates the specified warehouse. warehouse| | addWarehouse (warehouse, callback) | callback(err, res, body) | Adds a new warehouse. warehouse|

Helpers

node-shipstation has a few helpers that make it easier to make several different requests for the same target using chaining. Check the example below to see one in action. Operations will not be run in the order they are chained in

| Helper | Methods | |---------------|--------------------------------------| | carrier(id) | addFunds(amount, callback) packages(callback) services(callback) | | order(id) | get(callback) delete(callback) hold(date, callback) update({changes}, callback) addTag(tagId, callback) removeTag(tagId, callback) shipped(data, callback) label(data, callback) | | store(id) | update(data, callback) status(callback) refresh(callback) deactivate(callback) reactivate(callback) |

Examples

Getting An Order

shipstation.getOrder(12345, function(err, res, body){
  if(err) throw err;
  console.log('Got order');
  console.log(body);
});

Marking an Order Shipped

var orderShipped = {
  orderId: 12345,
  carrierCode: 'express_1',
  shipDate: '02/10/2015',
  trackingNumber: 'ZLU2342323',
  notifyCustomer: false,
  notifySalesChannel: false
}

shipstation.setOrderShipped(orderShipped, function(err, res, body){
  //Handle the callback.
});

Tag manipulation with Order Helper

var handler = function(err, res, body){
	console.log(body);
};

shipstation.order(12345)
	.addTag(9432, handler)
	.addTag(9554, handler)
	.removeTag(1233, handler);