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
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Añade soporte de retenciones colombianas (ReteFte, ReteIVA, ReteICA) a las facturas, con un botón para aplicar automáticamente las retenciones, reglas de base mínima en UVT y tarifas de ReteICA por ciudad/actividad económica.
Este módulo permite a las empresas colombianas actuar como agentes de retención y aplicar automáticamente impuestos de retención en facturas de clientes y proveedores.
- En los ajustes de Contabilidad puedes marcar la empresa como agente de retención y elegir los impuestos por defecto ReteFte, ReteIVA y ReteICA.
- En una factura en borrador (factura de proveedor, nota de crédito de proveedor, factura de cliente o nota de crédito) un botón "Calcular Retenciones" aplica los impuestos de retención aplicables a las líneas de producto, respetando las bases mínimas expresadas en UVT.
- Los contactos obtienen una sección "Retenciones Colombia" con régimen fiscal (Ordinario, Simple, No contribuyente), ciudad, gran contribuyente, autorretenedor y marcas de agente de retención. Los contactos bajo el régimen Simple no obtienen ReteFte; los no contribuyentes no obtienen ninguna retención.
- Un nuevo menú "Tarifas ReteICA" bajo Contabilidad te permite mantener las tarifas de ReteICA por ciudad y actividad económica, con bases mínimas de servicios y compras en UVT. La tarifa se encuentra a partir de la ciudad y la actividad económica del contacto, recurriendo al prefijo de la actividad o a un código genérico.
- Los impuestos de retención llevan un concepto (honorarios, servicios, compras, etc.), un tipo (ReteFte, ReteIVA, ReteICA) y una base mínima en UVT.
- Al instalar, el módulo establece un valor de UVT por defecto, crea impuestos de retención al 0%, posiciones fiscales para Régimen Simple y No Contribuyente, e impuestos de contrapartida positivos para las retenciones de ventas de modo que los totales de las facturas coincidan con lo reportado a la DIAN.
Depende de
Menús que añade
Modelos y campos (7)
- account.tax · amplía un modelo existentel10n_co_min_base_uvt (Base Mínima (UVT)), l10n_co_withholding_type (Tipo de Retención), l10n_co_withholding_concept (Concepto de Retención), l10n_co_withholding_counterpart (Contrapartida de Retención), l10n_co_withholding_compensates_tax_id (Retención Compensada)
- res.company · amplía un modelo existentel10n_co_is_retention_agent (Agente de Retención), l10n_co_default_rte_fte_tax_ids (ReteFte por Defecto), l10n_co_default_rte_ica_tax_ids (ReteICA por Defecto), l10n_co_default_rte_iva_tax_ids (ReteIVA por Defecto)
- res.partner · amplía un modelo existentecity_id (Ciudad), l10n_co_tax_regime (Régimen Tributario), l10n_co_is_authorretenedor (Autorretenedor), l10n_co_is_retention_agent (Agente de Retención), l10n_co_is_gran_contribuyente (Gran Contribuyente)
- account.move · amplía un modelo existente
- account.tax.group · amplía un modelo existentel10n_co_withholding_counterpart (Grupo de Contrapartida de Retención)
- res.config.settings · amplía un modelo existentel10n_co_is_retention_agent (Agente de Retención Colombia), l10n_co_default_rte_fte_tax_ids (ReteFte por Defecto), l10n_co_default_rte_ica_tax_ids (ReteICA por Defecto), l10n_co_default_rte_iva_tax_ids (ReteIVA por Defecto)
- l10n.co.reteica.rate · modelo nuevorate (Tarifa (%)), active, city_id (Ciudad), economic_activity_id (Actividad Económica), min_base_services_uvt (Base Mínima Servicios (UVT)), min_base_purchases_uvt (Base Mínima Compras (UVT))
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-colombia.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Configuració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.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.