Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 96 additions & 0 deletions rma_batch_reason/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
================
RMA Batch Reason
================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:0540653949a33aac87c23b7a236532945f44b0ab922584d6192a87ef331c380e
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Frma-lightgray.png?logo=github
:target: https://github.com/OCA/rma/tree/18.0/rma_batch_reason
:alt: OCA/rma
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/rma-18-0/rma-18-0-rma_batch_reason
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/rma&target_branch=18.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Managing return reasons at the batch level.

This addon extends the RMA Batch functionality by introducing a reason
field that can be set at the batch level. When a reason is assigned:

- All RMAs within that batch automatically inherit the batch's reason
- Individual RMAs can override the batch reason if needed

**Table of contents**

.. contents::
:local:

Usage
=====

To use this module:

1. Go to RMA > RMA Batches
2. Create or open an RMA Batch
3. In the form, locate the "Reason" field (added after the Operation
field)
4. Select a reason from the dropdown
5. The reason will automatically be applied to all RMAs
6. Individual RMAs can override the batch reason by setting their own
reason

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/rma/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/rma/issues/new?body=module:%20rma_batch_reason%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* ACSONE SA/NV

Contributors
------------

- Stéphane Mangin - ACSONE SA/NV stephane.mangin@acsone.eu

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/rma <https://github.com/OCA/rma/tree/18.0/rma_batch_reason>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 1 addition & 0 deletions rma_batch_reason/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
19 changes: 19 additions & 0 deletions rma_batch_reason/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Copyright 2026 ACSONE SA/NV
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

{
"name": "RMA Batch Reason",
"summary": """Add reason field to RMA batches and propagate to RMAs""",
"version": "18.0.1.0.0",
"license": "AGPL-3",
"website": "https://github.com/OCA/rma",
"author": "ACSONE SA/NV, Odoo Community Association (OCA)",
"depends": [
"rma_batch",
"rma_reason",
],
"data": [
"views/rma_batch.xml",
],
"installable": True,
}
2 changes: 2 additions & 0 deletions rma_batch_reason/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
from . import rma_batch
from . import rma
17 changes: 17 additions & 0 deletions rma_batch_reason/models/rma.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Copyright 2026 ACSONE SA/NV
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from odoo import api, models


class Rma(models.Model):
_inherit = "rma"

@api.model_create_multi
def create(self, vals_list):
for vals in vals_list:
if vals.get("batch_id") and not vals.get("reason_id"):
batch = self.env["rma.batch"].browse(vals["batch_id"])
if batch.reason_id:
vals["reason_id"] = batch.reason_id.id
return super().create(vals_list)
24 changes: 24 additions & 0 deletions rma_batch_reason/models/rma_batch.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Copyright 2026 ACSONE SA/NV
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from odoo import api, fields, models


class RmaBatch(models.Model):
_inherit = "rma.batch"

reason_id = fields.Many2one(
"rma.reason",
string="Reason",
help="Reason for the return, applied to all RMAs in the batch.",
)

@api.onchange("reason_id")
def _onchange_reason_id(self):
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@StephaneMangin I would have used computed/stored/readonly=False field instead in order to avoid onchanges implementation.

for rec in self:
if rec.state != "draft":
continue
if rec.reason_id:
rec.rma_ids.filtered(
lambda r: not r.reason_id
).reason_id = rec.reason_id
3 changes: 3 additions & 0 deletions rma_batch_reason/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[build-system]
requires = ["whool"]
build-backend = "whool.buildapi"
2 changes: 2 additions & 0 deletions rma_batch_reason/readme/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
- Stéphane Mangin - ACSONE SA/NV <stephane.mangin@acsone.eu>

8 changes: 8 additions & 0 deletions rma_batch_reason/readme/DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
Managing return reasons at the batch level.

This addon extends the RMA Batch functionality by introducing a reason field that
can be set at the batch level. When a reason is assigned:

- All RMAs within that batch automatically inherit the batch's reason
- Individual RMAs can override the batch reason if needed

9 changes: 9 additions & 0 deletions rma_batch_reason/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
To use this module:

1. Go to RMA > RMA Batches
2. Create or open an RMA Batch
3. In the form, locate the "Reason" field (added after the Operation field)
4. Select a reason from the dropdown
5. The reason will automatically be applied to all RMAs
7. Individual RMAs can override the batch reason by setting their own reason

Loading