PHP InterShipper class

Version 1.5

Description

This tag will return a multi-dimensional array containing shipping methods and rates for shipping a package using your choice of several shipping carriers. All necessary information for getting accurate rate quotes can be specified in request. You must have an account with InterShipper, and agree to their terms of service to use this class. Accounts are available at no cost, and no charge is made for the service. Please see InterShipper's site for further information. Use of this tag implies agreement with InterShipper's licensing requirements.

Release Notes:

5 APR 2000: Version 1.5 InterShipper now supports the Track() method for retrieving tracking information on shipments. The version number was brought into line with the ColdFusion version. Changed separator for carriers to comma for safety and consistency. Pipe symbol will continue to work, but is deprecated.
29 FEB 2000: Version 0.9 Initial development and testing. All parameters are active, and the class is fully functional. It just requires better data-validation and error-control.

Usage

<?
	include('intershipper.php');
	
	// Create a class instance
	$IShip = new InterShipper();
	
	// Set parameters
	$IShip->setVar("email", "youraccountemail");
	$IShip->setVar("password", "yourpassword");
	$IShip->setVar("Opostalcode", "85224");
	$IShip->setVar("Dpostalcode", "19605");
	$IShip->setVar("carriers", "ANX|FDX|UPS|USPS");
	$IShip->setVar("weight", 1.1);
	
	// Send the request
	if($IShip->Quote(30))
	{
		// If it succeeds...
		// $quote will hold the array
		$quote = $IShip->getQuote();
	}
	else
	{
		// Print the error message
		echo $IShip->getError();
	}
?>

Security:

Please note that these requests are made in clear text. Technically, the only sensitive information is the email and password fields, and quite frankly, the risk is very low since there's not much that can be done with them other than request shipping info. However, if this is a consideration, InterShipper supports having these two fields encrypted using DES56, and Base64 encoded. Just encrypt the field using your IP address as the key, Base64 encode the result, and use that for the parameter. InterShipper also supports the use of arbitrary keys by setting the key on their website. For more information, please see the API documentation at InterShipper's website.

Functions:

Parameters:

Return Values:

QUOTE

The getQuote() method will return a multi-dimensional array. The first dimension represents each shipping method, and the second dimension contains the details of that method.

Second Dimension Members:

TRACK

The getTrack() method will return a multi-dimensional array. The first dimension represents each tracking request, and the second dimension contains the details of that method.

Second Dimension Members:

This document and the InterShipper class code are © 1999, 2000, Desert Raven, and are released under the conditions of the GNU LGPL. InterShipper is a registered trademark of BITS, Inc. Desert Raven is not affiliated with InterShipper or BITS Inc in any way, and neither InterShipper nor BITS Inc. are responsible for the operation of this class. Questions regarding this class should be addressed to Michael Sheldon at info@desertraven.com. Questions regarding the InterShipper service should be addressed to InterShipper.