Powered by Adobe Commerce 2.4.9

ups-rest.png

UPS Shipping Extension, Live Rates, Labels & Tracking

First year:
0
TOTAL DUE TODAY:

Trader Information

Back to top

Overview

Back to top

The Magento 2 UPS REST API Shipping Extension for Adobe Commerce connects your Magento store with official UPS REST APIs for live shipping rates, negotiated account rates, advanced packaging & box management, shipping labels, tracking, and shipment management.

UPS shipping rates are calculated using the warehouse origin, customer destination, package weight, product dimensions, packaging configuration, Residential or Commercial status, and enabled UPS services. Available rates can be displayed during checkout and Magento Admin order creation.

Configure your warehouse origin under Admin → Stores → Configuration → Sales → Shipping Settings.

UPS REST API & OAuth 2.0: The extension supports UPS REST API authentication using a Client ID and Client Secret. Create an application through the UPS Developer Portal and enter the generated credentials in Magento Admin.

Why Choose the EcomPlugins UPS Shipping Extension?

Magento and Adobe Commerce provide standard UPS functionality in supported configurations, but many merchants require additional control over custom box management, auto box packaging (3D bin packing), product dimensions, multi-package calculations, residential shipping, negotiated rates, shipping markups, labels, tracking, and checkout behavior.

The EcomPlugins UPS extension adds advanced product-level and store-level controls designed for more complex shipping and warehouse requirements.

Magento 2 UPS Shipping Extension Features

  • Connect Magento 2 and Adobe Commerce with UPS REST APIs.
  • Use OAuth 2.0 Client ID and Client Secret authentication.
  • Display live UPS rates during checkout.
  • Retrieve UPS rates during Magento Admin order creation.
  • Use negotiated UPS account rates when available.
  • Automatically detect Residential or Commercial destinations through UPS APIs when enabled.
  • Admin Box Management: Define standard shipping cartons with inner dimensions, outer dimensions, tare box weight, and max weight capacity.
  • Intelligent Auto Box Packaging: Automatically assign cart items to standard boxes using 3D bin packing with item rotation.
  • Support multiple packaging modes: Box Management (3D dimensional fit), Package Based (case pack & loose items), and Based on Weight.
  • Configurable packing strategies: Best Fit Box, Balanced Split, and Greedy Packing.
  • Set maximum allowed boxes per order to safeguard checkout performance against massive carts.
  • Optionally merge small packages under a weight threshold into a single box to prevent excessive shipping costs.
  • Configure minimum and maximum order weight rules.
  • Configure maximum package weight (e.g. 150 lbs).
  • Add product-level length, width, and height.
  • Configure product-level box or pack quantity.
  • Ship selected products separately in their own individual boxes.
  • Handle oversized and over-dimensional packages.
  • Add fixed or percentage shipping-rate markups.
  • Offer free shipping based on subtotal, cart rules, or product configuration.
  • Show or hide estimated delivery information.
  • Enable UPS rates for Admin while optionally disabling storefront rates.
  • Create UPS shipping labels from Magento Admin.
  • Create and associate UPS tracking numbers with Magento shipments.
  • Cache qualifying UPS API requests and OAuth tokens.
  • Enable detailed API logging for troubleshooting.
  • Configure custom customer-facing error messages.

Advanced Packaging & Multi-Box Shipping

Accurate packaging is critical for retrieving precise UPS dimensional (DIM) weight rates. The extension provides full store-level box management and intelligent automated packaging algorithms to handle complex order combinations efficiently:

  • Box Management in Admin Settings: Predefine your store's standard shipping box inventory. Specify Inner Dimensions (internal usable space checked against product dimensions), Outer Dimensions (physical exterior sent to UPS for dimensional weight rating), Box Tare Weight (empty carton weight added to total weight), and Max Weight Capacity.
  • Auto Box Packaging & 3D Bin Packing: Automatically calculates item volume and 3D dimensions (including item rotation) to place items into the smallest and most cost-effective box available.
  • Flexible Packaging Modes:
    • Box Management: Full 3D bin packing matching item dimensions against configured box inner dimensions.
    • Package Based: Automatically separates full master case packs (by product pack quantity) and pools remaining loose items into available boxes.
    • Based on Weight: Divides shipments cleanly based on a maximum package weight threshold.
  • Configurable Packing Strategies: Choose between Best Fit Box (selects the smallest possible box that fits the items), Balanced Split (evenly distributes weight across packages), or Greedy Packing (fills each carton to capacity before starting a new one).
  • Merge Small Packages: Automatically merge loose small parcels (e.g., 0 to 50 lbs) into a single carton if the combined weight is within your threshold, avoiding unnecessary multi-box surcharges.
  • Max Boxes Protection: Cap the maximum number of packages per order to prevent excessive API requests on oversized carts.
  • Product-Level Overrides: Configure custom product-level dimensions (L × W × H), assign units-per-box pack sizes, or mark specific items to always ship separately in their original containers.

User Guide: FedEx and UPS Packaging Logic with REST API Plugin Flow

Residential & Commercial Address Detection

UPS rates can vary depending on whether a destination is Residential or Commercial. The extension can use UPS Address APIs to determine the address type before requesting shipping rates.

If UPS does not return an address classification, the extension can use the default address type configured in Magento Admin.

For additional address functionality, see the Magento 2 UPS Residential and Commercial Address Checker or Magento 2 UPS Checkout Address Validation Extension.

Negotiated UPS Account Rates

Merchants with negotiated UPS pricing can request account-level rates when supported by their UPS account and API response. This allows Magento to display applicable negotiated shipping prices instead of only published rates.

A fixed or percentage markup can also be applied before displaying the final UPS shipping price to the customer.

Shipping Markups & Free Shipping

  • Add a fixed amount to returned UPS rates.
  • Add a percentage markup to shipping rates.
  • Offer free shipping based on order subtotal.
  • Support qualifying Magento cart conditions.
  • Configure product-level free shipping.

UPS Shipping Labels & Tracking

Create eligible UPS shipping labels directly from Magento Admin. Shipment and package information is submitted to UPS and returned tracking information can be associated with the Magento shipment.

  • Create UPS shipments from Magento Admin.
  • Generate UPS shipping labels.
  • Create tracking numbers during shipment processing.
  • Associate tracking details with Magento shipments.
  • Provide applicable tracking information to customers.

API Caching, Logging & Troubleshooting

The extension can cache qualifying rate requests and OAuth access tokens to reduce unnecessary UPS API calls. Detailed logging can also be enabled to troubleshoot authentication, rate, address, and packaging issues.

  • Cache qualifying UPS rate requests.
  • Cache OAuth access tokens.
  • Review UPS request and response information.
  • Diagnose OAuth authentication errors.
  • Troubleshoot missing shipping methods.
  • Review package weights and dimensions submitted to UPS.

Note: Sensitive credentials should be excluded or masked in production logs.

UPS Account & REST API Configuration

A UPS account and valid UPS Developer API credentials are required. Create an application through the UPS Developer Portal and generate your Client ID and Client Secret.

Enter the REST API credentials in Magento Admin, configure your warehouse origin, select the allowed UPS methods, and configure negotiated rates, Residential/Commercial handling, packaging, weight, and checkout settings.

Legacy UPS Username, Password, and Access License Number credentials apply to older integrations and are not used for the current OAuth 2.0 REST API configuration.

Magento 2 & Adobe Commerce Compatibility

The extension is developed for Magento 2 and Adobe Commerce. Compatibility can depend on your Magento version, PHP version, installed security patches, checkout customizations, and other shipping modules.

If your store uses a heavily customized checkout, Hyvä Checkout, headless storefront, marketplace extension, custom warehouse system, or another UPS carrier extension, please contact us before purchasing.

For installation, UPS REST API configuration, packaging, rate troubleshooting, or custom Magento shipping requirements, contact EcomPlugins or email support@ecomplugins.com.

Demo

Technical Specifications

Back to top

Seller profile

EcomPlugins

Seller contact

E-mail

Integrator

UPS

Current Version

3.1.8

Adobe Commerce platform compatibility

Adobe Commerce (cloud): 2.4 (current)

Adobe Commerce (on-prem): 2.4 (current)

Magento Open Source: 2.4 (current)

Type

Stable Build

Updated

29 October, 2026

Categories

Extensions, Shipping & Fulfillment, Order Management (OMS)

Documentation

Installation Guides

User Guides

License Type

GNU Lesser General Public License 3.0 (LGPL-3.0)

Policy

Privacy Policy

Quality Report

Back to top

Installation & Varnish Tests

Passed

Coding Standard

Passed

Plagiarism Check

Passed

Malware Check

Passed

Marketing Review

Passed

Manual Testing

Passed

All tests were conducted on the latest versions of Adobe Commerce that existed for the compatible release lines at the moment of the extension submission. Latest versions of all other software were used, as applicable.

Release Notes

Back to top

3.1.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Customer tracking notification option added.

3.1.6:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Logging improvment and admin download option added.

3.1.5:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Magento 2.4.9 compatiblity fixes.

3.1.2:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Estimate pickup delievery date logic updates.

3.1.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    1. Extra shipping method cost with fixed and percent
    2. Pickup date and estimate date logic improved.
    3. Saturday delivery option added.

3.0.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Magento 2.4.8 fixes.

3.0.7:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    UPS address validation and other updates.

3.0.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    multiple packages logic issue fixed.

2.2.9:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Regular updates and minor fixes.

2.2.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    PO Box address validation and show error based on address and admin settings.

2.2.5:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Weight up to 6 decimal digits allowed.

2.2.4:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Handling fee fixes with multiple packages.

2.2.2:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Shipping label method fixes.

2.2.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Estimate Delivery Date Logic fixes.

2.1.9:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    RMA return label feature added.

2.1.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Logic added for extreme length fixes.

2.1.7:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Multiple store admin setting fixes.

2.1.6:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Tracking API fixes.

2.1.4:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Group product shipping rates fixes
    Free Shipping Rules fixes

2.1.3:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Dimensional logic fixes.

2.1.2:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    International shipment cases fixed

2.1.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Free shipping with catalog price rules logic added.

2.1.0:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Free shipping logic updates at product level.

2.0.9:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Added free shipping logic fixes.
    Handled group product shipping rates.

2.0.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Validation fixes

2.0.7:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Package logic updates.

2.0.6:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Quote Caching fixes

2.0.4:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Additional handling fixes.

2.0.3:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Dimensional shipping settings and other fixes.
    UPS shipping label API changes fixes.

2.0.2:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Dimensional shipping fixes
    If total order weight greater than max package weight then logic to send each own with own package details to get rates.

2.0.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Dimensional shipping changes
    Quote caching added to avoid duplicate requests.
    Package max length handling.
    Estimate shipping date fixes.

2.0.0:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Minimum and Maximum weight logic updates.

1.0.9:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    UPS tracking fixes.

1.0.8:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Address type validation fixes.
    Package type option added.

1.0.7:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Auto address validation fixes with default address type if API failed.
    Shipping Handling fee fixes

1.0.6:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Bugs fixes
    1. Token expiration timeout setting updates
    2. Other validation fixes.

1.0.4:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    UPS multiple rates method name fixes.

1.0.3:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    Auto address validation type bug fixes.

1.0.2:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    UPS tracking and label fixes.

1.0.1:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    UPS multiple rates fixes.

1.0.0:

  • Compatible with Adobe Commerce (cloud) : 2.4
  • Compatible with Adobe Commerce (on-prem) : 2.4
  • Compatible with Magento Open Source : 2.4
  • Stability: Stable Build
  • Description:

    First version 1.0.0

Support

Back to top

The best place to start if you need help with a specific extension is to contact the developer. All Adobe Commerce developers have both a contact email and a support email listed.

Contact Vendor

Q & A

Back to top

Reviews

Back to top