Odoo Colombia Localization: DIAN E-Invoicing, Withholdings and PUC
Odoo Colombia localization for 19 and 20: DIAN e-invoicing, documento soporte, ReteFuente, ReteIVA, ReteICA, PUC chart of accounts, POS and exógena.
Colombian companies looking at Odoo usually ask one thing first: can it issue a factura electrónica the DIAN will accept? Yes, and our Odoo implementation services start with the DIAN setup, because every later step depends on it.
Related service: Odoo for finance teams — accounting, tax and reporting automation.
This guide is for finance leads, contadores and IT managers in Colombia, plus regional groups adding a Colombian company to an existing Odoo database. If you run companies across Latin America, compare it with our Odoo Peru e-invoicing guide for SUNAT and OSE.
What does the Odoo Colombia localization include?
The Odoo Colombia localization is a set of five modules: one Community accounting module and four for e-invoicing, reports and POS. We checked the module list in the 19.0 and 20.0 docs and the public Odoo source code.
| Module | Technical name | Edition | What it adds |
|---|---|---|---|
| Colombia - Accounting | l10n_co | Community (LGPL) | PUC chart of accounts, IVA, INC, withholdings, ID types |
| E-invoicing with DIAN | l10n_co_dian | Enterprise | Direct DIAN connection, invoices, support documents |
| E-invoicing with Carvajal | l10n_co_edi | Enterprise | Same documents through Carvajal |
| Colombian accounting reports | l10n_co_reports | Enterprise | Withholding certificates for suppliers |
| Colombian Point of Sale | l10n_co_pos | Community (LGPL) | POS receipts for Colombia |
The Odoo 20 Colombia localization docs list the same five modules as 19.0. We found l10n_co and l10n_co_pos in the public Odoo repository for 19.0 and 20.0. The DIAN, Carvajal and reports modules are not there, so they ship with Enterprise.
That matters for budgeting. Odoo Community can keep Colombian books, but it cannot send a single invoice to the DIAN without a third-party module. Some guides list l10n_co_edi as Community; the source code says otherwise.
Which Odoo Colombia DIAN e-invoicing option should you choose?

Choose the direct DIAN connection unless you already have a Carvajal contract or a group-wide reason to use a provider. Both produce valid DIAN documents; they differ in who sits between Odoo and the DIAN.
| Factor | DIAN direct (own software) | Carvajal (technology provider) |
|---|---|---|
| Module | l10n_co_dian | l10n_co_edi |
| Provider setting in Odoo | "DIAN: Free Service" | Carvajal credentials |
| Provider fee | None from the DIAN | Carvajal contract |
| DIAN enablement | Your company, automated by Odoo | Handled with the provider |
| POS e-invoicing | Supported from Odoo 18 | Not supported |
| Best fit | Most new Odoo projects | Firms already on Carvajal |
Odoo's own documentation calls the DIAN provider option "DIAN: Free Service". Odoo staff also confirmed on the forum that POS e-invoicing works only with the direct DIAN module, not with Carvajal. That alone settles the choice for retailers.
What do you need before you start DIAN e-invoicing in Odoo?
You need a RUT with a valid NIT, a digital signature certificate from an ONAC-accredited issuer, and an enabled status with the DIAN. Odoo's docs list these three prerequisites for the own-software route.
- RUT and NIT: the company is registered in the RUT, and the NIT in Odoo ends with the verification digit after a hyphen.
- Signature certificate: uploaded in PEM format with its private key; in a multi-company database each company can have its own.
- Operation modes: the software ID, software PIN and testing ID you register in the DIAN portal for invoices and for support documents.
- Invoicing resolution: the DIAN resolution number, prefix, dates and numbering range for each sales journal.
- Fiscal information: obligations such as O-13 Gran Contribuyente, O-15 Autorretenedor, O-23 Agente de retención IVA or O-47 Régimen simple.
- Product codes: each product needs a UNSPSC category or an internal reference.
Missing master data is the most common reason Odoo blocks a send. Clean contacts and products before go-live, not after the first rejection.
How do you set up Odoo facturación electrónica in Colombia?
Set up Odoo facturación electrónica in five steps: credentials, environment, enablement, journals, then a live test. Do the first three in a test database, as Odoo's docs advise.
- Credentials: in Accounting settings, under Colombian Electronic Invoicing, pick the provider, add the operation modes and upload the certificate.
- Environment: Odoo offers four: DIAN demo mode, certification, testing and production. Never tick demo mode on a production database.
- Enablement: tick Test Environment and Activate Certification Process, enter the number of documents the DIAN asks for, and click Begin Certification Process.
- Journals: in production, click Reload DIAN configuration on each sales journal to pull the resolution, or enter the resolution fields by hand.
- First invoice: change the first number to the DIAN format, prefix plus sequence (for example SETP1, not SETP/2024/00001).
Odoo creates and sends the enablement set to the DIAN certification environment. Confirm your status shows "Enabled" in the DIAN portal before switching to production; if not, run the process again.
When you send an invoice, Odoo builds the XML, signs it, computes the CUFE, gets the DIAN response, and emails the customer a zip with the PDF and the attached document. Rejection codes show in the DIAN tab of the invoice.
How does documento soporte work for vendor bills in Odoo?
Documento soporte is the electronic support document for purchases from suppliers who do not issue e-invoices, and Odoo issues it from a dedicated purchase journal. It uses the same DIAN modules and credentials as sales invoices.
Create a purchase journal just for support documents, add its DIAN resolution, and register a separate operation mode in the DIAN portal. An Odoo staff guide on the forum says the documento soporte flow needs l10n_co_dian from Odoo 17 on.
The same thread answers a common question: the technical key for the support document journal is the same one you use for e-invoicing. Credit and debit notes follow the normal Odoo refund and debit note flows and are sent the same way.
How are retenciones handled in Odoo Colombia?
Odoo Colombia ships ReteFuente, ReteIVA and ReteICA as negative purchase and sales taxes, so withholdings post on the bill and the payment nets them off. You still decide which ones apply to which supplier.
| Withholding | Rates preloaded in the 20.0 template | Typical use |
|---|---|---|
| Retención en la fuente (ReteFuente) | 0.1% to 11% by concept, such as 2.5% purchases, 4% services, 10% fees, 3.5% software | Income tax withheld on purchases, services and fees |
| ReteIVA | 15% of the IVA, on 19% and 5% IVA | VAT withheld by agentes de retención |
| ReteICA | 0%, 0.414%, 0.69%, 0.966%, 1.104%, 1.38% | Municipal industry and commerce tax |
| IVA and INC | IVA 19%, 5%, 0%, exempt and excluded; INC 4%, 8%, 16% | Sales tax and consumption tax |
The template also sets account 236500 as the withholding tax base account. In Odoo 20 we also found new taxes for free samples and gifts (assumed IVA at 19% and 5%) and a 1.2% VAT self-withholding.
Treat these rates as a starting point. ReteFuente thresholds in UVT and each city's ReteICA rate are your contador's call, so add taxes or fiscal positions where they differ.
For year-end, l10n_co_reports gives three supplier certificates: Certificado de Retención en la Fuente, en IVA and en ICA. Each exports to Excel or copies to the Documents app.
How is the PUC chart of accounts set up in Odoo contabilidad Colombia?
The chart of accounts installs with l10n_co and is based on the PUC (Plan Único de Cuentas), already mapped to taxes, receivables and payables. Odoo 20 changes how that chart is structured.
In the 19.0 source, the Colombian template is a flat list of 378 accounts. In 20.0 it lists 801 PUC entries in a parent hierarchy, from class (1 Assets) down to group and account. Reports can then roll up by PUC level without extra account groups.
Key defaults are the same in both versions: bank accounts under 1110, cash under 1105, receivables 130500, payables 220500 and Anglo-Saxon accounting switched on. Our guide on how Odoo Accounting works explains what those settings do.
For foreign currency, Odoo can pull the official rate from the Banco de la República on a schedule. Our multi-currency accounting guide covers revaluation and FX gains.
What changed for Colombia in Odoo 19 and 20?
The biggest recent changes are POS e-invoicing, exógena reports and the rebuilt PUC hierarchy. The setup screens for DIAN e-invoicing are almost the same in 19.0 and 20.0.
| Change | Version | What it means |
|---|---|---|
| POS e-invoicing (l10n_co_edi_pos) | Odoo 18 and later, from 23 March 2026 | Final-consumer and named-customer e-invoices from the till |
| Exógena (medios magnéticos) | Odoo 19.2 and later | CSV files for formats 1001, 1003, 1005 to 1009 |
| PUC as a hierarchy | 20.0 template | 801 entries with parent accounts |
| New sample and self-withholding taxes | 20.0 template | Free-sample IVA and 1.2% self-withholding |
| l10n_latam_base dependency dropped | 20.0 manifest | Fewer modules to install |
The exógena feature for medios magnéticos maps accounts to DIAN formats and exports CSV files. You still paste them into the DIAN prevalidador, which runs only on Windows, to create the official XML.
Users report two snags on that thread: many accounts start unmapped, and CSV amounts ending in ".0" import wrongly into Excel. Plan a mapping session with your contador before the first filing.
Version 19.2 is an Odoo Online release. On Odoo.sh and on-premise, features from Online releases arrive with the next major version, so plan Odoo 20 if you need exógena outside Odoo Online.
What does Odoo not cover for Colombia?
Odoo covers invoicing, support documents and withholdings well, but payroll, contingency invoicing and some city-level rules need extra work. Plan for these:
- Nómina electrónica: Odoo's payroll localization docs have no Colombia page in 19.0 or 20.0, so plan electronic payroll separately.
- Contingency invoices: one v18 user hit DIAN rule FAI01 on a contingency invoice, as the contingency invoice thread shows. Test this flow before you need it.
- ReteICA by city: one company billing in several municipalities needs a tax and fiscal position per city.
- Custom reports: formats your auditor or sector regulator wants beyond the standard certificates.
Our broader Odoo localization gaps guide shows the same pattern in other countries.
How do Colombian industries use the Odoo Colombia localization?
Each industry stresses a different part of the localization, so start your test plan with the documents you issue most. The table shows where we usually focus.
| Industry | Pain or cost driver | Odoo approach | How iVentureTeam helps |
|---|---|---|---|
| Retail and restaurants | High volume of final-consumer sales | POS e-invoicing with a final-consumer journal | Set up two numbering ranges and daily close |
| Distribution | Many suppliers, many ReteFuente concepts | Withholding taxes on bills, certificates at year end | Map concepts and fiscal positions |
| Manufacturing | Stock valuation and costing under the PUC | Anglo-Saxon accounting, stock accounts 1405 | Design valuation and WIP accounts |
| Professional services | Fees, informal suppliers | Documento soporte and ReteFuente on fees | Configure support document journal |
| Regional groups | Colombia plus Peru or Guatemala | One database, one localization per company | Multi-company and intercompany setup |
Groups that also trade in Central America can read our Odoo Guatemala FEL guide, which covers the Infile flow in the same structure.
How much does an Odoo Colombia implementation cost?
Budget for Odoo licenses, the localization setup and data migration; the DIAN direct route adds no provider fee. The DIAN modules need an Enterprise subscription.
On the Odoo pricing page, the US price billed yearly is US$31.10 per user a month for Standard and US$61.00 for Custom. Custom adds multi-company, Studio and Odoo.sh or on-premise hosting.
Our published ranges are $3k to $9k for small projects (4 to 8 weeks), $9k to $27k for mid-size (8 to 14 weeks) and $27k to $150k+ for large ones (12 to 24 weeks). Data migration runs $1.2k to $9k depending on the source system and years of history.
For a number based on your users and apps, try the Odoo project estimate tool, and keep our Odoo implementation checklist open while you plan.
How iVentureTeam helps with Odoo Colombia localization

We set up Odoo Colombia end to end, from DIAN enablement to the withholding certificates your suppliers ask for. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.
- DIAN setup: operation modes, certificates, the automated enablement in a test database, and resolutions on every journal.
- Withholdings and PUC: ReteFuente concepts, ReteIVA, city-level ReteICA and a PUC mapping your contador signs off.
- POS and eCommerce: final-consumer journals, numbering ranges and daily close.
- Gaps: payroll links, contingency tests and custom reports through our Odoo customization services.
- Migration: opening balances and open items from your current software into Odoo.
Odoo localization case study: Fernando Tax Management
A Dutch tax firm moved to Odoo 18 with iVentureTeam and got localized tax compliance reports for two jurisdictions. It is not a Colombian project, but it shows the same work: local tax reports on standard Odoo Accounting.
Fernando Tax Management B.V. had outgrown a rigid legacy system. Manual entry across systems produced duplicate records, and reports had translation gaps, a real liability for a firm whose output feeds government compliance.
We migrated the firm to Odoo 18 in 10 weeks, built custom tax compliance reports for the Netherlands and Curaçao, fixed a hidden journal lines issue and corrected translation defects. Manual data entry fell by 60%.
Read the Fernando Tax Odoo accounting automation case study.
The bottom line on Odoo Colombia localization
Odoo is a strong fit for Colombian companies that want DIAN e-invoicing, withholdings and PUC accounting in one ERP, as long as they budget for Enterprise and plan payroll separately. The direct DIAN route keeps running costs down.
Run the enablement in a test database, agree withholding rules with your contador, and test POS, support documents and contingency invoices before go-live. Most problems we see come from master data, not from Odoo.
Ready to go live with DIAN e-invoicing in Odoo?

Get your Colombian company set up right the first time. Plan your Odoo Colombia DIAN rollout with us, call +91-90235-15208, or email business@iventureteam.com.
Frequently Asked Questions
Does Odoo support electronic invoicing in Colombia?
+
Yes. The l10n_co_dian module sends invoices, credit notes, debit notes and support documents straight to the DIAN, and l10n_co_edi does the same through Carvajal. Both are Enterprise modules.
Is the Odoo Colombia localization free in Community?
+
Partly. The l10n_co module with the PUC chart of accounts, taxes and withholdings is in Community. The DIAN e-invoicing and withholding certificate modules are Enterprise, so Community needs a third-party module to invoice electronically.
Do I need a technology provider to invoice the DIAN from Odoo?
+
No. Odoo can connect as your own software through the "DIAN: Free Service" option. You only need Carvajal if you choose it as your provider.
How does Odoo handle retención en la fuente?
+
Retención en la fuente is a negative tax on the vendor bill, with rates from 0.1% to 11% by concept in the 20.0 template. Odoo also produces the Certificado de Retención en la Fuente for suppliers.
Can Odoo POS issue electronic invoices in Colombia?
+
Yes, from Odoo 18 with the l10n_co_edi_pos module and the direct DIAN connection. You need two numbering ranges, one for final-consumer invoices and one for regular invoices.
Does Odoo generate información exógena for the DIAN?
+
From version 19.2, Odoo maps accounts to formats 1001, 1003 and 1005 to 1009 and exports CSV files. You then load them into the DIAN prevalidador to create the official XML.
Does Odoo include Colombian electronic payroll?
+
Odoo's 19.0 and 20.0 payroll localization docs have no Colombia page. Plan nómina electrónica with a specialist module or provider and connect it to Odoo Accounting.
How long does an Odoo Colombia implementation take?
+
Our published ranges run from 4 to 8 weeks for small projects to 12 to 24 weeks for large ones. DIAN enablement in a test database usually fits inside the first phase.
Free e-invoicing and tax readiness check
Getting Odoo ready for e-invoicing?
We check your Odoo version, localization and invoice flows against e-invoicing, then send what to set up, what to test and the effort involved.
Free, with no obligation. A senior consultant replies within 12 business hours.
Free Odoo tools
All tools- Odoo Health CheckVersion, modules, findings and upgrade cost
- Odoo App SelectorWhich apps you need, by industry
- Odoo Project EstimateIndicative cost and timeline in minutes
- Odoo Implementation Cost CalculatorImplementation cost and timeline, in minutes
- Odoo Migration Cost CalculatorVersion jump or legacy ERP, priced in minutes
Continue reading
Odoo Tax Automation: Fiscal Positions, Tax Returns and E-Invoicing
Odoo tax automation in 19 and 20: fiscal positions, tax mapping, tax reports, VAT return checks, lock dates, closing entries and e-invoicing explained.
Odoo Accounting for CFOs in the GCC: VAT, E-Invoicing and Controls
Odoo accounting for CFOs in the GCC: UAE and Saudi VAT, ZATCA and UAE e-invoicing, AED and SAR multi-currency, lock dates and hashed audit controls.
Odoo Chile E-Invoicing: SII DTE Setup, CAF Folios and Boletas in 19/20
Odoo Chile e-invoicing for the SII: l10n_cl vs l10n_cl_edi editions, CAF folios, DTE setup, boletas, delivery guides and common rejections in 19/20.
