AbantecartCart Version(s) 1.2.0 – 1.2.13 use UPS Integration v 1.2.2.8.

UPS Integration: an enhanced UPS extension that supports all rates, including Dimensional Weight, Billable Weight, and Oversize Package Surcharges.

Plus these added features:
1. Additional Weight field to easily add standard packaging weight, rather than having to do it on each item.
2. Additional Fee field to add upcharge - can be fixed dollar amount or percentage of shipping rate.
3. If enabling Ship Product Individually but without having fixed price rates are calculated separately for that item based on weight or dimensions. If item is ordered with other items is it correctly added to total shipping fees, but not included in calculation of other items.
4. Works well with the default free shipping, default per item shipping, default flat rate shipping.
5. Uses UPS address verification system to determine residential or commercial rate lookup on the checkout out page.
6. Allows the use of declared value of a shipment, including ability to set a Declared Nominal Value.
7. Ability to select Zip/Postal code(s) to offer local delivery service only. Local delivery service may be offered as free service or with a flat charge. Admin can show additional message in the checkout cart page to inform the customers about the local delivery service. Admin may choose to show just the local delivery service or all the shipping services offered for the selected Zip/Postal code(s).

For more info about UPS Rates and other info, you can download UPS daily rates pdf file here
Important Note:
  • Weight and length class must be set correctly within the System > Settings > Details page.
  • In Metric locations use: Kilogram in Weight Class fields and Centimeter in Length Class.
  • In US or other non-metric locations use: Pound in Weight Class and Inch in Length Class.
  • Using AbanteCart prior to v1.2.2: If you Edit Order Details as Admin within Sales > Orders the ReCalculation of a changed order is not supported. You need to change the shipping rate manually. If using AbanteCart v1.2.2 or later, it will update upon ReCalculation.
  • Check Changelog for upgrading notes.
  • Setup
    1. Test Mode: Use this module in Test (YES) or Production mode (NO).

    2. Access Key: Enter the XML rates access key assigned to you by UPS.
        Follow the steps here to obtain UPS developer username, password and access key.

    3. Username: Insert your UPS Username here.

    4. Password: Insert your UPS Password here.

    5. Account Number: Insert your UPS Account Number here. This is mandatory if you are using negotiated rates.

    6. Pickup Method: Select your pickup method.

        How do you give packages to UPS (only used when origin is US)

    7. Packaging Type: Select your packaging type.

    8. Customer Classification Code:

        00 - If you have negotiated/incentivised shipping rates.
        01 - If you are an existing customer account prior to January 3, 2011 that provides for Daily Rates, or UPS Scheduled Pickup service implemented prior to January 3, 2011.
        04 - If you do not receive UPS Scheduled Pickup service; ship from a UPS retail location, such as The UPS Store® or UPS Customer Center; or ship infrequently with a UPS account number or payment card.
        53 - If you have a customised agreement with UPS that provides for Standard List Rates, or a UPS Scheduled Pickup account established on or after January 3, 2011.

    9. Use Residential Rate As Default: Turn On if you want to use Residential Rate as the default instead of Commercial Rate on the view cart page.
        The checkout page will validate the address whether it's residential or commercial

    10. Negotiated Rates: Turn On if you have the negotiated rates enabled on your UPS Account.
          Negotiated rates will be used - your shipper account must have negotiated rates activated AND you must use 00 in the Customer Classification code field.

    11. Shipping Origin Code: What origin point should be used (this setting affects only what UPS product names are shown to the user)

    12. Origin City: Enter the name of the origin city.
          e.g. Montevallo.

    13. Origin Zip/Postal Code: Enter your origin zip/postal code.

    14. Origin State: Enter your (two/three letters) State code .

    15. Origin Country: Enter your (two letters) Country code . For reference click here.

    16. Test Your Connection: You can test if API credentials that you've entered are correct after you saved the credentials.

    17. Services: Select the UPS Services to be offered (The list of services are different based on your origination).

    Notes for number 18-21: If you are offering Local Delivery Services AND using more than one shipper you must enable Local Delivery Services on only ONE shipper. e.g. you offer FedEx, UPS and USPS, and also Local Delivery – you must enable Local Delivery on only ONE shipper: FedEx, UPS or USPS.

    18. Enter Zip/Postal Code(s) eligible to use Local Delivery Service: Use commas(,) without space as the multi Zip/Postal code(s) separator, and no spaces within the Zip/Postal code(s). To define areas use asterisk (*) replacement - eg 351*,350*.

    19. Local delivery fee: Enter the local delivery fee if you want to charge customer or leave blank if it is a free delivery.

    20. Turn ON to show ONLY Local Delivery Services: Turn OFF if you want to show all shipping options including Local Delivery services.

    21. Insert your desired text to be shown on cart page to let customers know about local delivery schedule or services: Insert your desired message.

    Notes for number 22: If you are using more than ONE shipper and are offering any Free Shipping service, you must choose only ONE shipper for the Free Shipping. e.g. if using UPS , USPS and FedEx, Free Shipping can only be offered from one.

    22. If using a Free Shipping option within your cart select which service you are using for the Free United States Shipping (If your location is in USA): Select the UPS Services to be offered for free shipping.

    23. Display Weight: Do you want to display the shipping weight? (e.g. (Weight : 0.17lb) )
    Notes for number 24-26: We set a Default of 5 x 5 x 5 which works for most businesses. You can input your normal size if different.
    Also, input on a product page will be used for that individual product rate look up. (You need to input individual product size and turn on the Ship Product Individually flag on product page.)


    24. Dimensions Length (Optional): Insert your Box Length here.

    25. Dimensions Width (Optional): Insert your Box Width here.

    26. Dimensions Height (Optional): Insert your Box Height here.

    27. Max Box Weight (Optional): Specifies the maximum box size (just the number). Once the maximum weight is met, the system will calculate shipping for 2(or more) boxes.

    28. Tax Class: Choose your Tax Class. The tax is shown in a separate line on invoice.

    29. Location: Choose your Zone.

    30. Additional Fee Type: Choose the type that you want to use for the additional Fee. Fixed amount or Rate Percentage based.

    31. Additional Fee: Insert your desired Additional Fee value that you want to charge to your customer.

          e.g. The rate is $5.00, your fixed additional fee is $3.00, the rate shown to customer is $8. Or if you're using the percentage instead of fixed rate, and it is 10% from the rate, the rate will be $5.5. To use either fixed or percentage based additional fee, just enter the digits without the % or currency symbol.

    32. Additional Weight: Insert your desired additional weight that you want to charge to your customer.

          e.g. The weight is 0.26 lb and your additional weight is 0.50 lb, the weight rate will be 0.76 lb. And if showing shipping wt. in cart 0.26 lb is shown to customer.

    33. Declared Value: Do you want to Declare Package Value? Yes(On) or No(Off)

          The declared value of a package represents UPS's maximum liability for the package in the case of loss or damage.

          For more information, visit UPS Declared Value Q&A.

    34. Declared Value Nominal: Enter the minimum nominal that will be used to enable the Declared Value. (If you leave it blank, it will use USD $100 by default)

    35. Estimate Message: Insert your desired text to be shown to customers to inform them that rate on cart page was using residential address based rate and not actual, the actual rate will be shown on checkout page based on their address.

       Finally Click the Save button and Turn On the extension.

    FAQ

    • Getting different rates between ups site and your site

      The rates on UPS is a retail price, you need to set the customer classification code to 04 in order to get the retail rates.
    • Get 10002: The XML document is well formed but the document is not valid

      Make sure you have setup the correct package type.

    v1.2.2.8

    2019 - 01 - 03

    bug-fix Fix "ac_language_definitions doesn't" exist during upgrade issue.

    v1.2.2.7

    2018 - 11 - 07

    bug-fix Notes: This is only available in AbanteCart v 1.2.2+
    Fix shipping cost not being calculated correctly if admin add products to existing order via the admin sale order page.

    v1.2.2.6

    2018 - 09 - 10

    bug-fix Fix incorrect declared value information URL in quick note.

    changes Change update.sql to update.php in order to avoid upgrade issue.

    v1.2.2.5

    2018 - 08 - 20

    Support Php v5.3-7.2.
    Support AbanteCart v 1.2.13.

    v1.2.2.4

    2018 - 01 - 15

    bug-fix 1. Fix unchecked Mexico UPS Standard service in admin settings if it's turned ON.
    2. Fix switched length and width in product individual shipping dimension.

    v1.2.2.3

    2017 - 12 - 22

    bug-fix Remove unnecessary quick checkout template files.

    Support AbanteCart v 1.2.12

    v1.2.2.2

    2017 - 12 - 04

    bug-fix 1. Fix PHP7 A non-numeric value encountered warning message.
    2. Fix wrong sort order.
    3. Fix missing other shippers multiple local delivery(USPS integration and FedEx integration) on checkout/cart if used together.
    4. Remove UPS services if USPS integration, FedEx integration and show only local delivery option are turned ON.

    feature Separate Local Delivery into a new block for selection.

    Support AbanteCart v 1.2.11

    v1.2.2.1

    2017 - 07 - 28

    changes The origin Zip/Postal Code is no more a mandatory.

    feature 1. Exclude certain Zip/Postal code(s) for using USPS service and use local delivery service.
    2. Admin may choose if want to show just the local delivery service or all of the shipping services for the excluded Zip/Postal code(s).
    3. Admin may charge a fee for the local delivery service or set it as free service.
    4. Admin can show additional message in the checkout cart page to inform the customers about the local delivery service.
    5. Admins able to use both complete and partial Postal/Zip Code(s) by adding an asterisk(*) behind the code or one of them. It is useful if admins want to define an area instead of fill in the codes one by one. e.g. 351*,35005.

    v1.2.2

    2017 - 03 - 16

    changes No more overrides cart.tpl.

    v1.2.1.9

    2017 - 03 - 09

    bug-fix Fix Negotiated Rates for non US based countries issues.

    v1.2.1.8

    2017 - 02 - 18

    Upgrade Notes:
    You can directly install without the need to uninstall and delete. You don't need to resave the settings anymore.

    bug-fix
    1. Separate Poland origin.
    2. Add UPS Standard to Mexico Origin.
    3. Fix wrong origin country code for non US countries.
    4. Fix wrong UPS services name for non US countries.
    5. Fix test your connection issue.

    v1.2.1.7

    2017 - 02 - 08

    Upgrade Notes:
    You can directly install without the need to uninstall and delete. You don't need to resave the settings anymore.

    bug-fix Decode html tag in Estimate Message.

    v1.2.1.6

    2017 - 02 - 07

    bug-fix Fixed the wrong individual shipping with insured value multiplication.

    v1.2.1.5

    2016 - 12 - 27

    feature When using Canada Post and UPS, both blue blocks will show.
    Support AbanteCart v1.2.9

    v1.2.1.4

    2016 - 08 - 16

    Upgrade Notes:
    1. You can directly install without the need to uninstall and delete.
    2. You need to redo the settings.
    3. Please save the changes by click on the save button and not the quick save button.

    bug-fix Fixed the upgrade error.

    bug-fix Fixed wrong Negotiated Rates.


    Support AbanteCart v 1.2.8

    v1.2.1.3

    2016 - 03 - 16

    feature Implement the test connection and credential in admin additional setting page.

    v1.2.1.2

    2015 - 10 - 08

    bug-fix Fixed the currency change issue.

    v1.2.1.1

    2015 - 09 - 28

    feature Implemented the Negotiated Rates service

    feature Implemented the max box weight. Once the maximum weight is met, the system will calculate shipping for 2(or more) boxes.

    feature Implemented Use Residential Rate As Default. Admin may choose want to use Residential Rate as the default or Commercial Rate on the view cart page.

    improvement Now admin may select whether want to use fixed based or percentage based fee.

    v1.2.1

    2015 - 09 - 08

    Initial Release.