Colombia - Retención en la Fuente
Retención en la Fuente para Colombia
Este módulo implementa el soporte para retención en la fuente (RteFte), ReteIVA y ReteICA en la localización contable de Colombia.
La retención en la fuente es el mecanismo mediante el cual el Estado colombiano recauda anticipadamente impuestos a través de los agentes retenedores.
Características principales:
Configuración en la compañía: Define si la empresa es agente de retención y las retenciones por defecto (RteFte, ReteIVA, ReteICA)
Clasificación de partners: Régimen tributario, tipo de persona, gran contribuyente, autorretenedor
Posiciones fiscales automáticas: Con mapeo de cuentas para desactivar retenciones según el régimen del proveedor (Régimen Simple, No Contribuyente)
Impuestos con conceptos: Cada impuesto de retención tiene asociado un concepto tributario (honorarios, servicios, compras, etc.)
Cuantías mínimas: Validación automática de la base mínima en UVT (configurable vía parámetro del sistema)
Cálculo automático: Botón “Calcular Retenciones” en facturas que aplica las retenciones según la configuración de la compañía y el partner
Soporte para ventas y compras: Aplica retenciones tanto en facturas de proveedor como de cliente
Integración con factura electrónica: Los impuestos negativos se reportan correctamente como WithholdingTaxTotal en el EDI UBL
Table of contents
Usage
Configuración de la Compañía
Instale el módulo desde el menú de Aplicaciones
Vaya a Configuración > Empresas y abra su empresa
En la pestaña “Retenciones Colombia”:
Active “Agente de Retención” si su empresa actúa como agente
Configure las retenciones por defecto:
ReteFte por Defecto: Impuestos de retención en la fuente
ReteIVA por Defecto: Impuestos de retención de IVA
ReteICA por Defecto: Impuestos de retención de ICA
Configuración del Valor UVT
El valor de la UVT se configura como parámetro del sistema:
Vaya a Configuración > Parámetros del Sistema
Busque el parámetro l10n_co_withholding.uvt_value
Actualice el valor anualmente según la resolución de la DIAN (por defecto: 52374 para 2026)
Configuración de Partners
Abra un contacto (proveedor o cliente)
En la pestaña “Retenciones Colombia”:
Régimen Tributario: Ordinario, Simple o No Contribuyente
Tipo de Persona: Natural o Jurídica
Gran Contribuyente: Si aplica
Autorretenedor: Si aplica
Uso - Calcular Retenciones en Facturas
Cree una factura (de proveedor o de cliente)
Agregue líneas de producto/servicio
Haga clic en el botón “Calcular Retenciones” en la barra superior
El sistema calculará automáticamente las retenciones aplicables según:
Configuración de la compañía (agente de retención + retenciones por defecto)
Régimen del partner (Simple no aplica RteFte, No Contribuyente no aplica nada)
Tipo de persona del partner
Cuantías mínimas en UVT
Posiciones Fiscales
El módulo incluye posiciones fiscales preconfiguradas con mapeo de cuentas:
Régimen Simple (Sin ReteFte): Elimina las retenciones de renta (RteFte) pero mantiene ReteIVA y ReteICA. Mapea cuentas de pasivo (236xxx) a activo (135xxx)
No Contribuyente (Sin Retenciones): Elimina todas las retenciones (RteFte, ReteIVA, ReteICA). Mapea cuentas de pasivo a activo
Asigne la posición fiscal correspondiente al partner para que las retenciones se ajusten automáticamente.
Bug Tracker
Bugs are tracked on GitHub 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.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
OCA - Odoo Community Association
Maintainers
This module is maintained by the OCA.
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.
Current maintainer:
This module is part of the OCA/l10n-colombia project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 maintainer
Metadata
1 maintainer
Release files for odoo-addon-l10n-co-withholding 18.0.1.0.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl | Python 3 | none | any | Details for odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl |
Release files / odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl
| Download URL | odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl |
|---|---|
| Size | 44.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
586e9edec78fa8e8b2658cde2b521461354f8e04e34966942545b1ef771a42f9
|
|
BLAKE2b-256 checksum How to use checksums |
8ea573318aafbb0a43ea6da7cf6271a35080171d6a5d1c3c2c70522f5dc2986a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for odoo-addon-l10n-co-withholding 18.0.1.0.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
