Metadata-Version: 2.1
Name: odoo-addon-l10n_co_withholding_advance
Version: 19.0.1.0.0.2
Requires-Dist: odoo==19.0.*
Summary: Soporte para retenciones anticipadas en la contabilidad colombiana.
Home-page: https://github.com/OCA/l10n-colombia
License: AGPL-3
Author: Yan Chirino, IKU Solutions SAS, Odoo Community Association (OCA)
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
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

==================================
Retenciones anticipadas – Colombia
==================================

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

.. |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/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%2Fl10n--colombia-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-colombia/tree/19.0/l10n_co_withholding_advance
    :alt: OCA/l10n-colombia
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-colombia-19-0/l10n-colombia-19-0-l10n_co_withholding_advance
    :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-colombia&target_branch=19.0
    :alt: Try me on Runboat

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

Este módulo implementa el manejo automático de **autorretenciones
anticipadas** en facturas de venta para la localización contable de
Colombia.

La autorretención es un mecanismo tributario mediante el cual ciertas
empresas están obligadas a retener y pagar directamente al Estado un
porcentaje de sus ingresos, actuando como agentes retenedores sobre sí
mismas.

Este módulo permite:

- **Configuración flexible**: Define las cuentas contables de débito y
  crédito para las autorretenciones
- **Tasa personalizable**: Configura el porcentaje de autorretención
  según las disposiciones legales vigentes
- **Cálculo automático**: Calcula automáticamente el valor de la
  autorretención basado en la base imponible de la factura
- **Integración contable**: Genera automáticamente las líneas contables
  correspondientes en facturas de venta y notas crédito
- **Soporte para notas crédito**: Invierte correctamente los asientos
  contables en las notas crédito

**Table of contents**

.. contents::
   :local:

Usage
=====

Configuración
-------------

1. Instale el módulo desde el menú de Aplicaciones
2. Vaya a **Contabilidad > Configuración > Ajustes**
3. En la sección **Autorenta**, active la opción **Autorretención en
   Facturas de Clientes**
4. Configure los siguientes parámetros:

   - **Tasa de autorretención (%)**: Ingrese el porcentaje aplicable
     según la normativa colombiana (por ejemplo, 1.20% para
     autorretención de renta)
   - **Cuenta de autorretención débito**: Seleccione la cuenta contable
     que se usará para el débito (típicamente una cuenta de activo o
     gasto)
   - **Cuenta de autorretención crédito**: Seleccione la cuenta contable
     que se usará para el crédito (típicamente una cuenta de pasivo o de
     retenciones por pagar)

Operación Automática
--------------------

Una vez configurado, el módulo opera automáticamente:

- **En Facturas de Venta**: Al crear o modificar una factura de cliente,
  el sistema calcula automáticamente la autorretención
- **Cálculo**: El monto se calcula como:
  ``Base Imponible × Tasa de Autorretención / 100``
- **Asientos Contables**: Se crean automáticamente las líneas contables
  correspondientes
- **Notas Crédito**: En notas crédito de cliente, los asientos se
  invierten automáticamente

Ejemplo Práctico
----------------

Si tiene una factura de venta con:

- Base imponible: $10,000,000 COP
- Tasa de autorretención configurada: 1.20%

El sistema creará automáticamente:

- Línea de débito: $120,000 COP en la cuenta de autorretención débito
- Línea de crédito: $120,000 COP en la cuenta de autorretención crédito

Verificación
------------

Para verificar que la autorretención se está aplicando correctamente:

1. Cree o abra una factura de cliente
2. Verifique que exista una línea de tipo "tax" con la cuenta de
   autorretención configurada
3. Confirme que el monto corresponda al porcentaje configurado sobre la
   base imponible

Notas Importantes
-----------------

- El módulo solo aplica autorretención en documentos de tipo **Factura
  de Cliente** (``out_invoice``) y **Nota Crédito de Cliente**
  (``out_refund``)
- La autorretención NO se aplica si no hay líneas de productos en la
  factura
- Los cálculos se registran en los logs de Odoo para facilitar la
  auditoría

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-colombia/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-colombia/issues/new?body=module:%20l10n_co_withholding_advance%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
-------

* Yan Chirino
* IKU Solutions SAS

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

- **Yan Chirino** - *IKU Solutions* - Desarrollo inicial -
  `GitHub <https://github.com/yanchirino>`__

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-colombia <https://github.com/OCA/l10n-colombia/tree/19.0/l10n_co_withholding_advance>`_ project on GitHub.

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