OdooWiki OCA HUB

Colombia - Retención en la Fuente

l10n_co_withholding folder_open OCA/l10n-colombia open_in_new
Accounting/Localizations License: AGPL-3

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

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds Colombian withholding tax support (ReteFte, ReteIVA, ReteICA) to invoices, with a button to automatically apply withholding taxes, minimum base rules in UVT, and per-city/economic-activity ReteICA rates.

This module lets Colombian companies act as withholding agents and automatically apply withholding taxes on customer and vendor invoices.

  • In Accounting settings you can mark the company as a withholding agent and choose default ReteFte, ReteIVA and ReteICA taxes.
  • On a draft invoice (vendor bill, vendor credit note, customer invoice or credit note) a "Calcular Retenciones" button applies the applicable withholding taxes to the product lines, respecting minimum bases expressed in UVT.
  • Partners get a "Retenciones Colombia" section with tax regime (Ordinary, Simple, Non-taxpayer), city, gran contribuyente, autorretenedor and retention agent flags. Partners under the Simple regime do not get ReteFte; non-taxpayers get no withholding at all.
  • A new "Tarifas ReteICA" menu under Accounting lets you maintain ReteICA rates per city and economic activity, with minimum service and purchase bases in UVT. The rate is found from the partner's city and economic activity, falling back to the activity prefix or a generic code.
  • Withholding taxes carry a concept (honorarios, servicios, compras, etc.), a type (ReteFte, ReteIVA, ReteICA) and a minimum base in UVT.
  • On installation, the module sets a default UVT value, creates 0% withholding taxes, fiscal positions for Régimen Simple and No Contribuyente, and positive counterpart taxes for sales withholdings so invoice totals match what is reported to DIAN.

Depends on

accountl10n_cobase_address_extendedl10n_co_economic_activities

Menus it adds

Tarifas ReteICA
Models and fields (7)
  • account.tax · extends an existing modell10n_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 · extends an existing modell10n_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 · extends an existing modelcity_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 · extends an existing model
  • account.tax.group · extends an existing modell10n_co_withholding_counterpart (Grupo de Contrapartida de Retención)
  • res.config.settings · extends an existing modell10n_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 · new modelrate (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))

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/l10n-colombia.

terminal Installation and usage

OCA documentation · Odoo 18.0

Usage

Source · Odoo 18.0

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.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.