magento ups shipping api

magento ups shipping api

September 22, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magento ups shipping api

Calculating Shipping Rates Using UPS API in Magento

Shipping calculation is a critical aspect of e-commerce platforms like Magento. One popular carrier for shipping calculations is United Parcel Service (UPS). In this post, we will guide you through the process of implementing UPS shipping rate calculation using their Rating API in your Magento store.

Understanding the UPS Rating API

Before diving into the implementation, let’s briefly understand what the UPS Rating API offers. The API allows you to calculate shipping rates based on various factors such as package dimensions, weight, destination ZIP code, and service type. You can find the detailed documentation and download the necessary files from UPS Developer Resource Center.

Prerequisites

To proceed with the integration, you need to have an active UPS account and access to their Rating API. You will also require a basic understanding of Magento’s core architecture and experience in PHP development.

Step-by-Step Implementation

1. Obtain Access Credentials

The first step is to obtain your UPS credentials, which include the Access License Number and User ID. You can generate these from your UPS account settings.

2. Create a Custom Shipping Model

In Magento, shipping methods are handled by models that extend Mage_Shipping_Model_Rate_Request. To integrate UPS, we will create a custom model:

class Mage_Ups_Model_Rate_Request extends Mage_Core_Model_Abstract
{
    // Placeholder for the actual implementation
}

3. Implement the Shipping Rate Calculation

The core of the integration lies in the getRates method within your custom request model. This is where you make the SOAP call to the UPS Rating API and process the response.

public function getRates($request)
{
    // Sample implementation using the UPS PHP library (ups-php-sdk)

    $accessLicenseNumber = 'YOUR_ACCESS_LICENSE_NUMBER';
    $userId = 'YOUR_USER_ID';

    $ups = new Ups\PhpSdk\UpsClient();
    $ups->setAccessLicenseNumber($accessLicenseNumber);
    $ups->setUserId($userId);

    // Set the package details and shipping options
    $packageDetails = [
        'weight' => 10,
        'dimensions' => [
            'length' => 12,
            'width' => 8,
            'height' => 6,
        ],
    ];

    $shippingOptions = [
        'serviceType' => 'UPS_NEXT_DAY_AIR',
        'destinationPostalCode' => '10001',
    ];

    // Make the SOAP call to get shipping rates
    try {
        $response = $ups->rate->getRates($packageDetails, $shippingOptions);
    } catch (Exception $e) {
        // Handle exceptions and errors
    }

    // Process the response data
    $rates = [];
    foreach ($response['Rate'] as $rate) {
        $method = [
            'carrier_code' => Mage::getSingleton('ups/transport')->getCode(),
            'method' => $rate['ServiceDescription'],
            'price' => $rate['TotalCharges']['MonetaryValue'],
        ];
        $rates[] = $method;
    }

    return $rates;
}

4. Configure the Shipping Method

After implementing the rate calculation, you need to configure your UPS shipping method in Magento.

  • Go to System > Configuration > Sales > Shipping Methods.
  • Click on Add New Carrier > UPS.
  • Enter your Access License Number and User ID.
  • Set the Title for the shipping method (e.g., “UPS Next Day Air”).
  • Save the configuration.

Conclusion

Integrating the UPS Rating API into Magento allows you to provide real-time, accurate shipping rate calculations to your customers. By following this guide, you can enhance your store’s checkout experience and improve the overall customer journey.

Remember that proper error handling is crucial for a seamless integration. Always ensure that your custom shipping model gracefully handles any exceptions or response errors from the UPS API.

If you’re looking for more advanced Magento development insights and best practices, feel free to explore our Magento Development Services at LaravelCompany.com. Our team of experienced developers can assist you with complex integrations and customizations to meet your specific business needs.

API Configuration Customers

Our network