OdooWiki OCA HUB

Delivery Package Fees

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

Add delivery fees on Sales Orders based on the delivered packages.

A list of Package Fees can be configured on delivery methods. When a outgoing transfer is done, for each package fee configured on the delivery method, a new sales order line is created with:

  • The product selected on the Package Fee
  • The product name with the number of the transfer in the line's description (e.g. "Service Fee (WH/OUT/00036)")
  • The quantity equal to the number of packages in the transfer
  • The unit price equal to the price set on the product's pricelist (so it can be different per customer and even have different pricing depending on the number of packages)
  • The taxes configured on the product, fiscal position applies if any.

Package Fee lines are added only if their quantity and price is above zero.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds package-based delivery fees to sales orders. Configure fee products on a delivery method; when an outgoing transfer is validated, a sales order line is created for each package delivered.

This module lets you charge customers extra fees based on the number of packages shipped. On each delivery method (carrier) you get a new "Package Fees" tab where you list fee products, optionally restricted to a specific package type, and can enable or disable each fee.

When an outgoing transfer linked to a sales order is validated, the system counts the packages actually delivered and, for every active package fee on the carrier, adds a new line to the sales order. The line uses the fee product, a description that includes the transfer reference (for example "Service Fee (WH/OUT/00036)"), a quantity equal to the number of packages, and a unit price taken from the customer's pricelist, so pricing can vary per customer and by quantity. Taxes from the product are applied, and the customer's fiscal position is taken into account.

  • Fee lines are only created when both quantity and price are above zero.
  • If a fee is tied to a package type, only packages of that type are counted.
  • Fee lines are marked so they are treated like delivery charges and are not copied when duplicating a sales order.

It touches delivery.carrier, sale.order, sale.order.line, stock.picking and the new delivery.package.fee model. Only sales managers and stock managers can create or edit the fee configuration; other users have read-only access.

Depends on

stock_delivery
Models and fields (4)
  • sale.order · extends an existing model
  • sale.order.line · extends an existing modelpackage_fee_id
  • delivery.carrier · extends an existing modelpackage_fee_ids
  • delivery.package.fee · new modelactive, carrier_id, product_id, package_type_id

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 16.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

In "Inventory \> Configuration \> Delivery \> Delivery Methods", a new tab allow to select the package fees. For each product added, a new fee line will be added in the sales order.

No verified information in OCA: Installation, Usage.

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.