Neurological Phenomenon Multiplexer

    canadapost

    0.0.4 • Public • Published

    node-canadapost

    A node module for integrating with Canada Post's shipping API

    This module is early in its development and has limited functionality. Feel free to contribute.

    Getting Started

    The easiest way to grab the module is through npm:

    npm install canadapost
    

    Pass your username, password and customer ID for the Canada Post API when requiring the library:

    var CanadaPost = require('canadapost')('<username>', '<password>', '<customerId>');
    

    The module uses your NODE_ENV environment variable to determine if it's authenticating against their production or development servers, if NODE_ENV is set to anything other than 'production' it will assume development.

    Start by setting up some defaults, these can be changed any time before calling the API:

    // Put your postal code here, should match the one Canada Post has on file. No spaces, all caps.
    CanadaPost.setOriginPostalCode('V1V2A2');
    
    // Optionally provide a contract ID and tell the system to use contract rates when calculating costs.
    // Defaults to counter rates otherwise.
    CanadaPost.setContractId(5555);
    CanadaPost.useContract(true);
    

    Finding Rates for a Package

    Call the getRatesDomestic function and pass an object containing at least a weight and destinationPostalCode. Optionally you can send along package dimensions (length is the longest side, width the next longest, and height the smallest of the sides). Weight is measured in KiloGrams and dimensions are in CentiMeters.

    Postal codes should always be all caps with no spaces.

    Example:

    CanadaPost.getRatesDomestic({
      weight: 10, // kg
      dimensions: {
        length: 64.5,
        width: 54.234,
        height: 12
      },
      destinationPostalCode: 'H0H0H0'
    }, function(err, rates) {
      console.log(err,rates);
    });
    

    License

    This library is licensed under the MIT license

    Keywords

    none

    Install

    npm i canadapost

    DownloadsWeekly Downloads

    1

    Version

    0.0.4

    License

    MIT

    Last publish

    Collaborators

    • seratonik