Knowledgebase

Home > Item #566

UPS Unhandled shipping errors

Item: #566
Date: 6 Aug 2003
Applies to
v5
v6

Question

I have switched my store to use UPS shipping, but whenever I try and put through an order, I get an 'An un-handled error occurred' message.

Why am I getting this and what is the solution?

Answer

UPS can throw literally hundreds of errors for problems with the set up. Some of them are captured (like bad customer address and shipping weight too heavy) and handled by CactuShop. The rest, which usually pertains to incorrect configuration, are not.

As a general rule, if you're getting and 'unhandled shipping error', it's because you haven't set up your UPS settings correctly, or your UPS account isn't activated. Check that your UserID, Password and Access Key are correct, and that your shop address is valid. Ensure that you are using the XML Access Key, not the HTML one or the developer's key.

If you are sure this is correct, check that your UPS account is live, activated, and supports the XML Rates and Services Selection.

Here are a few of the more common errors reported and how to fix them;

250003 - Invalid License Key error.
You need to ensure that the config setting UPS_AccessKey is set up correctly. If you don't have a UPS access key, you need to generate one from your UPS backend.

110108 - Shipping Country Code is incorrect
This is set in the UPS_ShopCountryCode config setting. This is the normal ISO code for the country (you can get these by looking in the tblCactuShopDestinations table) except for the United Kingdon (Great Britain), where GB should be used instead of UK.

111030 - Packages must way more than zero pounds
Make sure all your versions either have a weight, are electronic downloadable versions, or are set to 'free shipping'.

You can find specific information regarding your error by looking in the 'Rates And Services Selection' PDF document, that can be downloaded from your UPS backend.

For some overview of setting up UPS real time shipping support in CactuShop see the manual and this KB post:

Setting up UPS real time shipping support

Can't find the answer you need? Click here to open a support ticket.

« Back