Salta al contingut principal
Colombia DIAN Electronic Equivalent POS Document Validator

Colombia DIAN Electronic Equivalent POS Document Validator: posada en marxa

Per posar en marxa Colombia DIAN Electronic Equivalent POS Document Validator, instal·la la versió que correspon al teu Odoo i omple a la fitxa de la companyia el NIT i la clau API. Després comprova que els teus documents quadren (total igual a subtotal més impost, sense imports negatius ni dates futures) i llança la validació per lots. La primera setmana, revisa els documents en Invalid i Validation Error i els resultats de validació en Fail o Warning.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Abans d'instal·lar: versió, preu i pantalles

El mòdul està publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0, amb una fitxa per versió. A Odoo Apps costa 9 € per versió d'Odoo (17.0, 18.0, 19.0 i 20.0), pagament únic i sense IVA; el servei local de FlexigoTech costa 29 €/mes o 290 €/any sense IVA (Pro: 58 €/mes o 580 €/any). Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció, però les dades es queden al teu Odoo. Si encara estàs valorant si t'encaixa, comença per què cobreix i què cal abans d'instal·lar-lo.

Un cop instal·lat, aquestes són les pantalles amb què treballaràs durant la posada en marxa:

Recorregut per la llista de documents DIAN amb el seu estat de validació, la llista de regles de validació, l'assistent de validació per lots i el formulari de la companyia
De la llista de documents a la fitxa de la companyia, passant per les regles i l'assistent de validació per lots

La llista de documents mostra número, companyia, tipus, data, client, import total i estat de validació. La llista de regles de validació apareix amb la columna Rule Name i el botó Nuevo.

La fitxa de la companyia: el primer que cal omplir

El formulari de la companyia té quatre blocs: informació, configuració de validació, configuració d'API i auditoria. Acabat d'instal·lar, el NIT i la clau API estan en blanc, i el temps d'espera ja porta un valor.

Formulari de la companyia My Company a DIAN Validation amb seccions d'informació, configuració de validació, configuració d'API i auditoria, amb el NIT i la clau API buits
La fitxa de la companyia acabada d'instal·lar, sense dades: NIT i clau API encara en blanc

Amb el NIT hi ha un control que convé conèixer abans d'escriure'l: el mòdul rebutja un NIT que no tingui exactament 11 dígits, amb el missatge NIT must be exactly 11 digits. Si et surt, revisa quants dígits hi has posat.

Passos per deixar-ho funcionant

Aquest és l'ordre en què ho faries, de la instal·lació a la primera validació:

  1. Instal·la el mòdul des de la fitxa de la versió que fa servir el teu Odoo (17.0, 18.0, 19.0 o 20.0).
  1. Obre el formulari de la companyia i omple el NIT amb exactament 11 dígits.
  1. Al bloc de configuració d'API, omple la clau API, que apareix buida després d'instal·lar.
  1. Repassa la configuració de validació i el temps d'espera, i desa.
  1. Abans de validar, revisa els teus documents: el total ha de ser el subtotal més l'impost, cap import no pot ser negatiu i la data del document no pot ser posterior a avui.
  1. Obre l'assistent Batch Document Validation, tria Company, Date From i Date To, ajusta els filtres de tipus i estat i prem Start Validation. L'assistent també té el botó Cancel.
  1. Torna a la llista de documents i mira l'estat de validació de cadascun.
  1. Consulta la llista de Validation Reports.
Assistent modal Batch Document Validation amb Company, Date From, Date To, el comptador de documents per validar a zero, els filtres All Types i Draft i els botons Start Validation i Cancel
L'assistent de validació per lots en una instal·lació sense registres: el comptador de documents per validar està a zero

Els estats de validació i els resultats

El camp validation_status, l'estat de validació que veus a la llista de documents, pot tenir aquests valors (codi i etiqueta tal com els defineix el mòdul):

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

A banda hi ha result_status, amb tres valors: pass (Pass), fail (Fail) i warning (Warning).

El mòdul té a més una segona llista d'opcions per a validation_status amb etiquetes més curtes i una opció més: all (All Statuses), draft (Draft), pending (Pending), validated (Validated), invalid (Invalid) i error (Error). Els codis coincideixen amb els de la primera llista; el que canvia és l'etiqueta, així que pending pot aparèixer com a Pending o com a Pending Validation, i error com a Error o com a Validation Error.

Fixa't en el codi i no només en l'etiqueta: error es mostra com a Validation Error o com a Error segons la llista.

Errors de la posada en marxa i com s'arreglen

Aquests són els missatges de validació que porta el mòdul i què fer amb cadascun:

  • Total amount ({document.total}) does not match subtotal ({document.subtotal}) + tax ({document.tax_amount}). Expected: {expected_total}. El total no és la suma del subtotal i l'impost. El mateix missatge et dona el total esperat: corregeix el total, el subtotal o l'impost fins que quadrin.
  • Total amount cannot be negative. Revisa l'import total del document i posa'l en positiu o a zero.
  • Subtotal cannot be negative. El mateix amb el subtotal.
  • Tax amount cannot be negative. El mateix amb l'import de l'impost.
  • Document date cannot be in the future. Canvia la data del document a avui o a un dia anterior.
  • NIT must be exactly 11 digits. Corregeix el NIT perquè tingui exactament 11 dígits.

Què revisar la primera setmana

Amb la fitxa de la companyia omplerta i una primera validació per lots feta, dedica uns minuts al dia a això:

  • Documents en Invalid o en Validation Error: obre'ls i mira si algun dels missatges d'abans explica el problema.
  • Resultats de validació amb result_status en Fail o en Warning: revisa'ls abans de donar per bons els documents afectats.
  • Documents que continuen en Draft o en Pending Validation: localitza'ls a la llista i decideix si cal incloure'ls a la propera validació per lots.
  • La llista de Validation Reports: repassa l'empresa, el tipus, les dates i qui ha generat cada informe.
Llista de Validation Reports del mòdul DIAN Validation amb cinc informes i columnes d'empresa, tipus, dates i generat per, amb els totals a zero
La llista d'informes de validació en una instal·lació sense documents: els totals apareixen a zero a totes les files

Com t'ajuda FlexigoTech

Pots consultar els detalls del mòdul a la pàgina del mòdul a flexigotech.com o a la seva fitxa d'Odoo Apps. Amb la subscripció, el mòdul per a les versions noves d'Odoo hi va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió d'Odoo es compra allà. Si a més necessites implantar Odoo 17, 18, 19 o 20, o una integració a mida que connecti aquest validador amb la resta dels teus processos, a FlexigoTech ens encarreguem de la implantació i desenvolupem connectors i integracions a mida.

Continua llegint

Com funciona per dins el validador de documents equivalents POS de la DIAN a OdooMenús, tasca programada cada hora, models i recorregut d'un document a Colombia DIAN Electronic Equivalent POS Document Validator per a Odoo.Colombia DIAN Electronic Equivalent POS Document Validator: si t'encaixa i en quina versió d'OdooQuè valida el mòdul DIAN de documents equivalents POS a Odoo 17 a 20, què no descriu la seva documentació, què cal preparar abans d'instal·lar-lo i com provar-lo.Com funciona Argentina ARCA Supplier Invoice Validation a Odoo per dinsGlossari de menús, tasques programades i dades del mòdul Argentina ARCA Supplier Invoice Validation and Withholding Management per a Odoo.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts