Metadata-Version: 2.1
Name: odoo-addon-account_tax_fixed_amount_currency
Version: 19.0.1.0.0.2
Requires-Dist: odoo==19.0.*
Summary: Allow fixed-amount taxes to have their amount expressed in a specific currency, with automatic conversion to the document currency.
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 Currency
=========================

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

.. |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_currency
    :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_currency
    :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 allows fixed-amount taxes to have their amount expressed in
a specific currency instead of the document currency.

When a currency is set on the tax, the fixed amount is automatically
converted to the document currency at invoice time using the appropriate
exchange rate.

Three conversion scenarios are supported:

- **Tax currency = document currency**: no conversion is applied.
- **Tax currency = company currency**: the amount is converted using the
  document's exchange rate.
- **Tax currency is a third currency**: the amount is first converted to
  the company currency, then to the document currency.

The conversion rate is determined at the invoice date, not the current
date, ensuring accurate historical conversions.

This module is compatible with ``account_tax_fixed_amount_multiplier``
without depending on it. When both modules are installed, multiplier
modes such as product quantity or product weight adjust the fixed-tax
quantity first, and this module converts the resulting fixed amount to
the document currency.

.. 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:

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 Currency** field to the currency in which the fixed
   amount is expressed.
4. Leave the field empty for standard behavior (amount in document
   currency).

Usage
=====

Once configured, the tax behaves like a standard fixed tax but with
automatic currency conversion. When creating an invoice in a foreign
currency, the tax amount will be converted from the tax's currency to
the document's currency.

For example, if a tax is configured with a fixed amount of CHF 10 and
the invoice is in EUR, the tax amount will be converted from CHF to EUR
using the exchange rate at the invoice date.

If ``account_tax_fixed_amount_multiplier`` is also installed, configure
the multiplier on the tax as usual. The multiplier is applied before
conversion, so a tax defined in CHF per product unit or kilogram is
first multiplied by the relevant quantity, then converted to the invoice
currency.

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_currency%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.

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

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