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

Colombia DIAN Electronic Equivalent POS Document Validator: pôr a funcionar

Para pôr a funcionar o Colombia DIAN Electronic Equivalent POS Document Validator, instale a versão que corresponde ao seu Odoo e preencha na ficha da empresa o NIT e a chave API. Depois confirme que os seus documentos batem certo (total igual a subtotal mais imposto, sem valores negativos nem datas futuras) e execute a validação em lote. Na primeira semana, reveja os documentos em Invalid e Validation Error e os resultados de validação em Fail ou Warning.

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

Antes de instalar: versão, preço e ecrãs

O módulo está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0, com uma ficha por versão. No Odoo Apps custa 9 € por versão do Odoo (17.0, 18.0, 19.0 e 20.0), pagamento único e sem IVA; o serviço local da FlexigoTech custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Sem subscrição, ou com o serviço suspenso, para aquilo que a subscrição oferece, mas os dados ficam no seu Odoo. Se ainda está a avaliar se lhe serve, comece por o que cobre e o que é preciso antes de o instalar.

Depois de instalado, estes são os ecrãs com que vai trabalhar durante a configuração:

Percurso pela lista de documentos DIAN com o respetivo estado de validação, a lista de regras de validação, o assistente de validação em lote e o formulário da empresa
Da lista de documentos à ficha da empresa, passando pelas regras e pelo assistente de validação em lote

A lista de documentos mostra número, empresa, tipo, data, cliente, valor total e estado de validação. A lista de regras de validação aparece com a coluna Rule Name e o botão Nuevo.

A ficha da empresa: a primeira coisa a preencher

O formulário da empresa tem quatro blocos: informação, definições de validação, configuração de API e auditoria. Logo após a instalação, o NIT e a chave API estão em branco, e o tempo de espera já traz um valor.

Formulário da empresa My Company em DIAN Validation com secções de informação, definições de validação, configuração de API e auditoria, com o NIT e a chave API vazios
A ficha da empresa acabada de instalar, sem dados: NIT e chave API ainda em branco

No NIT há um controlo que convém conhecer antes de o escrever: o módulo rejeita um NIT que não tenha exatamente 11 dígitos, com a mensagem NIT must be exactly 11 digits. Se lhe aparecer, verifique quantos dígitos introduziu.

Passos para o pôr a funcionar

Esta é a ordem a seguir, da instalação à primeira validação:

  1. Instale o módulo a partir da ficha da versão que o seu Odoo usa (17.0, 18.0, 19.0 ou 20.0).
  1. Abra o formulário da empresa e preencha o NIT com exatamente 11 dígitos.
  1. No bloco de configuração de API, preencha a chave API, que aparece vazia após a instalação.
  1. Reveja as definições de validação e o tempo de espera, e guarde.
  1. Antes de validar, reveja os seus documentos: o total tem de ser o subtotal mais o imposto, nenhum valor pode ser negativo e a data do documento não pode ser posterior a hoje.
  1. Abra o assistente Batch Document Validation, escolha Company, Date From e Date To, ajuste os filtros de tipo e estado e clique em Start Validation. O assistente tem também o botão Cancel.
  1. Volte à lista de documentos e veja o estado de validação de cada um.
  1. Consulte a lista de Validation Reports.
Assistente modal Batch Document Validation com Company, Date From, Date To, o contador de documentos a validar a zero, os filtros All Types e Draft e os botões Start Validation e Cancel
O assistente de validação em lote numa instalação sem registos: o contador de documentos a validar está a zero

Os estados de validação e os resultados

O campo validation_status, o estado de validação que vê na lista de documentos, pode ter estes valores (código e etiqueta tal como o módulo os define):

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

À parte existe result_status, com três valores: pass (Pass), fail (Fail) e warning (Warning).

O módulo tem ainda uma segunda lista de opções para validation_status, com etiquetas mais curtas e uma opção a mais: all (All Statuses), draft (Draft), pending (Pending), validated (Validated), invalid (Invalid) e error (Error). Os códigos coincidem com os da primeira lista; o que muda é a etiqueta, por isso pending pode aparecer como Pending ou como Pending Validation, e error como Error ou como Validation Error.

Olhe para o código e não só para a etiqueta: error aparece como Validation Error ou como Error consoante a lista.

Erros da configuração e como se resolvem

Estas são as mensagens de validação que o módulo inclui e o que fazer com cada uma:

  • Total amount ({document.total}) does not match subtotal ({document.subtotal}) + tax ({document.tax_amount}). Expected: {expected_total}. O total não é a soma do subtotal e do imposto. A própria mensagem indica o total esperado: corrija o total, o subtotal ou o imposto até baterem certo.
  • Total amount cannot be negative. Reveja o valor total do documento e coloque-o positivo ou a zero.
  • Subtotal cannot be negative. O mesmo para o subtotal.
  • Tax amount cannot be negative. O mesmo para o valor do imposto.
  • Document date cannot be in the future. Altere a data do documento para hoje ou para um dia anterior.
  • NIT must be exactly 11 digits. Corrija o NIT para que tenha exatamente 11 dígitos.

O que rever na primeira semana

Com a ficha da empresa preenchida e uma primeira validação em lote feita, dedique uns minutos por dia a isto:

  • Documentos em Invalid ou em Validation Error: abra-os e veja se alguma das mensagens acima explica o problema.
  • Resultados de validação com result_status em Fail ou em Warning: reveja-os antes de dar como bons os documentos afetados.
  • Documentos que continuam em Draft ou em Pending Validation: localize-os na lista e decida se devem entrar na próxima validação em lote.
  • A lista de Validation Reports: reveja a empresa, o tipo, as datas e quem gerou cada relatório.
Lista de Validation Reports do módulo DIAN Validation com cinco relatórios e colunas de empresa, tipo, datas e gerado por, com os totais a zero
A lista de relatórios de validação numa instalação sem documentos: os totais aparecem a zero em todas as linhas

Como a FlexigoTech o ajuda

Pode consultar os detalhes do módulo em a página do módulo em flexigotech.com ou na sua ficha do Odoo Apps. Com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; no Odoo App Store, cada versão do Odoo compra-se lá. Se precisar também de implementar o Odoo 17, 18, 19 ou 20, ou de uma integração à medida que ligue este validador ao resto dos seus processos, na FlexigoTech tratamos da implementação e desenvolvemos conectores e integrações à medida.

Continue a ler

Como funciona por dentro o validador de documentos equivalentes POS da DIAN no OdooMenus, ação agendada de hora a hora, modelos e percurso de um documento no Colombia DIAN Electronic Equivalent POS Document Validator para Odoo.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