Metadata-Version: 2.1
Name: odoo-addon-account_tax_fixed_amount_multiplier
Version: 19.0.1.0.0.4
Requires-Dist: odoo==19.0.*
Summary: Control how the quantity is computed for fixed-amount taxes: standard line quantity, quantity in product UoM, or no multiplier.
Home-page: https://github.com/OCA/account-invoicing
License: AGPL-3
Author: Odoo Community Association (OCA), Camptocamp
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

===========================
Tax Fixed Amount Multiplier
===========================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/license-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%2Faccount--invoicing-lightgray.png?logo=github
    :target: https://github.com/OCA/account-invoicing/tree/19.0/account_tax_fixed_amount_multiplier
    :alt: OCA/account-invoicing
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/account-invoicing-19-0/account-invoicing-19-0-account_tax_fixed_amount_multiplier
    :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/account-invoicing&target_branch=19.0
    :alt: Try me on Runboat

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

This module adds a multiplier option to fixed-amount taxes, controlling
how the line quantity is used in the tax computation.

By default, Odoo computes fixed taxes as ``line quantity × amount``.
This module allows choosing between four multiplier modes:

- **No Multiplier**: the amount is applied once per line, regardless of
  quantity. Useful for per-document fees (e.g., stamp duties).
- **Quantity (default)**: standard behavior, equivalent to
  ``line quantity × amount``.
- **Product Quantity**: the line quantity is first converted to the
  product's unit of measure before multiplying. This is useful when the
  tax is defined per unit of the product, but the line may use a
  different UoM (e.g., selling in dozens while the product is defined in
  units).
- **Product Weight**: multiplied by the total weight of the products on
  the line (product quantity × product weight). Useful for weight-based
  fees such as environmental levies.

This module is compatible with ``account_tax_fixed_amount_currency``
without depending on it. When both modules are installed, the selected
multiplier changes the fixed-tax quantity first, and the currency module
can then convert the resulting fixed amount to the document currency
through the normal tax computation chain.

.. IMPORTANT::
   This is an alpha version, the data model and design can change at any time without warning.
   Only for development or testing purpose, do not use in production.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

In standard Odoo, fixed-amount taxes are multiplied by the line quantity
as entered on the document. This means that if a product is sold in
dozens, the tax is multiplied by 1 (the line quantity) instead of 12
(the actual number of units).

This can be problematic for taxes or fees that are defined per unit of
product, such as:

- **Per-unit recycling fees**: a fixed fee per unit sold, regardless of
  the unit of measure used on the sales line.
- **Per-kilogram levies**: a fee based on the total weight of the
  products sold (e.g., environmental taxes on volatile organic
  compounds).
- **Per-document stamps or duties**: a fixed fee applied once per line,
  regardless of the quantity.

This module addresses these use cases by allowing to control how the
quantity is interpreted in the tax computation.

Configuration
=============

To configure this module, you need to:

1. Go to *Invoicing > Configuration > Taxes*.
2. Open or create a tax with *Tax Computation* set to **Fixed**.
3. Set the **Amount Multiplier** field to the desired mode:

   - *No Multiplier*: the tax amount is applied once per line.
   - *Quantity (default)*: standard behavior, multiplied by the line
     quantity regardless of the unit of measure.
   - *Product Quantity*: the line quantity is converted to the product's
     unit of measure before multiplying.
   - *Product Weight*: multiplied by the total weight (product quantity
     × product weight).

Usage
=====

**Product Quantity** mode is useful for per-unit taxes where the product
may be sold in different units of measure.

For example, if a product is defined in *Units* and has a per-unit tax
of 5.00, selling 1 *Dozen* will compute the tax as:

::

   1 dozen = 12 units → tax = 12 × 5.00 = 60.00

This also works with nested UoM hierarchies. For example, selling 1 *Box
of 10 Dozens* will compute:

::

   1 box = 10 dozens = 120 units → tax = 120 × 5.00 = 600.00

**Product Weight** mode is useful for weight-based fees. For example,
with a levy of 3.00 per kilogram and a product weighing 2.5 kg:

::

   10 units × 2.5 kg/unit × 3.00/kg = 75.00

If ``account_tax_fixed_amount_currency`` is also installed, configure
the fixed tax currency on the tax as usual. The multiplier changes the
quantity used by the fixed tax computation, and the resulting amount is
then converted by the currency module.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/account-invoicing/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/account-invoicing/issues/new?body=module:%20account_tax_fixed_amount_multiplier%0Aversion:%2019.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
-------

* Camptocamp

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

- Iván Todorovich <ivan.todorovich@camptocamp.com>

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.

.. |maintainer-ivantodorovich| image:: https://github.com/ivantodorovich.png?size=40px
    :target: https://github.com/ivantodorovich
    :alt: ivantodorovich

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-ivantodorovich| 

This module is part of the `OCA/account-invoicing <https://github.com/OCA/account-invoicing/tree/19.0/account_tax_fixed_amount_multiplier>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
