Retenciones anticipadas – Colombia
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
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 19.0Añade automáticamente líneas contables de autorretención a las facturas de cliente y notas de crédito en la localización colombiana, en función de una tarifa y unas cuentas que configures en los ajustes de Contabilidad.
Este módulo añade un bloque "Autorenta" a la pantalla de configuración de Contabilidad. Allí puedes activar la retención sobre facturas de cliente, establecer un porcentaje y elegir las cuentas de débito y crédito a utilizar. Las cuentas de débito y crédito pasan a ser obligatorias una vez activada la opción.
Cuando la opción está activada, el módulo crea o actualiza automáticamente una línea de diario de tipo impuesto en las facturas de cliente (out_invoice) y en las notas de crédito de cliente (out_refund). El importe se calcula como la base imponible de la factura multiplicada por el porcentaje configurado, dividido entre 100. En las notas de crédito se intercambian el debe y el haber para que el asiento se invierta correctamente.
- Si la factura no tiene líneas de producto, se elimina cualquier línea de retención existente.
- Si ya existe una línea en la cuenta configurada, se actualiza en lugar de duplicarse.
- La línea se nombra usando el número de factura y el nombre de la cuenta.
Solo se ven afectadas las facturas de cliente y las notas de crédito de cliente; las facturas de proveedor no se tocan. El cálculo se ejecuta como parte del proceso de sincronización de la factura, por lo que la línea se actualiza cuando se actualiza la factura. No se añaden menús ni informes nuevos; todo se gestiona desde la configuración de Contabilidad existente y el formulario de factura.
Depende de
Modelos y campos (2)
- account.move · amplía un modelo existente
- res.config.settings · amplía un modelo existentel10n_co_withholding_advance_rate (Tasa de autorretención (%)), l10n_co_withholding_advance_enabled (Autorretención en Facturas de Clientes), l10n_co_withholding_advance_debit_id (Cuenta de autorretención débito), l10n_co_withholding_advance_credit_id (Cuenta de autorretención crédito)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 2 confirmadas, 7 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/l10n-colombia.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
- Instale el módulo desde el menú de Aplicaciones
- Vaya a Contabilidad > Configuración > Ajustes
- En la sección Autorenta, active la opción Autorretención en Facturas de Clientes
- 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:
- Cree o abra una factura de cliente
- Verifique que exista una línea de tipo "tax" con la cuenta de autorretención configurada
- 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
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.