Knowledge Base


  • Video block
  • Video Tutorials

  • Watch our easy-to-follow video tutorials for quick tips on designing and managing your store.
  • View Video Tutorials

Setting Up UPS

System > Configuration > Sales > Shipping Methods > UPS

United Parcel Service offers domestic and international shipping services by land and air to more than 220 countries. This article provides step-by-step instructions for setting up the UPS shipping method for your Magento Go store.

For field descriptions, see: Configuration: Shipping Methods - UPS

Step 1: Open a Shipping Account

To offer this shipping method to your customers, you must first open an account with UPS.

Step 2: Configure Your Store

  1. From the Admin panel, select System > Configuration.
  2. In the Configuration panel on the left, under Sales, click Shipping Methods.
  3. Click to expand the UPS section. Set Enabled to “Yes.”
  4. Set UPS Type to one of the following:
    • United Parcel Service
      In the Gateway URL field, enter the URL that is used to calculate UPS shipping rates. This field is preset by default, and normally does not need to be changed.
    • United Parcel Service XML

      Note: To generate shipping labels, UPS Type must be set to “United Parcel XML.”

      1. For United Parcel Service XML, enter the following UPS credentials:
        • Password
        • Access License Number
        • User ID
      2. Set Mode to “Live” to send data to the UPS shipping system over a secure connection. (Development mode does not send data over a secure connection.)
      3. Set Gateway XML URL to the URL that is used to connect with UPS while sending requests by XML file.
      4. Set Order of Shipment to the region where the shipment originates.
      5. If you have special rates with UPS, set Enable Negotiated Rates to “Yes.”
      6. If you have negotiated rates with UPS, type the six-digit Shipper Number assigned to you by UPS.
  5. Complete the remaining fields as follows:
    1. In the Title field, type the name of this shipping option as it will appear in checkout. By default, this field is set to “United Parcel Service.”
    2. In the Container field, specify the typical packaging type that is used for shipment.
    3. Set Destination Type to one of the following:
      ResidentialMost shipments are business to consumer (B2C).
      CommercialMost shipments are business to business (B2B).
      Define AutomaticallyUPS determines the destination type as either residential or commercial, and uses the appropriate rate from the merchant’s UPS account during checkout.
    4. Set Weight Unit to the system you use to measure product weight. The weight system supported by UPS varies by country. If in doubt, ask UPS which weight system you should use. Options include:
      • LBS
      • KGS
    5. Set Pickup Method to one of the following:
      • Regular Daily Pickup
      • On Call Air
      • One Time Pickup
      • Letter Center
      • Customer Counter
    6. Set Minimum Package Weight and Maximum Package Weight and to the amounts supported by UPS.
      The weight is based on the standard unit of measurement used by shipping carriers in your locale. In the United States, the weight is represented in ounces and pounds.
    7. Set Calculate Handling Fee to one of the following:
      FixedCalculates shipping based on a fixed rate.
      PercentCalculates shipping based on a percentage of the order amount.
    8. Set Handling Applied to one of the following:
      • Per Order
      • Per Package
    9. In the Allowed Methods list, select each UPS method offered to your customers. The methods appear under UPS during checkout. (Hold the Ctrl key down to select multiple options).
    10. Set Free Method to the UPS service you want to use for offers of free shipping.  Then, set the Free Shipping with Minimum Order Amount to one of the following:
      EnableOffers free shipping based on a minimum order. When prompted, enter the Minimum Order Amount for Free Shipping.
      DisableDoes not offer a free shipping based on a minimum order.
    11. In the Displayed Error Message box, type the message customers see if UPS shipping becomes unavailable.
    12. Set Ship to Applicable Countries to one of the following:
      • All Allowed Countries
      • Specific Countries
        If applicable, set Ship to Specific Countries to each country where your customers are allowed to ship by UPS. (Hold the Ctrl key down to select multiple options.)
    13. To create a log file with the details of UPS shipments made from your store, set Debug to “Yes.”
    14. Set Show Method if Not Applicable to one of the following:
      YesLists all UPS shipping methods to customers, regardless of their availability.
      NoLists only the methods which are available to customers.
    15. In the Sort Order field, type a numeric value to determine the order in which UPS appears when listed with other shipping methods during checkout. The number with the highest priority is 0, which puts it at the top of the list.
  6. When the configuration is complete, click the Save Config button to save your settings.