UPS Shipping Method

UPS Shipping Method allows you to get shipping rates from the UPS API. It requires that your store use US Dollars for its currency and your server to use SimpleXML. The extension primarily works with measurements in Inches (in) and weight in Pounds (lbs), but other units can be converted automatically.

UPS can calculate quotes for both domestic and international parcels.

Note: This extension does not handle freight shipping, and there is a weight limit of 150 lbs. The API and the built-in box packer require that non-virtual products have weights and dimensions set. More at: Adding Shipping Dimensions and Weights to Products.

Installation ↑ Back to top

To install this extension, you can follow these instructions, or follow the below steps to do a manual installation.

  1. Download the extension from your dashboard
  2. Upload the plugin folder to your /wp-content/plugins/ directory
  3. Activate ‘UPS Shipping Method’ from the Plugins menu within WordPress

For support and one-click updates, you’ll also need to install our WooCommerce Helper plugin.

More information at: Installing and Managing Plugins.

API & Debug 

Go to: WooCommerce > Settings > Shipping > UPS.

  1. UPS User ID – Get your UPS User ID from the developer site by signing up at UPS Developer Kit.
  2. UPS Password – Set by you during signup.
  3. UPS Access Key – Sent to you after signup.
  4. UPS Account Number – Sent to you after signup.
  5. Debug Mode – Enable/disable debug mode to show debugging information on your cart/checkout.

Configuration ↑ Back to top

  1. Go to: WooCommerce > Settings > Shipping.
  2. Select your Shipping Zone that you want to add the method to, and press the Add shipping method + button on the right
    Add shipping method
  3. Select UPS from the dropdown and press Add shipping method:
    screen-shot-2016-10-07-at-11-09-04-am
  4. Configure the settings:
    1. Method & Origin Settings
      1. Method Title – Name the shipping method. This is visible to customers.
      2. Origin City – Enter city you are sending from.
      3. Origin Postcode – Set to the postcode from where you ship. It is sent to the UPS API.
      4. Origin Country – Set to the country from where you ship. It is sent to the UPS API.
    2. Services and Packaging
      1. Services – Choose to rename and/or rearrange the order of UPS shipping rates.
      2. Offer Rates – Select whether to display all rates available or only the cheapest.
      3. Negotiated Rates – Enable negotiated rates or not. More at: Account-Specific Negotiated Rates. This must be approved by UPS, or the API returns an error. It is sent to the UPS API.
      4. Delivery Confirmation – Optionally you may charge customers for delivery confirmation. This just adds the specified amount to the returned rates.
      5. Parcel Packing Method – See below.
      6. UPS Packaging – You can select from a built-in list of standard UPS packaging to use.
      7. Custom Boxes – Here you can add custom box sizes to pack into.
    3. Advanced Options
      1. Origin Address – Sometimes you may need to enter the address for the sender/origin.
      2. Residential – Choose whether to indicate deliveries as residential or commercial addresses.
        * Users are permitted to enter PO Boxes as a shipping address, even though UPS does not allow it.
      3. Insured value – Request Insurance to be included in UPS rates.
      4. Pickup Type – Choose a pickup method. More at: UPS Pickup Options.
      5. Fallback – Enter a fallback amount for shipping, if no rates are found.
      6. Weight/Dimension Units – Only change this if you’re getting the “This measurement system is not valid for the selected country method”.
Note: The UPS shipping extension is a calculator for all products in the cart and does not exclude products based on shipping classes.

Parcel Packing Methods ↑ Back to top

There are two packing methods with UPS, and each affects the parcels you send to the API.

Pack items individually (Default) ↑ Back to top

Each item in your cart (non virtual) is sent to the UPS API. Quotes for all items are combined to calculate the final cost. Only the weight is required, but also entering product dimensions produces a more accurate quote. For even more accuracy, we recommend the box packer method.

To use this method add a new product then scroll down to Product Data > Shipping to enter the product dimensions.

Pack into boxes with weights and dimensions (Recommended) ↑ Back to top

Using this method, you create your own custom box sizes in UPS Settings. The extension uses the weight/dimensions of products added to the cart, filling the custom box size from smallest to largest based on volume and size, then sends the number of boxes/size to the UPS API for a shipping estimate. We recommend using both product weight and dimensions for this option for accuracy.

Selecting this option you must follow the steps listed below for UPS Packaging or Custom Box Packing for this method to work.

UPS Packaging ↑ Back to top

UPS offers standard boxes for shipping. UPS Packaging:

UPS-Packaging-Settings

Start typing the package you want to include and it auto-populates the field for you.

Note: If you choose Pack into boxes with weights and dimensions (Recommended) but have not chosen any UPS Packaging, nor defined any custom boxes (as explained below), the plugin displays the error message: “UPS is enabled, and Parcel Packing Method is set to ‘Pack into boxes’, but no UPS Packaging is selected and there are no custom boxes defined. Items will be packed individually.”

Custom Box-Packing ↑ Back to top

The box packer included with this shipping method groups items into boxes that you define by height, width, length, weight and max-weight. The packing is mainly volume based, but also considers item sizes.

The box packer is volume based. In most cases, this provides good results but is never as accurate as a real person packing a box (see BIN Packing Problem). Therefore, it is important to understand that packing results are as accurate as they can be, and any anomalies should be acceptable.

Setting up box sizes ↑ Back to top

Go to WooCommerce > Settings > Shipping > UPS > Custom Boxes and select Add Box to set up box dimensions:

Box Settings
Box Settings

Outer dimensions are used for parcel dimensions and are passed to the API.

Inner dimensions are used for packing, and items should fit within these.

Box weight is the weight of the actual box, and is added to the weight of contents.

Max weight is the maximum weight your box can hold. This includes contents weight and box weight.

How the calculation works ↑ Back to top

The packer:

  1. Finds boxes that fit items being packed (uses H x W x D).
  2. Packs all fitting items into boxes (using volume).
  3. Uses the largest box that fits 100% of items *or* uses the highest % packed box, and then passes unpacked items back and repeats the process.
  4. Packs unpackable items alone, using item dimensions.
  5. Returns all packed boxes.

Handling Fees ↑ Back to top

To add handling fees to shipping calculations, you can use a Price Adjustment column in the Services section. Each UPS service can be increased separately, using price adjustment columns in the row.

Use the Price Adjustment ($) column to add a flat amount to the shipping quote. In this example, the 3-Day Select and Ground shipping methods are increased by $3.50.

flat-adjustment

Use the Price Adjustment (%) to increase the shipping quote by a percentage. In this example, the 3-Day Select and Ground shipping methods are increased by 1% of the quote returned by UPS.

percentage-adjustmnet

Customer Usage ↑ Back to top

Customers get quotes, after inputting their address, from two places:

  1. Cart page – via the shipping calculator
  2. Checkout page – via the shipping and billing forms
Rates can be selected by customers as normal.
ups-checkout-options

Available Shipping Services for UPS Extension ↑ Back to top

These services are included with the UPS Shipping extension:

Domestic

3 Day Select
Ground
2nd Day Air
2nd Day Air AM
Next Day Air
Next Day Air Saver
Next Day Air Early AM

International

Standard
Worldwide Express
Worldwide Express Plus
Worldwide Expedited Standard
Worldwide Saver

FAQ ↑ Back to top

I dropship items. Can I use multiple origin zip codes? ↑ Back to top

No, the WooCommerce UPS extension currently uses one origin zip code to request quotes from UPS.

Does this create shipping labels and tracking codes? ↑ Back to top

No it does not. It provides the integration between UPS and WooCommerce, so you can calculate shipping rates for customers and collect the correct amount of payment in checkout.

You get shipping labels and tracking numbers directly from UPS or can buy a different plugin to handle that for you.

Troubleshooting ↑ Back to top

No rates returned/no rates available ↑ Back to top

  • Confirm that your API credentials are correct.
  • Enable development mode, or turn on WP_DEBUG to see debugging information on the cart page. This often reveals the issue.
  • Check that your products have sizes and weights set – without this, the calculation cannot be performed.

Customize ↑ Back to top

If you would like to remove UPS as a shipping option for some shipping classes you can use the WooCommerce Conditional Shipping and Payments extension.

Or you can use code to do this.

Note: The following is considered custom code. We are happy to give it to you, but we are unable to provide support or help customize it to suit your store. Only use it if you are comfortable with PHP and custom coding; and troubleshooting on your own.

You can add the following code to your functions.php. You need to change shipping classes used on the 14th line:

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top