Search Knowledge Base by Keyword

Setting Up WooCommerce UPS Shipping Plugin

In this tutorial, we will show you how to easily set up WooCommerce UPS Shipping Plugin with Print Label to get real-time UPS shipping rates, print shipping labels, and to track your shipments from your WooCommerce store. It is a complete guide to integrating UPS shipping services to your online store.

Overview

United Parcel Service, Inc. (UPS) is the world’s largest package delivery company. UPS delivers in 220 countries and territories around the world. UPS also operates its own airline and air cargo delivery service.

This tutorial provides an excellent launch pad to get yourself acquainted with the WooCommerce UPS Shipping plugin. You will get the essential knowledge to set up the plugin with step-by-step instructions.

Installation

After purchasing the WooCommerce UPS Shipping plugin, visit pluginhive.com > MY ACCOUNT. The plugin zip file would be available in the API Downloads section.

  1. Download .zip file from MY ACCOUNT (API Downloads section).
  2. Log in as the WordPress Admin of your online store.
  3. Navigate to Plugins > Add New and upload the downloaded UPS plugin .zip file.
  4. Activate the UPS plugin.

Setting Up The UPS Plugin

After installing and activating the plugin, a new shipping method ‘UPS’ is added to WooCommerce Shipping settings. Now you can configure this UPS Shipping method as per your requirement. You can navigate to settings in two ways as shown below:

  • WooCommerce > Settings > Shipping > UPS

UPS settings page

OR

  • Plugins > Installed Plugins > UPS WooCommerce Shipping > Settings
UPS shipping plugin settings
UPS shipping plugin settings

License Activation

To activate the plugin, you need to enter the API License Key and the email ID used for the purchase.  You can find the API License Key in the order completion email or in the API Keys section.

Note: If you wish to use the plugin in a test environment, you do not need to activate the licence.You need to activate the licence for your live environment.

General Settings

The general settings field is as shown below:

Plugin General settings

  1. Real-time Rates: Select the Enable check box to enable fetching real-time rates using the UPS Plugin.
    Note: Unchecking this feature only disables rates in the Cart/Checkout page. UPS Shipping Label and Shipment Tracking functionality will still be available to you.
  2. UPS Method Title: Method Title is visible in the Cart/Checkout page under Shipping options. Specify Method Title as required (defined by you).
  3. Method Availability: This field allows you to make the UPS shipping method available for selected countries. The available options are as given below:
    • All Countries: This makes the UPS shipping options available to the customer in all the countries. It is set as a default option.
    • Specific Countries: This allows you to specify the list of countries for which you want to provide UPS shipping. UPS Shipping Method would be available only in the listed countries.
  4. Debug Mode: If you are not getting the shipping rates, the shipping rates that you are getting are lesser or higher than expected, or you are not getting all the available shipping options, then you need to enable the Debug option to find the error(s). You can also see the warning(s) given by UPS plugin. By enabling debug mode, you can trace issues using the log. You can see information about debugging at the top of the Cart and Checkout page. After enabling the debug mode, add a product to the cart and visit the Cart or Checkout page to see the debugging information.
    Note: Make sure you disable the Debug Mode after debugging. 

Generic API Settings

Generic settings are used to get real-time rates, labels and tracking information from the UPS.

For accessing UPS real-time information, you need to register with UPS. After a complete registration, you get a User ID, Password, Access Key and Account Number from UPS.

How to register with UPS?

  1. Sign up with UPS.com to get Account details.
  2. Register with My UPS.
  3. Log-in with your UPS credentials.
  4. Request for an access key.

After registration, you get a User ID, password, Access Key, and UPS Account Number. You need to enter these details in the Generic Settings fields shown below:

UPS API settings

  1. API Mode: With this field, you can set a required API mode for getting real-time rates and printing the labels. The available options are as given below:
    • Test: Test mode is used to do some test purchasing and sample label printing by using UPS API. There is no real money transaction involved in test mode.
      *Note: This mode is used only for development purposes and customers should not have access to this mode.
    • Live: Live mode is used for actual purchase and label printing.
  2. Company Name: Enter the name of your company/store
  3. Your Name: Enter your name with which you have registered with UPS.
  4. Attention Name: You can enter your business as the attention name.
    Note: This name gets printed on labels if you are shipping from origin address and not from Billing address.
  5. User ID: Enter the User ID that is provided by UPS.
  6. UPS Password: Enter the password for the above User ID.
  7. UPS Access Key: Enter Access key that is provided by UPS.
  8. UPS Account Number: Enter your UPS account number.

Weight and Dimension Unit Setting

The plugin allows you to set a unit for product dimensions and weight. Dimensions and weight in the selected unit are passed to UPS. The setting is as given below:

Weight and dimensions

Select a required option from the given drop-down list. The options available are as given below:

  • LB/IN: Product weight and dimensions will be in pound(lb) and inches (in).
  • KG/CM: Product weight and dimensions get converted to kilograms (kg) and centimeters (cm).

Negotiated Rates Setting

Negotiated Rates are the contract rates established by UPS and your UPS Account Representative. Enabling Negotiated Rates within your shipping systems allows you to view the most current and accurate rates for your UPS account.

The Setting is as given below:

Negotiated rates

Select the Negotiated Rates check-box to enable it if your account has negotiated rates available.

Insured Value Settings

UPS covers the loss or damage, at no extra cost, for up to $100.00 on shipments with no declared value. If the value of your goods exceeds this amount, you will be charged an additional insurance amount which will be added in the shipping rates.

The Setting is as given below:

Insured value

Select the Insured Value checkbox to include an insurance amount in UPS shipping rate.

Minimum Order Amount

There is also a setting if you want the insurance to be applied above a certain value. You can set the option for the minimum amount above which you require the insurance.

Freight Services

Enable this option to use UPS freight shipping services. Once enabled, you can see the following four freight services are added in the Services and Packaging table:

  • Freight LTL (UPS)
  • Freight LTL – Guaranteed (UPS)
  • Freight LTL – Guaranteed A.M. (UPS)
  • Standard LTL (UPS)

Estimated Delivery Date Settings

Estimated delivery date settings

Show Estimated Delivery Date

This option allows you to display estimated delivery dates on the cart page. The plugin will get the dates from the UPS and display it on the cart ad the checkout page.

Estimated Delivery Text

You can set up a custom text to display along with the delivery dates.

Cut-off Time

You can define a time after which the delivery will be scheduled for the next day. For example, if you enter 23:00, any orders placed after this time will have 1 additional day added to the delivery date.

Pickup and Destination

Under this section, you can force the Ship To address to be residential:

Pickup Settings

Residential: Select the residential checkbox if the delivery of the shipment is at a residential address.

The UPS API has an inbuilt address validation mechanism which characterizes the address as residential or commercial. The Residential option here is only to allow shop owners to explicitly mark the addresses as residential.

Label Printing Settings

The Label Printing Settings field is as shown below:

Shipping Label settings

  1. Label Printing: Select enable/disable from the drop-down for label printing. By default, printing shipping label is activated.
  2. Print Label Type: With this field, you can set a required file format for printing the labels. The available options are as given below:
    • GIF: This option prints the label in Graphics Interchange Format which is used on the World Wide Web due to its wide support and portability.
    • PNG: This option prints the label in Portable Network Graphics (PNG) which is a raster graphics file format that supports lossless data compression.
    • ZPL: This option prints the label in Zebra Programming Language (ZPL) which is used for Zebra printers.
    • EPL: This option prints the label in Eltron Programming Language (EPL) which is used for Eltron Printers.
  3. Display Label in Browser: Select the checkbox to display the shipment label in the browser instead of downloading as a file.

Shipment Tracking Settings

The Shipment Tracking Settings field is as shown below:

Tracking Settings

  • Shipment Tracking: It provides information to customers about the route of a package and the anticipated date and time of delivery. The available options are as given below:
    • Disable for Customer: This option disables tracking information only at customer end. For Example, the Order page of the Customer. You can still utilize this feature.
    • Enable: This option enables UPS shipment tracking for you as well as your Customer. Once the ordering by the customer is complete, it sends an automatic Email to the customer with tracking information. For detailed information about UPS shipment tracking services, see UPS Shipment Tracking.
      For a detailed understanding of how our WooCommerce UPS plugin handles shipment tracking, read this article
    • Disable: This option disables UPS shipment tracking for you as well as your Customer.

Address Settings

The Address Settings field is as shown below:

Address Settings

  1. Ship From Address Preferences: With this field, you can set an address of the actual order shipper. The available options are as given below:
    • Origin Address:  With this option, the Origin address will be the address of the shipper.
    • Billing Address: With this option, the billing address of the admin on the Order page will be the address of the shipper.
  2. Origin Address: Enter the address of the WooCommerce shop owner.
  3. Origin City: Enter the city of the WooCommerce shop owner.
  4. Origin Country: Enter the country of the WooCommerce shop owner.
  5. Origin State Code: Enter the State code of the WooCommerce shop owner, if the state is not listed in the above Origin Country drop-down list.
  6. Origin Postcode: Enter the postcode of the place of the WooCommerce shop owner.
  7. Your Phone Number: Enter the Email of the shop owner so that a sender can receive the Email from UPS while creating the label.

UPS Services

UPS provides different kinds of services that suit the various needs of the customer. If the customer is in need of fast delivery, then the customer can opt for Next Day Air Services. Likewise, the customer can select the best-suited service. The plugin supports these services domestically and internationally. Domestic services supported by the plugin are as listed below:

  • 3 Day Select
  • Ground
  • 2nd Day Air
  • 2nd Day Air AM
  • Next Day Air
  • Next Day Air Saver
  • Next Day Air Early AM
  • Retail Ground (previously known as Standard Post)
  • SurePost Less than 1 lb
  • SurePost 1 lb or Greater
  • SurePost BPM
  • SurePost Media
  • First Class Mail
  • Priority Mail
  • Expedited Mail Innovations
  • Priority Mail Innovations
  • Economy Mail Innovations
  • Access Point Economy

International services supported by the plugin are as listed below:

  • Worldwide Express
  • Worldwide Express Plus
  • Worldwide Expedited
  • Saver

You can enable the desired services. For more information about services, See the UPS Service Guide. The UPS services settings are as given below:

UPS services supported by plugin

Services: In the above screenshot, all the services are displayed. However, you can select only the required services. The services you don’t select are not shown to the customer even though they are available services from UPS.

You can adjust the shipping price by adding/subtracting the required amount to/from the actual shipping cost. Use the minus sign() for subtracting the amount. You can mention the amount in % and $ for each service.

For example, the shipping cost of GROUND returned by UPS is $5.

Scenario 1: Price Adjustment for GROUND is $5 as shown below:

Price adjustment

Total Cost displayed for GROUND is $10 (5+5).

Scenario 2: Price Adjustment for GROUND is 10 % as shown below:

Percentage price adjustment

Total Cost Displayed for GROUND is $5.5 (the 10% of 5 is added to 5 to get the actual shipping cost).

Scenario 3: Price Adjustment for GROUND is $5 and 10% as shown below:

Price adjustment for both percentage and integer

Total Cost displayed for GROUND is $10.5 (the 10% of 5 is added to 5 + 5  to get the actual).

UPS Shipping Rates

Under this section, you can set different rate options. These settings determine the rates that you offer to the customer. Rate setting fields are as shown below:

Currency settings

  1. Offer Rates: Once you get the quotes from UPS, you can choose which quotes to show to the Customer. You can select the required option from the Offer Rates drop-down list, and the options available are as given below:
    • Offer the Customer all the returned rates: This option shows quotes for all the available services that are returned by UPS and also selected by you in the Services Setting.
    • Offer the Customer the cheapest rate only: This option only shows the service with the cheapest quote from the available services.
  2. Fallback: This field indicates the shipping cost which is taken as default cost if UPS does not return any quotes. This allows the customer to check out even if  UPS does not return any quotes.
  3. Currency: You can choose the currency you want to use to communicate with UPS
  4. Conversion Rate: Enter the conversion amount if you are using a currency different from the one that you set up in the WooCommerce base location. This amount gets multiplied with the shipping rates.

Note: Leave it empty or add ‘1’, if you are using the same currency (you set up in the WooCommerce currency settings) to communicate with UPS. It means conversion is not required.

UPS Real-Time Rate Settings

You can get the real-time rate for a particular item by using UPS API. With price calculator, you get real-time postage rates very easily and quickly for domestic as well as international shipping. Real-Time rates are calculated according to the product dimension and weight. Also, the best-fitted box rates are returned from UPS. These rates will depend on the method used for packing the parcel which is explained later in this section. The UPS Real-Time rate settings are as shown below:

Packages in the order page

  • Parcel Packing: The plugin provides you three options to pack a parcel(s) as given below:
    1. Pack Items Individually: In this option, each item in the cart is packed separately. The total shipping cost calculated by adding the shipping cost for each item.
      For example, The shipping cost of Item X is $10. If the customer adds two units of Item X to the cart, the total shipping cost is  $10 x 2, which is $20.
      Note: This is the default option.
    2. Pack into boxes with weight and dimensions: If packing items individually do not suit your business, you can define the required box sizes under the Box Dimensions section. All the cart items are packed into custom boxes defined in Box Dimensions settings. The best fit box is chosen automatically from the defined boxes. This is the recommended option.
    3. Weight-based: In this option, the weight of the entire cart item is summed up and passed to UPS API to get rates.
  • UPS Packaging: Correct packaging is essential for your shipment to arrive at its destination on time and in good condition. You can choose the packaging options offered by UPS. The available options are as given below:
    1. UPS Letter: You can ship letters, business correspondence, and documents. Dimensions are: 12.5″ x 9.5″ x 0.25″. Weight limit= 0.5 lbs.
    2. Tube: You can ship larger documents that should be rolled instead of folded, such as blueprints, charts, maps, drawings, and posters. Rates are based on the total actual weight or the total dimensional weight of all packages in a shipment, whichever is greater, and the respective destination. Dimensions are: 38” x 6” x 6”. Weight limit = 100 lbs.
    3. PAK: You can ship flat, unbreakable items, such as large reports or bulky documents. Rates are based on the total actual weight or the total dimensional weight of all packages in a shipment, whichever is greater, and the respective destination. Dimensions are: 17″ x 13″ x 1″. Weight limit = 100 lbs
    4. 25 Kg Box: You can use this box for UPS Worldwide Express shipments. It holds up to 25 kg (55 lbs). Export paperwork included. Charges are based on flat rate and zone. Dimensions are: 19.375″ x  17.375″ x 14″. Weight limit = 25 lbs.
    5. 10 Kg Box: You can use this box for UPS Worldwide Express shipments. It holds up to 10 kg (22 lb). Export paperwork included. Charges are based on flat rate and zone. Dimensions are:  16.5″ x 13.25″ x 10.75″. Weight limit = 10 lbs
    6. Small Express Box:  You can ship smaller items such as books, tapes, etc. Dimensions are: 13″ x 11″ x 2″. Weight limit = 100 lbs.
    7. Medium Express Box: You can use it for a wide variety of merchandise. Dimensions are: 15″ x 11″ x 3″. Weight limit = 100 lbs.
    8. Large Express Box: You can use it for a wide variety of merchandise. Dimensions are: 18″ x 13″ x 3″. Weight limit is 30 lbs.

For more information, see UPS Packaging Guidelines.

Custom Box Dimensions: These box dimension settings are applicable only when the Pack into boxes with weights and dimensions option is selected. Here, you can define the outer and inner dimensions of boxes. Outer dimensions are the dimensions of the package. Inner dimensions are the dimensions of the product. For heavy packing box, enter the weight of the box so that it gets added in product weight to calculate the shipping rates. You can select the checkbox under Letter field if you want to mail a letter. According to the requirement, you can add or remove the box dimensions.

For Example, consider you have product X of dimensions 9 x 5 x 2 and weight 10 lbs. You can set up Custom Box Dimensions as shown in the below screenshot:

Custom Boxes

For this example, we can assume the following:

  • If there is one unit of product X in the cart, then the first option should be good.
  • If there are two units of product X in the cart, the second box can be used for packing.
  • If there are four products X in the cart, then the third box gets selected for packing.
  • Likewise, you need to define inner and outer sizes for each logical box according to the packing style being followed for different products having different quantity.

Advanced Settings

Under this section, you can configure certain advanced features of the plugin. The settings are as described below:

Advanced settings

  • Rates based on pick-up type: If you ship regularly with your UPS Account, you are probably using a scheduled pickup option from UPS. This field allows you to determine rates based on the pickup type that you choose from UPS. The available options in the drop-down are as follows:
    • Daily Pickup
    • Customer Counter
    • One Time Pickup
    • On Call Air
    • Letter Center
    • Air Service Center
  • Customer Classification: If you are shipping from the United States, you can use the Customer Classification Code of UPS to retrieve rates. The available options in the drop-down are as follows:
    • Rates Associated with Shipper Number
    • Daily Rates
    • Retail Rates
    • Standard List Rates

Note: You need to confirm your specific customer classification code with your UPS Account representative to set corresponding rates under this section.

  • Tax On Rates: Check this field to apply taxes on shipping rates.
  • Enable Pickup: You can check this field to set up a pickup request with UPS.
  • Commercial Invoice: You can create a Commercial Invoice by checking this field.
    Note: This is applicable only for international shipping.
  • SSL Verify: This will check for an SSL certificate for the API call with UPS. You can choose to enable it by selecting ‘Yes’ or ‘No’ from the drop-down.
    Note: It is recommended to select ‘No’ here for the smooth return of rates from the UPS API.
  • Access Point Locator: UPS Access Points are specific locations UPS offers to deliver or drop-off packages. Your customers can choose according to the closeness of these locations to their home or work. By enabling the checkbox you can display UPS Access Point functionality to your customers.
  • Minimum Order Amount: Using this field, you can set a minimum order amount for your customers to avail UPS shipping method. If the order is below the amount specified here, UPS shipping options will not be visible to your customers.
  • TIN Number: Enter your tax identification number.
  • Ground Freight Shipment: Tick this checkbox to enable Ground Freight Shipment. This type of shipment is available to only specific UPS accounts, that are qualified to receive Freight Shipment service.
    Once you enable this option, the Ground Shipment option will be available in WooCommerce Edit Order page.
  • Send Email Notification To: You can enter an email address for which email notifications have to be sent.
  • Enable Latin Encoding: You can tick this checkbox to enable Latin encoding instead of default encoding (UTF-8). This will support special characters which are not supported by UTF-8 encoding.

Label Generation (Advance Setting)

With these settings, you can automate the generation of packages and shipping labels once an order is received. These settings are as described below:

Automation settings

  • Generate Packages Automatically After Order Received: You can check this option to automate package generation when an order is received and the payment is successful.
  • Generate Shipping Labels Automatically After Order Received: Check this option to automate label generation when an order is received and the payment is successful.
  • Send label in the email to customer after label generation: This will email a copy of shipping label to your customers once it is generated.
  • Allow customer to print the label from his myaccount->order page: This option allows your customers to print the shipping labels from the order page of their user account.
  • Content of Email With Label: Allows you to describe the content of the email that includes shipping label.

Click Save Changes to set/update configuration settings.

Cart

After setting up the UPS Configuration Settings, your customers can see all available UPS services list on the Cart page which is shown in the below screenshot. The customer can select the required option and proceed to checkout. If you choose to show only the cheapest rate in the UPS Configuration settings, then the services list is not displayed. Only the cheapest service is used for shipping.

UPS rates on cart page

UPS Print Label

You can print the label in PNG or GIF format based on the UPS Configuration settings.

Creating a Shipment Label

  • Navigate to Dashboard > WooCommerce > Orders.
  • On the order page, click #OrderNumber for which you want to create and print the label.
  • Click on Generate Packages. It will generate a package based on the Parcel Packing Method that you have set up in the plugin settings.
UPS options on the orders page
UPS options on the orders page
  • Once the package is successfully created, the following options will be available to you.

Options on the orders page

  • Add Package: This allows you to manually add packages to your the order.
  • Calculate Shipping Cost: It allows you to calculate real-time shipping rates on the order page in order to compare different shipping rates and assign shipping services to the packages. This way you can compare shipping rates and generate shipping labels of any available shipping service for the destination address.
  • Collect On Delivery: This allows you to enable UPS Collect On Delivery option for the current order.
  • Include Return Label: This allows you to print a Return Shipment Label for the current order.
  • Saturday Delivery: This option allows you to make the order eligible for the Saturday Delivery.
  • Confirm Shipment: Once you are done with the packages, click on Confirm Shipment in order to generate UPS shipping label for the current order.

After clicking the Confirm Shipment button, shipment tracking ID automatically gets generated in the tracking box. Print Label and Return label buttons become available for printing.

Print Label

After clicking on Confirm Shipment, the following screen appears:

UPS Label created

  • Package Details: The plugin allows you to know exactly how the products are packed inside the package by displaying the package details with the name and the quantity of the products inside each package.
  • Print Label: Click Print Label to print the label for the order.
  • Generate Return Label: Click Generate Return Label to generate and print the label with destination address as the address of the shop owner and origin address as the address of the customer.
  • Commercial Invoice:  If enabled in the plugin settings, the plugin lets you generate a Commercial Invoice for all your international shipments.
  • Void Shipment: In case the order gets canceled, you can click on the Void Shipment option.

UPS Shipment Labels

All created shipment labels get stored in your host site database. All these labels are auto downloaded in a file and can be printed multiple times. If you are using Test API mode, you will get the Sample Domestic Shipment Label is as shown below. For the real label printing, select the Live API mode in the plugin Admin Settings.

UPS Shipping label3

The sample UPS Shipment Return Label is as shown below:

Return Label

With the UPS plugin, you can also print labels (shop owner to the customer and vice-versa) for international shipping. The sample of an international label is as shown below:

International UPS shipping label

UPS Shipment Tracking

To get the shipment tracking information, the customer can go to My Account. Under Order, click required  #OrderNumber, and the tracking information will appear as shown below:

UPS-tracking

However, as soon as the order is completed, the plugin also sends the tracking details to the customers via the Order Completion Email, as shown below.

 

Click Shipment ID (highlighted) to see the status of the package.

Check out our WooCommerce UPS Shipping with Print Label Plugin to make a purchase or know more about the features of the plugin.

Last Updated On November 15, 2018

12 thoughts on “Setting Up WooCommerce UPS Shipping Plugin

  1. Carol says:

    Sirs,

    I actually have several issues that are either not working or not showing as options as indicated by your tutorial:

    1) i can’t find the option to set the box sizes/weights manually
    2) i can’t see a way to remove a box that the plug in is generating
    3) i can’t seem to override weight (we set the weight over for the customer’s displayed rate, we want to enter the actual weight for generating the label)
    4) can’t find anywhere to require an adult receiving signature (required for our larger ticket items)
    5) tutorial says we can generate a pdf label,but that does not seem to be an option in the label type drop down list (I only get: gif, png, zpl and epl)

    Please help!

    thank you!
    c

    • Anindo
      Anindo says:

      Hi Carol,

      First, we need to know the plugin version you’re on. Our latest version of the plugin is 3.8.8, Please note the features you mentioned is available only in the premium version of the plugin.
      In the UPS plugin settings:
      1. Parcel packing option drop down the box packing: based on weight and dimension, should be available.
      2.When package is generating packages, if you add another package you’ll be able to remove the added package, but the default package you’ll not be able to remove.
      3. Weight should be editable, Please raise a ticket in xadapter support, if its not allowing you to in the premium version.
      4.We don’t have the singature option in UPS plugin.
      5. The pdf option is not available for the labels with our plugin. There must be some mistake in the documentation.

      Regards,
      Lorenzo
      Team xadapter

    • Carol says:

      HI Lorenzo,

      That’s very disappointing ( and somewhat misleading about the PDF!) now that i’ve purchased this, I cannot use it at all. I don’t know how to tell which version i have I paid $69 – not having a signature option is very unexpected and a complete non-starter for us, had i know i would not have purchased this – one would think that a UPS shipping module would have something as basic as that….can i get my money back?

  2. webmaster1
    CJ says:

    Why is this plugin pulling a ground rate when shipping to Alaska and Hawaii? I can’t figure out how to turn that off. Besides that is has the two air options which is correct.

    • Anindo
      Anindo says:

      Hi CJ,

      You can disable UPS ground in the plugin settings under services and packaging.

      Regards,
      Lorenzo
      Team xadapter

  3. Marta
    Marta says:

    Hi,
    how to add 2 different rates for one service. I need 2 options in Standard UPS Service:

    1. FREE shipping for domestic clients.
    2. 85% Discount for Europe.

  4. dohnalf says:

    Hi,
    Does this plugin work with UPS API in Czech Republic that required CZK and kg for real-time to sell in USD (pounds/in)?
    How to woocommerce plugin setups it to do?

    • Anindo
      Anindo says:

      Hi Kofi,

      Yes, our plugin works in UK with GBP currency support.

      Hope this helps!
      Let us know if you have any query.

Comments are closed.