OdooWiki OCA HUB

Colombia - Pre-configuración Factura Electrónica

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

This module implements the preconfiguration data required for electronic document interchange (EDI) in Colombia. It provides the necessary fields, codes, and reference data for Colombian EDI compliance:

> - Preconfiguración EDI Colombia (desarrollado por [Yan Chirino - IKU Solutions]): > Implements Colombian EDI preconfiguration including payment methods, responsibility types, tax types, > CIIU codes, UNSPSC codes, UOM codes, and geographic data required for electronic invoicing. > For more information, visit >

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds Colombian electronic invoicing pre-configuration to Odoo: fiscal responsibility types, payment methods, tax types, CIIU economic activity codes, UNSPSC product codes and UNECE unit codes, plus DIAN-related fields on invoices, partners and products.

This module prepares Odoo for Colombian electronic invoicing (Factura Electrónica) by adding the reference data and fields required by the DIAN. It does not send documents to the DIAN by itself; it provides the configuration and data that other EDI modules use.

On customer invoices and credit/debit notes (account.move) it adds Colombian fields: Forma de Pago (cash or credit, default cash), Medio de Pago (defaults to a pre-loaded payment method), an automatically computed Operation Type based on the document type and whether the note references another invoice, invoice period start/end dates, a correction concept for credit/debit notes, and DIAN tracking fields such as CUFE/CUDE, DIAN status, generation date and ZipKey. Once a document is marked as sent or accepted by the DIAN, the Reset to Draft button is hidden.

On contacts and companies it adds fiscal regime, fiscal responsibilities, main and other economic activities (CIIU), and an autoretenedor flag that is automatically set when the fiscal regime is O-15. On products it adds UNSPSC code, brand, model and a nominal consumption tax rate. Taxes get a Colombian tax type (default IVA). Units of measure get a UNECE code.

New menus under Accounting Configuration > Localización Colombia let users maintain tax types, payment methods, fiscal responsibilities, UNSPSC products and UNCEFACT codes; CIIU activities are under Contacts localisation.

Depends on

basebase_address_extendedl10n_col10n_latam_basel10n_latam_invoice_documentaccountstockcontacts

Required by other modules

Menus it adds

Localización ColombiaTipo de impuestoMétodo de pagoResponsabilidad fiscalProductos UNSPSCCódigos UNCEFACTClasificación de Actividades Económicas CIIU
Models and fields (13)
  • uom.uom · extends an existing modelunece_code_id (Código de unidad de medida UNECE)
  • account.tax · extends an existing modell10n_co_tax_type_id (Tipo de impuesto)
  • res.company · extends an existing modell10n_co_ciiu_id, l10n_co_ciiu_ids (Otras actividades economicas), l10n_co_autoretenedor (¿Es Autorretenedor?), l10n_co_regimen_fiscal (Regimen Fiscal), l10n_co_responsibility_ids (Responsabilidades)
  • res.partner · extends an existing modell10n_co_ciiu_id, l10n_co_ciiu_ids (Otras actividades economicas), l10n_co_regimen_fiscal (Regimen Fiscal), l10n_co_responsibility_ids (Responsabilidades)
  • account.move · extends an existing modell10n_co_dian_status (Estado en DIAN), l10n_co_dian_zip_key (ZipKey DIAN), l10n_co_payment_term (Forma de Pago), l10n_co_edi_cufe_cude_ref (CUFE/CUDE), l10n_co_payment_method_id (Medio de Pago), l10n_co_invoice_period_end (Periodo Fin), l10n_co_dian_operation_type (Operation Type (CO)), l10n_co_dian_generation_date (Fecha de generación del documento), l10n_co_invoice_period_start (Periodo Inicio), l10n_co_discrepancy_response_code (Concepto de Corrección)
  • l10n_co.ciiu · new modelcode (Código), active (Activo), is_code (¿Es código?), parent_id (Padre), description (Descripción)
  • product.unspsc · new modelname (Nombre Producto), active (Activo), class_code (Código Clase), class_name (Nombre Clase), family_code (Código Familia), family_name (Nombre Familia), product_code (Código Producto), segment_code (Código Segmento), segment_name (Nombre Segmento)
  • unece.uom.code · new modelcode (Codigo), name (Referencia), active (Activo)
  • l10n_co.tax.type · new modelcode (Código), name (Referencia), active (Activo), is_withholding_tax (Es retención?)
  • product.template · extends an existing modelproduct_brand (Marca), product_model (Modelo), product_unspsc_id (Producto UNSPSC), l10n_co_edi_ref_nominal_tax (Tarifa Nominal Impuesto Consumo)
  • l10n_co.payment.method · new modelcode (Código), name (Nombre), active (Activo)
  • l10n_co.responsibility.type · new modelcode (Codigo), name (Referencia), active (Activo), display_name (Nombre)
  • l10n_latam.identification.type · extends an existing modell10n_co_document_iso_code (ISO Code)

Text generated by AI (DeepSeek) from reading the Odoo 19.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: 2 confirmed, 7 with no information of 9 versions.

Sources · Odoo 19.0

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

terminal Installation and usage

OCA documentation · Odoo 19.0
  • Install the module from the Apps menu
  • The module will automatically load all Colombian EDI reference data and create the necessary configuration fields

Automatic Operation

Once installed, the module operates automatically:

  • Data Loading: All Colombian EDI reference data is automatically loaded including payment methods, responsibility types, and tax types
  • Field Creation: Required fields for EDI compliance are automatically added to relevant models
  • Configuration: Colombian-specific settings are applied to companies and partners

Manual Configuration

If you need to manually configure EDI settings:

  • Go to Invoicing > Configuration > Colombian Localization
  • Configure payment methods, responsibility types, and tax types
  • Set up company and partner information with required Colombian fields

Configuration

The module automatically provides:

  • Colombian payment methods (DIAN approved)
  • Responsibility types for tax purposes
  • Tax types and classifications
  • CIIU codes for economic activities
  • UNSPSC codes for products and services
  • UOM codes for units of measure
  • Geographic data (states, cities, postal codes)

Troubleshooting

If EDI data is not loading properly:

  • Check that the module dependencies are installed
  • Verify that Colombian localization is properly configured
  • Review Odoo logs for any data loading errors
  • Ensure all required fields are properly mapped

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.