The Customer Classification determines the rate returned by UPS. This parameter must be different from 'None' when the Pickup method is set to 'Suggested Retail Rates'. It is only used in case your ship from address is in US.The default values depends on the UPS pickup method:

The default value is Wholesale when the Pickup method is daily pickup.

The default value is Occasional when the Pickup method is One Time Pickup or On Call Air or Letter Center or Air Service Center

The default value is Retail when the Pickup method is Customer Counter

Choose the Packaging. The options are:

Unknown

Ups Letter

Package/customer supplied

UPS Tube

Express Box

25KG Box

10KG Box

Pallet

Small Express Box

Medium Express Box

Large Express Box

Select the Shipment strategy

Based on weight: the number of packages needed is calculated dividing the total weight of the products with the maximum package weight allowed.

Based on volume: the number of packages needed is calculated by dividing the total volume of all products with the maximum package volume defined in the parameter Boxes dimension

Each product sent as one package: each products is put into one package

Enter the Boxes dimension and select the Dimension unit of the boxes only when the parameter Shipment strategy is set to Based on volume

Select if you want that the returned UPS shipment rates include an Insured value (more expensive).

Set Local Weight Unit to the system you use to measure product weight. The weight system supported by UPS varies by country (example LBS for USA, KGS for France).

Weight Padding and Dimensions padding allows you to pad the weight or dimensions for shipping package

Select the Destination type to which the shipment is being sent. The options are:

Auto: based on delivery address entered by the client during checkout, the UPS shipment plugin will determine if the address is residential or commercial depending if the company name is filled or not,

Commercial

Residential: A residential delivery is defined as delivery to a location that is a home, including a business operating out of a home.

Free shipment: enter an amount for which the shipment is offered. Do not enter any value, if you do not offer shipment

Select the Accepted Countries for the shipment. If no country are selected, the shipment is available for all countries.

Choose a logo for your shipment

Select Yes or No for Charge Tax

Choose the Tax Rule

Test your installation

Attention: Be sure your products have weights entered.

Add a product to your cart

Click on Select shipment: all the available services and rates are displayed.

Trouble shooting

Q: We are sorry, no shipment method matches the characteristics of your order.

Reason 1: Most of the time, the reason for that message is a wrong Delivery Service configuration. To check that this the reason, log in as vendor on the front end, and do a checkout. The following message will be displayed, followed by the delivery Services actually returned by UPS, and the delivery services that you have configurated in your shipment method.

Info: UPS: The delivery services configurated in the shipment method do no match the Delivery Services returned by UPS.If they do not match, then no shipment is listed.

Check the complete list of the delivery services depending on the originating country, and change the parameter Delivery Services according to your originating country, and the destination countries.

Reason 2: Another possible reason is that you have not set weigth for your products. Just like before, to check that this the reason, log in as vendor on the front end, and do a checkout. The following message will be displayed: Packages must weigh more than zero pounds.

Check that all your products have a weigth.

Reason 3: Another possible reason is that you have the weigth is over the maximum limit autorized by UPS. Just like before, to check that this the reason, log in as vendor on the front end, and do a checkout. The following message will be displayed: The maximum per package weight for the selected service from the selected country is xxx pounds.

UPS has established specific weight and size limits for the packages that you send with all UPS services.

A: The UPS installed in VM1 has using the package type: "Unknown". Select the same package type in the plugin.

Q: Fatal error: Class 'DomDocument' not found in /var/www/html/plugins/vmshipment/istraxx_ups/istraxx_ups.php on line 934

A: Check that php-xml is installed on your server. If it is installed, check that the plugin has been correctly installed.

Verifying Shipping Rates

The US online calculator is a really usefull tool, it helps you to determine the available services form your wharehouse to the delivery point, and also the rate and delivery time. It helps you to understand which delivery service feets best your needs. Oneline calculators are available for each country posting countries. When comparing shipment charges between plugin and the UPS online calculator tool providing the rates, be sure that the requests are identical.

Negociated Rates

Negotiated Rates are available in the UPS Customer Integration Environment and are returned when the Negotiated Rate parameter is set to Yes. The Negotiated Rates returned do not reflect the contractual rate and may vary. (A flat 1% discount is returned).Shipping rates quoted are estimates based on the information supplied. Other shipping charges may apply and the final shipping charge may differ depending upon UPS Account Number and how the package is tendered to UPS. Please see the applicable UPS Rate and Service Guide for details.

When comparing shipment charges between applications and API providing UPS rates, be sure that the requests are identical. Working through any discrepancies will require knowledge of all parameters posted along with defaults, numeric rounding, and rate table used by the applications being compared. For more information on UPS Services, refer to the UPS Service Guide You can check your results against the UPS Quick Cost CalculatorTM web application.

Usefull links

UPS Rate and Service Guide is a guide provided by UPS that explains the steps involved in preparing and processing the shipment. The section choosing a Service helps you to determine the package service that best meets your needs for domestic, export and import shipping.

US shipping services : this page lists the different delivery services from US based on your shipment's destination, and gives more information for each of them. Similar pages are available for each country posting countries.