[ADD] l10n_br_account_withholding: add new module

l10n_br_account_withholding/README.rst

@@ -0,0 +1,171 @@
+===========================
+L10n Br Account Withholding
+===========================
+
+.. 
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ !! This file is generated by oca-gen-addon-readme !!
+ !! changes will be overwritten. !!
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ !! source digest: sha256:8f8c34a37ecde08ea5a6c8309f847add82a3dbe7412f17e711a6e64dd8e2fe94
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fl10n--brazil-lightgray.png?logo=github
+ :target: https://github.com/OCA/l10n-brazil/tree/14.0/l10n_br_account_withholding
+ :alt: OCA/l10n-brazil
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+ :target: https://translation.odoo-community.org/projects/l10n-brazil-14-0/l10n-brazil-14-0-l10n_br_account_withholding
+ :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/l10n-brazil&target_branch=14.0
+ :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Automate your Brazilian tax compliance with the
+``l10n_br_account_withholding`` module for Odoo. Streamline creation of
+payable invoices for taxes withheld on supplier purchases. Ensure
+accuracy and efficiency in managing tax obligations.
+
+**Table of contents**
+
+.. contents::
+ :local:
+
+Use Cases / Context
+===================
+
+Key Actions
+-----------
+
+- **Automate Tax Compliance:** Create payable accounts for taxes
+ withheld on supplier purchases automatically.
+- **Reduce Errors:** Minimize manual entry errors and ensure accuracy
+ in tax withholdings.
+- **Streamline Efficiency:** Enhance your financial processes for
+ handling tax withholdings from suppliers.
+
+Application
+-----------
+
+Use this module to:
+
+- Withhold taxes on payments to suppliers effortlessly.
+- Achieve efficient tax compliance and streamlined reporting.
+
+Installation
+============
+
+Follow these steps to install the ``l10n_br_account_withholding`` module
+in your Odoo project:
+
+1. **Add Repository:**
+
+ - Include the OCA ``l10n-brazil`` repository in your project by
+ adding the following URL: ``https://github.com/OCA/l10n-brazil``.
+
+2. **Configure Addons Path:**
+
+ - Add the repository path to your Odoo configuration under
+ ``addons-path``.
+
+3. **Update Module List:**
+
+ - Refresh your module list to ensure Odoo recognizes the new module.
+
+4. **Search for Module:**
+
+ - In the Odoo addons, search for ``"L10n Br Account Withholding"``
+ to locate the module.
+
+5. **Install the Module:**
+
+ - Proceed to install the module in your Odoo environment.
+
+Ensure you have administrative access to perform these steps and follow
+Odoo's best practices for module installation and configuration.
+
+Configuration
+=============
+
+Follow these steps to configure tax withholding invoice generation in
+Odoo:
+
+1. **Navigate to Fiscal Settings:** Go to
+ ``Fiscal -> Configurations -> Tax Groups``. Search for withheld taxes
+ of the input type.
+
+2. **Configure Withheld Taxes:** For each tax that requires a
+ withholding tax invoice, ensure it's properly configured. If a
+ supplier isn't specified, set one. Also, specify the journal for the
+ tax invoice generation. If no journal is specified, the module will
+ use the journal from the originating purchase invoice.
+
+Usage
+=====
+
+Follow these steps to use tax withholding invoice generation in Odoo:
+
+1. **Creating a Purchase Invoice:** When creating a purchase invoice,
+ apply the withheld tax to the necessary lines.
+
+2. **Invoice Confirmation:** Upon confirming the purchase invoice, the
+ module automatically generates the withholding tax invoices.
+
+Known issues / Roadmap
+======================
+
+
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-brazil/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/l10n-brazil/issues/new?body=module:%20l10n_br_account_withholding%0Aversion:%2014.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
+-------
+
+* Escodoo
+* Akretion
+
+Contributors
+------------
+
+- ``Escodoo <https://www.escodoo.com.br>``\ \_:
+
+ - Marcel Savegnago marcel.savegnago@escodoo.com.br
+
+- ``Akretion <https://www.akretion.com.br>``\ \_:
+
+ - Renato Lima renato.lima@akretion.com.br
+
+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/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/14.0/l10n_br_account_withholding>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

l10n_br_account_withholding/__init__.py

@@ -0,0 +1 @@
+from . import models

l10n_br_account_withholding/__manifest__.py

@@ -0,0 +1,25 @@
+# Copyright 2024 Escodoo
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+ "name": "L10n Br Account Withholding",
+ "summary": """
+ Brazilian Withholding Invoice Generator""",
+ "version": "14.0.1.0.0",
+ "license": "AGPL-3",
+ "author": "Escodoo,Akretion,Odoo Community Association (OCA)",
+ "website": "https://github.com/OCA/l10n-brazil",
+ "depends": [
+ "l10n_br_account",
+ ],
+ "data": [
+ "views/account_move_line.xml",
+ "views/l10n_br_fiscal_tax_group.xml",
+ "views/account_move.xml",
+ ],
+ "demo": [
+ "demo/account_move_line.xml",
+ "demo/l10n_br_fiscal_tax_group.xml",
+ "demo/account_move.xml",
+ ],
+}

l10n_br_account_withholding/demo/account_move.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- Copyright 2024 Marcel Savegnago - Escodoo (https://www.escodoo.com.br)
+ License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
+<odoo noupdate="1">
+
+ <!-- TODO
+ <record model="account.move" id="account_move_demo_1">
+ <field name="name">...</field>
+ </record>
+ -->
+
+</odoo>

l10n_br_account_withholding/demo/account_move_line.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- Copyright 2024 Marcel Savegnago - Escodoo (https://www.escodoo.com.br)
+ License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
+<odoo noupdate="1">
+
+ <!-- TODO
+ <record model="account.move.line" id="account_move_line_demo_1">
+ <field name="name">...</field>
+ </record>
+ -->
+
+</odoo>

l10n_br_account_withholding/demo/l10n_br_fiscal_tax_group.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- Copyright 2024 Marcel Savegnago - Escodoo (https://www.escodoo.com.br)
+ License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
+<odoo noupdate="1">
+
+ <!-- TODO
+ <record model="l10n_br_fiscal.tax.group" id="l10n_br_fiscal_tax_group_demo_1">
+ <field name="name">...</field>
+ </record>
+ -->
+
+</odoo>

l10n_br_account_withholding/models/__init__.py

@@ -0,0 +1,3 @@
+from . import account_move
+from . import l10n_br_fiscal_tax_group
+from . import account_move_line