Skip to main content
Colombia DIAN Electronic Equivalent POS Document Validator

Colombia DIAN Electronic Equivalent POS Document Validator: getting it running

To get Colombia DIAN Electronic Equivalent POS Document Validator running, install the version that matches your Odoo and fill in the NIT and API key on the company form. Then check that your documents add up (total equal to subtotal plus tax, no negative amounts and no future dates) and run the batch validation. In the first week, review documents in Invalid and Validation Error and validation results in Fail or Warning.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 4 November 2026

Key facts

Versions
Odoo 17, 18, 19 and 20
Checked
in the module's source code, version 20.0 · against the sources linked at the end
Reading time
5 min

Before installing: version, price and screens

The module is published on Odoo Apps for 17.0, 18.0, 19.0 and 20.0, with one listing per version. On Odoo Apps it costs €9 per Odoo version (17.0, 18.0, 19.0 and 20.0), a one-off payment excluding VAT; the FlexigoTech local service costs €29/month or €290/year excluding VAT (Pro: €58/month or €580/year). Without a subscription, or with the service suspended, whatever the subscription provides stops, but your data stays in your Odoo. If you are still weighing up whether it fits, start with what it covers and what you need before installing.

Once installed, these are the screens you will work with during setup:

Walkthrough of the DIAN document list with its validation status, the validation rules list, the batch validation wizard and the company form
From the document list to the company form, by way of the rules and the batch validation wizard

The document list shows number, company, type, date, customer, total amount and validation status. The validation rules list appears with its Rule Name column and the Nuevo button.

The company form: the first thing to fill in

The company form has four blocks: information, validation settings, API configuration and audit. Straight after installation, the NIT and the API key are blank, and the timeout already has a value.

Company form for My Company in DIAN Validation with information, validation settings, API configuration and audit sections, with NIT and API key empty
The company form just after installation, with no data yet: NIT and API key still blank

There is one check on the NIT worth knowing before you type it: the module rejects a NIT that does not have exactly 11 digits, with the message NIT must be exactly 11 digits. If you see it, count the digits you have entered.

Steps to get it working

This is the order you would follow, from installation to the first validation:

  1. Install the module from the listing for the version your Odoo runs (17.0, 18.0, 19.0 or 20.0).
  1. Open the company form and fill in the NIT with exactly 11 digits.
  1. In the API configuration block, fill in the API key, which is empty after installation.
  1. Go over the validation settings and the timeout, then save.
  1. Before validating, check your documents: the total must be the subtotal plus the tax, no amount can be negative and the document date cannot be later than today.
  1. Open the Batch Document Validation wizard, choose Company, Date From and Date To, set the type and status filters and click Start Validation. The wizard also has a Cancel button.
  1. Go back to the document list and look at the validation status of each document.
  1. Check the Validation Reports list.
Batch Document Validation modal wizard with Company, Date From, Date To, the documents to validate counter at zero, the All Types and Draft filters and the Start Validation and Cancel buttons
The batch validation wizard on an installation with no records: the documents to validate counter is at zero

Validation statuses and results

The validation_status field, the validation status you see in the document list, can take these values (code and label as the module defines them):

  • draft: Draft
  • pending: Pending Validation
  • validated: Validated
  • invalid: Invalid
  • error: Validation Error

Separately there is result_status, with three values: pass (Pass), fail (Fail) and warning (Warning).

The module also has a second set of options for validation_status, with shorter labels and one extra option: all (All Statuses), draft (Draft), pending (Pending), validated (Validated), invalid (Invalid) and error (Error). The codes match those in the first set; only the label changes, so pending can appear as Pending or Pending Validation, and error as Error or Validation Error.

Look at the code, not just the label: error is shown as Validation Error or as Error depending on the list.

Setup errors and how to fix them

These are the validation messages the module includes and what to do about each one:

  • Total amount ({document.total}) does not match subtotal ({document.subtotal}) + tax ({document.tax_amount}). Expected: {expected_total}. The total is not the sum of subtotal and tax. The message itself gives you the expected total: correct the total, subtotal or tax until they match.
  • Total amount cannot be negative. Check the document's total amount and make it positive or zero.
  • Subtotal cannot be negative. The same for the subtotal.
  • Tax amount cannot be negative. The same for the tax amount.
  • Document date cannot be in the future. Change the document date to today or an earlier day.
  • NIT must be exactly 11 digits. Correct the NIT so it has exactly 11 digits.

What to check in the first week

With the company form filled in and a first batch validation done, spend a few minutes a day on this:

  • Documents in Invalid or Validation Error: open them and see whether one of the messages above explains the problem.
  • Validation results with result_status set to Fail or Warning: review them before treating the documents concerned as fine.
  • Documents still in Draft or Pending Validation: find them in the list and decide whether they should go into the next batch validation.
  • The Validation Reports list: go over the company, type, dates and who generated each report.
Validation Reports list in the DIAN Validation module with five reports and columns for company, type, dates and generated by, with totals at zero
The validation reports list on an installation with no documents: totals show zero on every row

How FlexigoTech can help

You can read the module's details on the module page at flexigotech.com or on its Odoo Apps listing. With the subscription, the module for new Odoo versions is included if you bought it at flexigotech.com; on the Odoo App Store, each Odoo version is bought there. If you also need Odoo 17, 18, 19 or 20 implemented, or a bespoke integration linking this validator to the rest of your processes, FlexigoTech handles the implementation and builds connectors and bespoke integrations.

Keep reading

How the DIAN equivalent POS document validator works inside OdooMenus, hourly scheduled action, models and the path a document follows in Colombia DIAN Electronic Equivalent POS Document Validator for Odoo.Colombia DIAN Electronic Equivalent POS Document Validator: does it fit, and on which Odoo version?What the DIAN equivalent POS document module validates in Odoo 17 to 20, what its documentation leaves out, what to prepare before installing and how to test it.How Argentina ARCA Supplier Invoice Validation works inside OdooGlossary of the menus, scheduled actions and data of the Argentina ARCA Supplier Invoice Validation and Withholding Management module for Odoo.
Checked in the module's source code (version 20.0) and the linked sources

Sources