Odoo Community Association

Retenciones anticipadas – Colombia

Beta License: AGPL-3 OCA/l10n-colombia Translate me on Weblate Try me on Runboat

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:

Table of contents

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. 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

Authors

  • Yan Chirino
  • IKU Solutions SAS

Contributors

  • Yan Chirino - IKU Solutions - Desarrollo inicial - GitHub

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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 project on GitHub.

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