Skip to main content
Odoo Community Association

Colombia - Retención en la Fuente

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

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

  1. Instale el módulo desde el menú de Aplicaciones

  2. Vaya a Configuración > Empresas y abra su empresa

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

  1. Vaya a Configuración > Parámetros del Sistema

  2. Busque el parámetro l10n_co_withholding.uvt_value

  3. Actualice el valor anualmente según la resolución de la DIAN (por defecto: 52374 para 2026)

Configuración de Partners

  1. Abra un contacto (proveedor o cliente)

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

  1. Cree una factura (de proveedor o de cliente)

  2. Agregue líneas de producto/servicio

  3. Haga clic en el botón “Calcular Retenciones” en la barra superior

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

Authors

  • Juan Arcos

Contributors

  • OCA - Odoo Community Association

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.

Current maintainer:

juanparmer

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for odoo_addon_l10n_co_withholding-18.0.1.0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 586e9edec78fa8e8b2658cde2b521461354f8e04e34966942545b1ef771a42f9
MD5 8ff967bb483762aadd58bb45ebcebee8
BLAKE2b-256 8ea573318aafbb0a43ea6da7cf6271a35080171d6a5d1c3c2c70522f5dc2986a

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

18.0.1.0.0.2 This release

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page