OdooWiki OCA HUB

Delivery UPS OCA

delivery_ups_oca folder_open OCA/delivery-carrier open_in_new
Delivery License: AGPL-3

This module adds UPS to the available carriers.

It allows you to register shippings, generate labels, get rates from order, read shipping states and cancel shipments using UPS webservice, so no need of exchanging any kind of file.

When a sales order is created in Odoo and the UPS carrier is assigned, the shipping price that will be obtained will be the price that the UPS webservice estimates according to the order information (address and products).

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds UPS as a shipping carrier in Odoo so you can get live shipping rates, create UPS labels, track deliveries and cancel shipments directly from sales orders and delivery orders.

This module connects Odoo to the UPS web service. On a delivery method (carrier) you can choose UPS as the delivery type and fill in a dedicated UPS tab with your UPS credentials (client ID and secret), shipper number, service code, default packaging type, dimension and weight units, label file format, address validation level and optional negotiated rates or cash on delivery settings. A button lets you refresh the UPS access token.

When a sales order uses a UPS carrier, the shipping price is requested from UPS based on the delivery address and the products, and that price is used on the order. When you validate a delivery order, Odoo sends the shipment to UPS, stores the UPS tracking number on the transfer and attaches the shipping label as a file. A UPS Label button appears on completed transfers to download the label again.

If tracking synchronisation is enabled, Odoo can update the delivery status of the transfer from UPS, keep a history of tracking events and store proof of delivery. You can also cancel a UPS shipment from Odoo, which clears the tracking history. The module adds UPS packaging types (letter, tube, PAK, express boxes, pallet, etc.) and marks them as UPS packaging, and it decides whether an address is treated as residential for UPS.

Depends on

stock_deliverydelivery_package_numberdelivery_price_methoddelivery_state
Models and fields (3)
  • stock.picking · extends an existing model
  • delivery.carrier · extends an existing modelups_token, delivery_type, ups_client_id, ups_file_format (File format), ups_service_code (Service code), ups_client_secret, ups_cod_funds_code (UPS Cod Funds Code), ups_shipper_number (Shipper number), ups_cash_on_delivery (UPS Cash On Delivery), ups_negotiated_rates (Negotiated Rates), ups_address_validation (UPS Address Validation), ups_package_weight_code (Package Weight code), ups_default_packaging_id (Default Carrier Packaging Type), ups_token_expiration_date, ups_package_dimension_code (Package Dimension code), ups_use_packages_from_picking (Use packages from picking), ups_tracking_state_update_sync (Tracking state update sync)
  • stock.package.type · extends an existing modelpackage_carrier_type

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 13.0

Confirmed on 2026-11-03 in branch 13.0 of OCA/delivery-carrier.

terminal Installation and usage

OCA documentation · Odoo 18.0

Configuration

Source · Odoo 18.0

To configure this module, you need to:

  • Add a Shipping Method with Provider UPS and fill in your UPS credentials (Client ID and Client Secret)
  • Configure in Odoo all required fields of the UPS tab with your account data (Shipper number, Default Packaging, Package Dimension Code, Package Weight Code and File Format).
  • If yo have "Tracking state update sync" checked all delivery orders state check will be done querying UPS services.
  • It is possible to create a UPS carrier for cash on delivery parcels. Select the ups delivery type and check the "Cash on Delivery" checkbox under the "UPS" tab. It is required to select the "UPS COD Funds Code" when the "Cash on Delivery" option is selected.
  • The "Negotiated Rates" checkbox is disabled by default. When checked and your account has negotiated rates, UPS will use your account's negotiated rates for shipping cost calculations.

NOTE You need to add an APP from for using the webservice.

Usage

Source · Odoo 18.0

You have to set the created shipping method in the delivery order to ship:

  • When the picking is 'Transferred', a Create Shipping Label button appears. Just click on it, and if all went well, the label will be 'attached'.
  • If the shipment creation process fails, a validation error will appear displaying UPS error.
  • When the delivery order is cancelled, it's automatically cancelled too in UPS.
  • If you have "Tracking state update sync" checked in the shipping method, a periodical state check will be done querying UPS services.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.