Saltar para o conteúdo principal
Colombia DIAN Electronic Equivalent POS Document Validator

Como funciona por dentro o validador de documentos equivalentes POS da DIAN no Odoo

O módulo acrescenta ao Odoo um menu DIAN Validation com quatro secções (configuração, documentos, validação e relatórios) e uma ação agendada, Auto-validate DIAN POS Documents, que corre de hora a hora e fica ativa logo na instalação. Por dentro trabalha com seis modelos: configuração, documento, regra, resultado, relatório e um assistente de validação em lote. Aqui percorre-o pela ordem em que aparece no menu, da configuração inicial ao relatório.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

O que se vê no Odoo logo após a instalação

O Colombia DIAN Electronic Equivalent POS Document Validator apresenta-se na sua página do Odoo Apps com um título claro: Validate DIAN POS documents in Odoo. Depois de instalado, surge uma nova entrada na barra de aplicações, DIAN Validation, e por baixo dela quatro menus:

  • DIAN Validation › Configuration, com o submenu Configuration.
  • DIAN Validation › Documents, com o submenu Documents.
  • DIAN Validation › Validation, com dois submenus: Validation Rules e Validation Results.
  • DIAN Validation › Reports, com o submenu Reports.

Não há mais menus além destes. Tudo o que o módulo faz está dentro dessa entrada, por isso, se procura alguma parte dele, comece por aí.

Percurso pelo módulo DIAN Validation: lista de documentos, lista de regras, assistente de validação em lote e formulário de configuração da empresa
Os quatro ecrãs em sequência: a lista de documentos DIAN, as regras de validação, o assistente «Batch Document Validation» e o formulário da empresa My Company com secções de informação, definições de validação, configuração de API e auditoria (NIT e chave API ainda em branco)

A linha temporal, pela ordem do menu

Esta cronologia segue a ordem em que o módulo dispõe os menus e coloca a ação agendada no seu lugar. Não é um procedimento obrigatório: é a forma mais direta de perceber que peça existe em cada ponto.

  1. Na instalação Aparece o menu DIAN Validation e fica criada a ação agendada Auto-validate DIAN POS Documents, com frequência de uma hora e ativa desde o início.
  1. Configuração Em DIAN Validation › Configuration › Configuration encontra a configuração do módulo, guardada no modelo dian_pos.config (DIAN POS Configuration). O último passo do percurso animado mostra esse formulário para uma empresa.
  1. Documentos Em DIAN Validation › Documents › Documents tem a lista de documentos, que o módulo guarda no modelo dian_pos.document (DIAN POS Document).
  1. Regras Em DIAN Validation › Validation › Validation Rules estão as regras de validação, no modelo dian_pos.validation_rule (POS Document Validation Rule).
  1. De hora a hora É executada a ação Auto-validate DIAN POS Documents.
  1. Validação em lote O módulo inclui um assistente, o modelo dian_pos.batch_validation_wizard (Batch Validation Wizard), que abre como diálogo sobre o ecrã.
  1. Resultados Em DIAN Validation › Validation › Validation Results consultam-se os resultados, guardados no modelo dian_pos.validation_result (POS Document Validation Result).
  1. Relatórios Em DIAN Validation › Reports › Reports está o relatório, do modelo dian_pos.document_report (POS Document Validation Report).

A lista de documentos e os seus estados

O ecrã de documentos é o centro do módulo: é onde vai parar quando entra para ver o que tem. Na captura, com dez registos de exemplo, veem-se as colunas de número, empresa, tipo, data, cliente, montante total e estado de validação.

Lista de documentos DIAN no Odoo com colunas de número, empresa, tipo, data, cliente, montante total e estado de validação
A lista de documentos com dez registos, cada um com o seu estado de validação (rascunho, pendente, validado ou erro) e o total no rodapé

Se quiser o detalhe de que campos preencher e o que verificar quando um documento não avança, encontra-o na colocação em funcionamento do módulo.

As regras de validação, à vista

As regras têm o seu próprio menu e o seu próprio modelo, separadas dos documentos e dos resultados. Na captura vê-se a lista com dez regras na coluna Rule Name, o botão para criar uma nova, a barra de pesquisa e a paginação.

Lista de regras de validação do módulo DIAN Validation com a coluna Rule Name, botão Novo, pesquisa e paginação
As regras de validação do módulo: dez linhas na coluna Rule Name, com o botão Novo e a barra de pesquisa

A ação agendada que corre de hora a hora

O módulo traz uma ação agendada: Auto-validate DIAN POS Documents. Corre de hora a hora e vem ativa. Se na sua implementação quiser verificar quando é executada ou pausá-la, procure-a por esse nome exato.

O assistente de validação em lote

Além da ação automática, o módulo tem um assistente, Batch Validation Wizard, que abre num diálogo com o título Batch Document Validation. Na captura veem-se os critérios de seleção (Company, Date From, Date To e o contador Documents to validate), os filtros de documento (All Types e Draft) e os botões Start Validation e Cancel.

Assistente modal Batch Document Validation com critérios de empresa e datas, filtros de tipo e estado, e botões Start Validation e Cancel
O assistente de validação em lote num ecrã sem registos: o contador de documentos a validar ainda está a zero

Os modelos por baixo, para consultores

Se vai mexer em vistas, permissões de acesso ou relatórios, estes são os nomes técnicos com que o módulo trabalha:

  • dian_pos.config: DIAN POS Configuration.
  • dian_pos.document: DIAN POS Document.
  • dian_pos.validation_rule: POS Document Validation Rule.
  • dian_pos.validation_result: POS Document Validation Result.
  • dian_pos.document_report: POS Document Validation Report.
  • dian_pos.batch_validation_wizard: Batch Validation Wizard.

Serviço externo, versões e preço

A página avisa antes da compra: Before you buy: some features of this app use a paid external service. Neste módulo, esse serviço é o serviço local da FlexigoTech Cloud. Sem subscrição, ou com o serviço suspenso, para aquilo que a subscrição proporciona, e os dados ficam no seu Odoo. A página inclui também uma secção Privacy policy.

Está publicado no Odoo Apps para Odoo 17, 18, 19 e 20. A app custa 9 € por versão do Odoo, pagamento único e sem IVA, para 17, 18, 19 e 20; o serviço local custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá, na página do Odoo Apps.

Se ainda está a avaliar se lhe serve, tem os critérios em se o módulo se adequa à sua empresa.

Como a FlexigoTech pode ajudar

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se precisar de encaixar este validador no seu ponto de venda, adaptar os seus relatórios ou ligá-lo a outro sistema, podemos fazê-lo dentro do seu próprio Odoo.

Continue a ler

Colombia DIAN Electronic Equivalent POS Document Validator: pôr a funcionarComo pôr a funcionar o validador DIAN de documento equivalente POS no Odoo: definições da empresa, estados, erros e o que rever na primeira semana.Colombia DIAN Electronic Equivalent POS Document Validator: se serve e em que versão do OdooO que valida o módulo DIAN de documentos equivalentes POS no Odoo 17 a 20, o que a documentação não descreve, o que preparar antes de instalar e como testar.Como funciona por dentro o Argentina ARCA Supplier Invoice Validation no OdooGlossário de menus, ações agendadas e dados do módulo Argentina ARCA Supplier Invoice Validation and Withholding Management para Odoo.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes