= UspsTrack

USPS Track is a plugin which allows you to track US Postal Service packages easily from your Rails app.

=== Setup

First, install it with the following command:

   script/plugin install http://svn.elctech.com/svn/public/plugins/usps_track

Second, you'll need to register for an USPS developer account:

  https://secure.shippingapis.com/registration/

Once you have your USPS account, you can proceed.

=== Example

Initializes the ELC::USPS class with your USPS Username

  usps = ELC::USPS.new(username)

Tracks a package

  result = usps.track(tracking_number)

It returns an array of hashes with the following structure:

    { :eventstate   => "DE",
      :event        => "NOTICE LEFT",
      :eventzipcode => "19801",
      :eventtime    => "11:07 am",
      :eventdate    => "May 30, 2001",
      :eventcity    => "WILMINGTON" }

=== Credits

Jonathan Bartlett - This plugin is heavily influenced by ActiveShipping - http://code.google.com/p/activeshipping/


Copyright (c) 2008 Ariel H. Pillet, released under the MIT license