The add-on UPS for X-Cart 5 allows you to use online shipping rate calculation via UPS service.

This article assumes that the UPS add-on has already been installed and activated at your store.

To start using the add-on, you need to configure it. The add-on settings can be accessed using one of the following methods:

Method 1:

  1. In the Shipping section of your X-Cart store’s Admin area (Store setup > Shipping), click the Add shipping method button.

  2. In the popup that appears, choose the UPS shipping method.

Method 2:

  1. In the My Apps section of your X-Cart store’s Admin area, find the UPS add-on and click on its name to access the add-on detailed information.

  2. On the add-on information page, click on the Settings link.

The UPS settings page looks like the following:

To use UPS Rating API you need to register on UPS.com with a User ID and Password. Once you have registered you would need to obtain an Access Key from UPS.com that provides access to the Rating API. To obtain an Access Key an account number needs to be added or created in your UPS.com profile.

So first of all you’ll need to fill in the following fields in accordance with your UPS account data:

  • User ID: Specify your UserID.

  • Password Specify your password.

  • Access key: Specify your UPS Access key. An Access key can be requested after registration. To request an Access key, go to https://www.ups.com/upsdeveloperkit?loc=en_US and click “Request an access key”. On the page that opens, provide your contact and account information and select “Request Access Key” to continue. Once you have your Access key, copy and paste it into this field in X-Cart.

  • UPS Account number: Specify the UPS account nember. A shipper’s UPS account number is required when requesting to receive the negotiated rates.

  • Test mode: Turn the test mode on if you want to check the UPS shipping processing before making it live.


Package Settings

These are the options that will be applied to both domestic and international shipments:

  • Package box type: Select the type of packaging that will be used for shipments.

  • Package dimensions (IN) (Length, Width, Height): Use these fields to define the default package size for UPS shipments in inches.

  • Maximum package weight (lbs): Specify the top limit of package’s weight in lbs.

Service Options

These are advanced options for shipments.

Turn them on or select the necessary values if applicable.

Cash on Delivery

Here you can enable the cash on delivery option for your international and domestic shipments.

To enable the cash on delivery option for shippings you should first activate this option in the payments section (Store setup > Payment methods). Find UPS in the Offline methods section and turn the cash on delivery option on.


Follow the link from the Note to find the payments section


Currency Conversion Options

Use this section to provide a currency conversion rate if your currency is other than the US dollar.

  • Shipping cost currency: If the shipping currency is other than USD, specify it in this field.

  • Currency rate: Set the currency conversion rate here. If your currency is the US dollar, leave this field set to 1.

Additional Options

This is an option that is helpful, but do not affect shipping rates calculation:

This option enables logging of requests to the UPS server and responses from it. The logs are saved to UPS.log files in the <X-Cart>/var/log/ folder.

Be sure to save the changes when the UPS shipping configuration is complete.



Did this answer your question?