=head1 NAME

Business::Shipping - Shipping cost calculator for UPS and USPS

=head1 INSTALLATION

 See INSTALL file for more details.
 
 perl Makefile.PL
 make
 make test
 make install

=head1 REQUIRED MODULES

 Archive::Zip (any)
 Bundle::DBD::CSV (any)
 Cache::FileCache (any)
 Class::MethodMaker (any)
 Config::IniFiles (any)
 Crypt::SSLeay (any)
 Data::Dumper (any)
 Devel::Required (0.03)
 Error (any)
 Getopt::Mixed (any)
 LWP::UserAgent (any)
 Math::BaseCnv (any)
 Scalar::Util (1.10)
 XML::DOM (any)
 XML::Simple (2.05)

=head1 GETTING STARTED

 * For USPS: Sign up online for free:
 
    - http://www.uspswebtools.com/registration/
	
	- (More info at http://www.uspswebtools.com)

    - The online signup will result in a testing-only account (only a small
	  sample of queries will work).  
	  
	- To activate the "production" use of your USPS account, you must follow the
	  USPS documentation.  Currently, that means contacting the Internet 
	  Customer Care Center by e-mail or phone:
	  
	    icustomercare@usps.com
		
		1-800-344-7779
    
 * For UPS: Sign up online for free:

   - https://www.ups.com/servlet/registration?loc=en_US_EC
   
   - (More info at http://www.ec.ups.com)
   
   - Once you get a User Id and Password from UPS, you will need to login and
     select "Get Access Key", then "Get XML Access Key".
 
=head1 USAGE EXAMPLES
 
 * See Shipping.pm POD documentation for API and usage examples.

 * Business::Shipping is used by the Interchange E-Commerce software 
   (http://www.icdevgroup.org).  For a reference implementation of 
   Business::Shipping, see the UserTag/business-shipping.tag file, it implements
   a function that takes shipping-related arguments, builds a Business::Shipping
   object, then returns the calculated cost.
   
 * The "Shopping Cart" Wobject for the WebGUI project, by Andy Grundman 
   <andy@kahncentral.net>.
   http://www.plainblack.com/wobjects?wid=1143&func=viewSubmission&sid=654
   http://www.plainblack.com/uploads/1143/654/webgui-shopping-cart-1.0.tar.gz
 
 * Let the author know if you are using Business::Shipping in your website, 
   application, etc. so it can be mentioned here.

=head1 WEBSITE
 
 http://www.kavod.com/Business-Shipping
 
The website carries the most recent version, as well as instructions for
accessing the anonymous CVS repository. 

=head1 COPYRIGHT AND LICENCE

Copyright (c) 2003 Kavod Technologies, Dan Browning. All rights reserved. 
Licensed under the GNU Public Licnese (GPL).  See COPYING for more info.

=head1 AUTHOR

 Dan Browning
 Kavod Technologies
 <db@kavod.com>
 http://www.kavod.com

=head1 CREDITS

 * See CREDITS file. 

=cut
