OdooWiki OCA HUB

Rma Sale Stock Restocking Fee Invoicing

rma_sale_stock_restocking_fee_invoicing folder_open OCA/rma open_in_new
Uncategorised License: AGPL-3

This module extends the standard RMA flow and the behavior of sale_stock_restocking_fee_invoicing by allowing:

  • Fixed or percentage-based restocking fees.
  • Restocking fees configurable on the RMA operation or directly on the RMA itself.
  • Automatic fee application at last step of RMA receipt.
  • Integration with different refund strategies:
  • Update sale order quantity.
  • Manual refund after receipt.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets you charge customers a fixed or percentage restocking fee when they return products through an RMA, and automatically creates the customer invoice for that fee.

This module adds restocking fees to the return (RMA) process. You can configure a fee on each RMA operation, and it is copied onto the individual RMA where you can still adjust it.

  • The fee can be a fixed amount or a percentage of the product price.
  • The fee fields only appear when the operation creates a receipt.
  • The amount must be greater than zero, and a percentage cannot exceed 100%.

When the return is received and the last stock move of the chain is completed, Odoo automatically creates a customer invoice for the restocking fee, using the product configured for restocking fees in the company settings. If no such product is configured, an error message asks you to fix the configuration.

On the RMA form a new "Invoice" button appears once the fee invoice exists, opening that invoice directly. The fee is also applied when the refund strategy updates the sale order quantity, and it is propagated to all moves in the return chain even if you set the fee after the receipt move was already created.

The module touches rma, rma.operation, sale.order and stock.move, and adds a shared restocking fee mixin used by both the RMA and the RMA operation.

Depends on

sale_stock_restocking_fee_invoicingrma_salestock_move_propagate_first_move
Models and fields (5)
  • rma · new modelrestocking_fee_type, restocking_fee_amount, restocking_fee_invoice_id, restocking_fee_visibility, manual_restocking_fee_invoice_needed
  • sale.order · extends an existing model
  • stock.move · extends an existing model
  • rma.operation · new model
  • restocking.fee.mixin · new modelrestocking_fee_type, restocking_fee_amount

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: 1 confirmed, 8 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

Configuration

Source · Odoo 18.0

To enable and configure restocking fees for RMAs:

  • Go to RMA / Configuration / Operations.
  • Open the RMA operation for which restocking fees should apply.
  • Set Restocking Fee Type:
  • Fixed Amount: A fixed amount will be added or invoiced.
  • Percentage: A percentage of the original sale line subtotal is used.
  • Set the Restocking Fee Amount:
  • If fixed: monetary amount.
  • If percentage: value between 0 and 100.

It is also possible to add, remove or change restocking fees directly on the RMA, as soon as the last move of the return moves is not validated yet.

Usage

Source · Odoo 18.0

Applying a Restocking Fee

  • Create or select a sale order.
  • Deliver the products.
  • Initiate an RMA from the sale order.

The RMA operation determines how the fee will be applied:

  • Update Quantity Strategy

If the RMA operation "Refund Action" is "Update Quantities":

  • A restocking fee sale order line is automatically added when the last move of the reception chain is validated.
  • The fee value depends on the selected fee type.
  • Manual Refund Strategy

If the RMA operation uses "Refund Action" is different than "Update Quantities"

  • A restocking fee invoice is automatically created when the last move of the reception chain is validated.

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.