This is the full code for the:
/includes/modules/ups.php
that you need for your site:
<?php
/**
* @package shippingMethod
* @copyright Copyright 2003-2009 Zen Cart Development Team
* @copyright Portions Copyright 2003 osCommerce
* @license http://www.zen-cart.com/license/2_0.txt GNU Public License V2.0
* @version $Id: ups.php 14498 2009-10-01 20:16:16Z ajeh $
*/
/**
* UPS Shipping Module class
*
*/
class ups extends base {
/**
* Declare shipping module alias code
*
* @var string
*/
var $code;
/**
* Shipping module display name
*
* @var string
*/
var $title;
/**
* Shipping module display description
*
* @var string
*/
var $description;
/**
* Shipping module icon filename/path
*
* @var string
*/
var $icon;
/**
* Shipping module status
*
* @var boolean
*/
var $enabled;
/**
* Shipping module list of supported countries (unique to USPS/UPS)
*
* @var array
*/
var $types;
/**
* Constructor
*
* @return ups
*/
function ups() {
global $order, $db, $template, $current_page_base;
$this->code = 'ups';
$this->title = MODULE_SHIPPING_UPS_TEXT_TITLE;
$this->description = MODULE_SHIPPING_UPS_TEXT_DESCRIPTION;
$this->sort_order = MODULE_SHIPPING_UPS_SORT_ORDER;
$this->icon = $template->get_template_dir('shipping_ups.gif', DIR_WS_TEMPLATE, $current_page_base,'images/icons'). '/' . 'shipping_ups.gif';
$this->tax_class = MODULE_SHIPPING_UPS_TAX_CLASS;
$this->tax_basis = MODULE_SHIPPING_UPS_TAX_BASIS;
// disable only when entire cart is free shipping
if (zen_get_shipping_enabled($this->code)) {
$this->enabled = ((MODULE_SHIPPING_UPS_STATUS == 'True') ? true : false);
}
// bof: do NOT if ONLY show for Rakes
if (!IS_ADMIN_FLAG) {
global $cart;
$chk_rakes = $_SESSION['cart']->in_cart_check('products_id', '190');
if ($chk_rakes == $_SESSION['cart']->count_contents()) {
// turn off
$this->enabled = false;
}
}
// eof: do NOT if ONLY show for Rakes
if ($this->enabled) { // check MODULE_SHIPPING_UPS_HANDLING_METHOD is in
$check_query = $db->Execute("select configuration_value from " . TABLE_CONFIGURATION . " where configuration_key = 'MODULE_SHIPPING_UPS_HANDLING_METHOD'");
if ($check_query->EOF) {
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ('Handling Per Order or Per Box', 'MODULE_SHIPPING_UPS_HANDLING_METHOD', 'Box', 'Do you want to charge Handling Fee Per Order or Per Box?', '6', '0', 'zen_cfg_select_option(array(\'Order\', \'Box\'), ', now())");
}
}
if ( ($this->enabled == true) && ((int)MODULE_SHIPPING_UPS_ZONE > 0) ) {
$check_flag = false;
$check = $db->Execute("select zone_id from " . TABLE_ZONES_TO_GEO_ZONES . " where geo_zone_id = '" . MODULE_SHIPPING_UPS_ZONE . "' and zone_country_id = '" . $order->delivery['country']['id'] . "' order by zone_id");
while (!$check->EOF) {
if ($check->fields['zone_id'] < 1) {
$check_flag = true;
break;
} elseif ($check->fields['zone_id'] == $order->delivery['zone_id']) {
$check_flag = true;
break;
}
$check->MoveNext();
}
if ($check_flag == false) {
$this->enabled = false;
}
}
$this->types = array('1DM' => 'Next Day Air Early AM',
'1DML' => 'Next Day Air Early AM Letter',
'1DA' => 'Next Day Air',
'1DAL' => 'Next Day Air Letter',
'1DAPI' => 'Next Day Air Intra (Puerto Rico)',
'1DP' => 'Next Day Air Saver',
'1DPL' => 'Next Day Air Saver Letter',
'2DM' => '2nd Day Air AM',
'2DML' => '2nd Day Air AM Letter',
'2DA' => '2nd Day Air',
'2DAL' => '2nd Day Air Letter',
'3DS' => '3 Day Select',
'GND' => 'Ground',
'GNDCOM' => 'Ground Commercial',
'GNDRES' => 'Ground Residential',
'STD' => 'Canada Standard',
'XPR' => 'Worldwide Express',
'XPRL' => 'Worldwide Express Letter',
'XDM' => 'Worldwide Express Plus',
'XDML' => 'Worldwide Express Plus Letter',
'XPD' => 'Worldwide Expedited',
'WXS' => 'Worldwide Saver');
}
/**
* Get quote from shipping provider's API:
*
* @param string $method
* @return array of quotation results
*/
function quote($method = '') {
global $_POST, $order, $shipping_weight, $shipping_num_boxes;
if ( (zen_not_null($method)) && (isset($this->types[$method])) ) {
$prod = $method;
// BOF: UPS USPS
} else if ($order->delivery['country']['iso_code_2'] == 'CA') {
$prod = 'STD';
// EOF: UPS USPS
} else {
$prod = 'GNDRES';
}
if ($method) $this->_upsAction('3'); // return a single quote
$this->_upsProduct($prod);
// ups doesnt accept zero weight send 1 ounce (0.0625) minimum
$ups_shipping_weight = ($shipping_weight <= 0 ? 0.0625 : $shipping_weight);
$country_name = zen_get_countries(SHIPPING_ORIGIN_COUNTRY, true);
$this->_upsOrigin(SHIPPING_ORIGIN_ZIP, $country_name['countries_iso_code_2']);
$this->_upsDest($order->delivery['postcode'], $order->delivery['country']['iso_code_2']);
$this->_upsRate(MODULE_SHIPPING_UPS_PICKUP);
$this->_upsContainer(MODULE_SHIPPING_UPS_PACKAGE);
$this->_upsWeight($ups_shipping_weight);
$this->_upsRescom(MODULE_SHIPPING_UPS_RES);
$upsQuote = $this->_upsGetQuote();
if ( (is_array($upsQuote)) && (sizeof($upsQuote) > 0) ) {
switch (SHIPPING_BOX_WEIGHT_DISPLAY) {
case (0):
$show_box_weight = '';
break;
case (1):
$show_box_weight = ' (' . $shipping_num_boxes . ' ' . TEXT_SHIPPING_BOXES . ')';
break;
case (2):
$show_box_weight = ' (' . number_format($ups_shipping_weight * $shipping_num_boxes,2) . TEXT_SHIPPING_WEIGHT . ')';
break;
default:
$show_box_weight = ' (' . $shipping_num_boxes . ' x ' . number_format($ups_shipping_weight,2) . TEXT_SHIPPING_WEIGHT . ')';
break;
}
$this->quotes = array('id' => $this->code,
'module' => $this->title . $show_box_weight);
$methods = array();
// BOF: UPS USPS
$allowed_methods = explode(", ", MODULE_SHIPPING_UPS_TYPES);
$std_rcd = false;
// EOF: UPS USPS
$qsize = sizeof($upsQuote);
for ($i=0; $i<$qsize; $i++) {
list($type, $cost) = each($upsQuote[$i]);
// BOF: UPS USPS
if ($type=='STD') {
if ($std_rcd) continue;
else $std_rcd = true;
}
if (!in_array($type, $allowed_methods)) continue;
// EOF: UPS USPS
$cost = preg_replace('/[^0-9.]/', '', $cost);
// bof: add Rake charge
$chk_rakes = 0;
$chk_rakes = $_SESSION['cart']->in_cart_check('products_id', '190');
$chk_rakes = $chk_rakes * 14.95;
$methods[] = array('id' => $type,
'title' => $this->types[$type],
'cost' => ($cost * $shipping_num_boxes) + (MODULE_SHIPPING_UPS_HANDLING_METHOD == 'Box' ? MODULE_SHIPPING_UPS_HANDLING * $shipping_num_boxes : MODULE_SHIPPING_UPS_HANDLING) + $chk_rakes );
// eof: add Rake charge
}
$this->quotes['methods'] = $methods;
if ($this->tax_class > 0) {
$this->quotes['tax'] = zen_get_tax_rate($this->tax_class, $order->delivery['country']['id'], $order->delivery['zone_id']);
}
} else {
$this->quotes = array('module' => $this->title,
'error' => 'We are unable to obtain a rate quote for UPS shipping.<br />Please contact the store if no other alternative is shown.');
}
if (zen_not_null($this->icon)) $this->quotes['icon'] = zen_image($this->icon, $this->title);
return $this->quotes;
}
/**
* check status of module
*
* @return boolean
*/
function check() {
global $db;
if (!isset($this->_check)) {
$check_query = $db->Execute("select configuration_value from " . TABLE_CONFIGURATION . " where configuration_key = 'MODULE_SHIPPING_UPS_STATUS'");
$this->_check = $check_query->RecordCount();
}
return $this->_check;
}
/**
* Install this module
*
*/
function install() {
global $db;
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ('Enable UPS Shipping', 'MODULE_SHIPPING_UPS_STATUS', 'True', 'Do you want to offer UPS shipping?', '6', '0', 'zen_cfg_select_option(array(\'True\', \'False\'), ', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) values ('UPS Pickup Method', 'MODULE_SHIPPING_UPS_PICKUP', 'CC', 'How do you give packages to UPS? CC - Customer Counter, RDP - Daily Pickup, OTP - One Time Pickup, LC - Letter Center, OCA - On Call Air', '6', '0', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) values ('UPS Packaging?', 'MODULE_SHIPPING_UPS_PACKAGE', 'CP', 'CP - Your Packaging, ULE - UPS Letter, UT - UPS Tube, UBE - UPS Express Box', '6', '0', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) values ('Residential Delivery?', 'MODULE_SHIPPING_UPS_RES', 'RES', 'Quote for Residential (RES) or Commercial Delivery (COM)', '6', '0', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) values ('Handling Fee', 'MODULE_SHIPPING_UPS_HANDLING', '0', 'Handling fee for this shipping method.', '6', '0', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ('Handling Per Order or Per Box', 'MODULE_SHIPPING_UPS_HANDLING_METHOD', 'Box', 'Do you want to charge Handling Fee Per Order or Per Box?', '6', '0', 'zen_cfg_select_option(array(\'Order\', \'Box\'), ', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, use_function, set_function, date_added) values ('Tax Class', 'MODULE_SHIPPING_UPS_TAX_CLASS', '0', 'Use the following tax class on the shipping fee.', '6', '0', 'zen_get_tax_class_title', 'zen_cfg_pull_down_tax_classes(', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ('Tax Basis', 'MODULE_SHIPPING_UPS_TAX_BASIS', 'Shipping', 'On what basis is Shipping Tax calculated. Options are<br />Shipping - Based on customers Shipping Address<br />Billing Based on customers Billing address<br />Store - Based on Store address if Billing/Shipping Zone equals Store zone', '6', '0', 'zen_cfg_select_option(array(\'Shipping\', \'Billing\', \'Store\'), ', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, use_function, set_function, date_added) values ('Shipping Zone', 'MODULE_SHIPPING_UPS_ZONE', '0', 'If a zone is selected, only enable this shipping method for that zone.', '6', '0', 'zen_get_zone_class_title', 'zen_cfg_pull_down_zone_classes(', now())");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) values ('Sort order of display.', 'MODULE_SHIPPING_UPS_SORT_ORDER', '0', 'Sort order of display. Lowest is displayed first.', '6', '0', now())");
// BOF: UPS USPS
// $db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ( 'Shipping Methods', 'MODULE_SHIPPING_UPS_TYPES', 'Nxt AM,Nxt AM Ltr,Nxt,Nxt Ltr,Nxt PR,Nxt Save,Nxt Save Ltr,2nd AM,2nd AM Ltr,2nd,2nd Ltr,3 Day Select,Ground,Canada,World Xp,World Xp Ltr, World Xp Plus,World Xp Plus Ltr,World Expedite', 'Select the USPS services to be offered.', '6', '13', 'zen_cfg_select_multioption(array(\'1DM\',\'1DML\', \'1DA\', \'1DAL\', \'1DAPI\', \'1DP\', \'1DPL\', \'2DM\', \'2DML\', \'2DA\', \'2DAL\', \'3DS\',\'GND\', \'STD\', \'XPR\', \'XPRL\', \'XDM\', \'XDML\', \'XPD\'), ', now() )");
$db->Execute("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ( 'Shipping Methods: <br />Nxt AM, Nxt AM Ltr, Nxt, Nxt Ltr, Nxt PR, Nxt Save, Nxt Save Ltr, 2nd AM, 2nd AM Ltr, 2nd, 2nd Ltr, 3 Day Select, Ground, Canada,World Xp, World Xp Ltr, World Xp Plus, World Xp Plus Ltr, World Expedite, WorldWideSaver', 'MODULE_SHIPPING_UPS_TYPES', '1DM, 1DML, 1DA, 1DAL, 1DAPI, 1DP, 1DPL, 2DM, 2DML, 2DA, 2DAL, 3DS, GND, STD, XPR, XPRL, XDM, XDML, XPD, WXS', 'Select the UPS services to be offered.', '6', '13', 'zen_cfg_select_multioption(array(\'1DM\',\'1DML\', \'1DA\', \'1DAL\', \'1DAPI\', \'1DP\', \'1DPL\', \'2DM\', \'2DML\', \'2DA\', \'2DAL\', \'3DS\',\'GND\', \'STD\', \'XPR\', \'XPRL\', \'XDM\', \'XDML\', \'XPD\', \'WXS\'), ', now() )");
// EOF: UPS USPS
}
/**
* Remove this module
*
*/
function remove() {
global $db;
$db->Execute("delete from " . TABLE_CONFIGURATION . " where configuration_key like 'MODULE\_SHIPPING\_UPS\_%' ");
}
/**
* Build array of keys used for installing/managing this module
*
* @return array
*/
function keys() {
return array('MODULE_SHIPPING_UPS_STATUS', 'MODULE_SHIPPING_UPS_PICKUP', 'MODULE_SHIPPING_UPS_PACKAGE', 'MODULE_SHIPPING_UPS_RES', 'MODULE_SHIPPING_UPS_HANDLING', 'MODULE_SHIPPING_UPS_HANDLING_METHOD', 'MODULE_SHIPPING_UPS_TAX_CLASS', 'MODULE_SHIPPING_UPS_TAX_BASIS', 'MODULE_SHIPPING_UPS_ZONE', 'MODULE_SHIPPING_UPS_SORT_ORDER', 'MODULE_SHIPPING_UPS_TYPES');
}
/**
* Set UPS Product Code
*
* @param string $prod
*/
function _upsProduct($prod){
$this->_upsProductCode = $prod;
}
/**
* Set UPS Origin details
*
* @param string $postal
* @param string $country
*/
function _upsOrigin($postal, $country){
$this->_upsOriginPostalCode = substr($postal, 0, 5);
$this->_upsOriginCountryCode = $country;
}
/**
* Set UPS Destination information
*
* @param string $postal
* @param string $country
*/
function _upsDest($postal, $country){
$postal = str_replace(' ', '', $postal);
if ($country == 'US') {
$this->_upsDestPostalCode = substr($postal, 0, 5);
} else {
$this->_upsDestPostalCode = substr($postal, 0, 6);
}
$this->_upsDestCountryCode = $country;
}
/**
* Set UPS rate-quote method
*
* @param string $foo
*/
function _upsRate($foo) {
switch ($foo) {
case 'RDP':
$this->_upsRateCode = 'Regular+Daily+Pickup';
break;
case 'OCA':
$this->_upsRateCode = 'On+Call+Air';
break;
case 'OTP':
$this->_upsRateCode = 'One+Time+Pickup';
break;
case 'LC':
$this->_upsRateCode = 'Letter+Center';
break;
case 'CC':
$this->_upsRateCode = 'Customer+Counter';
break;
}
}
/**
* Set UPS Container type
*
* @param string $foo
*/
function _upsContainer($foo) {
switch ($foo) {
case 'CP': // Customer Packaging
$this->_upsContainerCode = '00';
break;
case 'ULE': // UPS Letter Envelope
$this->_upsContainerCode = '01';
break;
case 'UT': // UPS Tube
$this->_upsContainerCode = '03';
break;
case 'UEB': // UPS Express Box
$this->_upsContainerCode = '21';
break;
case 'UW25': // UPS Worldwide 25 kilo
$this->_upsContainerCode = '24';
break;
case 'UW10': // UPS Worldwide 10 kilo
$this->_upsContainerCode = '25';
break;
}
}
/**
* Set UPS package weight
*
* @param string $foo
*/
function _upsWeight($foo) {
$this->_upsPackageWeight = $foo;
}
/**
* Set UPS address-quote method (residential vs commercial)
*
* @param string $foo
*/
function _upsRescom($foo) {
switch ($foo) {
case 'RES': // Residential Address
$this->_upsResComCode = '1';
break;
case 'COM': // Commercial Address
$this->_upsResComCode = '0';
break;
}
}
/**
* Set UPS Action method
*
* @param string/integer $action
*/
function _upsAction($action) {
/* 3 - Single Quote
4 - All Available Quotes */
$this->_upsActionCode = $action;
}
/**
* Sent request for quote to UPS via older HTML method
*
* @return array
*/
function _upsGetQuote() {
if (!isset($this->_upsActionCode)) $this->_upsActionCode = '4';
$request = join('&', array('accept_UPS_license_agreement=yes',
'10_action=' . $this->_upsActionCode,
'13_product=' . $this->_upsProductCode,
'14_origCountry=' . $this->_upsOriginCountryCode,
'15_origPostal=' . $this->_upsOriginPostalCode,
'19_destPostal=' . $this->_upsDestPostalCode,
'22_destCountry=' . $this->_upsDestCountryCode,
'23_weight=' . $this->_upsPackageWeight,
'47_rate_chart=' . $this->_upsRateCode,
'48_container=' . $this->_upsContainerCode,
'49_residential=' . $this->_upsResComCode));
$http = new httpClient();
if ($http->Connect('www.ups.com', 80)) {
$http->addHeader('Host', 'www.ups.com');
$http->addHeader('User-Agent', 'Zen Cart');
$http->addHeader('Connection', 'Close');
if ($http->Get('/using/services/rave/qcostcgi.cgi?' . $request)) $body = $http->getBody();
$http->Disconnect();
} else {
return 'error';
}
// BOF: UPS USPS
/*
TEST by checking out in the catalog; try a variety of shipping destinations to be sure
your customers will be properly served. If you are not getting any quotes, try enabling
more alternatives in admin. Make sure your store's postal code is set in Admin ->
Configuration -> Shipping/Packaging, since you won't get any quotes unless there is
a origin that UPS recognizes.
If you STILL don't get any quotes, here is a way to find out exactly what UPS is sending
back in response to rate quote request, you can uncomment the following mail() line and
then check your email after visiting the shipping page in checkout ...
*/
//mail(STORE_OWNER_EMAIL_ADDRESS, 'UPS response', $body, 'From: <'.STORE_OWNER_EMAIL_ADDRESS.'>');
// EOF: UPS USPS
$body_array = explode("\n", $body);
/* //DEBUG ONLY
$n = sizeof($body_array);
for ($i=0; $i<$n; $i++) {
$result = explode('%', $body_array[$i]);
print_r($result);
}
die('END');
*/
$returnval = array();
$errorret = 'error'; // only return 'error' if NO rates returned
$n = sizeof($body_array);
for ($i=0; $i<$n; $i++) {
$result = explode('%', $body_array[$i]);
$errcode = substr($result[0], -1);
switch ($errcode) {
case 3:
if (is_array($returnval)) $returnval[] = array($result[1] => $result[10]);
break;
case 4:
if (is_array($returnval)) $returnval[] = array($result[1] => $result[10]);
break;
case 5:
$errorret = $result[1];
break;
case 6:
if (is_array($returnval)) $returnval[] = array($result[3] => $result[10]);
break;
}
}
if (empty($returnval)) $returnval = $errorret;
return $returnval;
}
}
