Melhoria no Projeto – Validação da Data de Vigência do NCM - NT N° 0272/2025

Resumo da Nota Técnica

Foi implementada uma melhoria no projeto denominado ‘ValidaDataVigenciaNCM10_4’, com o objetivo de validar a data de vigência dos códigos NCM vinculados aos produtos.

Detalhes da Nota Técnica

Aplicativo: ValidaDataVigenciaNCM10_4.exe
Tela: [1718] FACILITE – Valida Data de Vigência NCM
Formulário: FValidaDataVigenciaNCM

Melhorias Implementadas:
O layout da tela foi atualizado com base nas funcionalidades de cada botão. Foram adicionados ícones, hints (dicas de uso) e captions (legendas) mais descritivos para facilitar a usabilidade.
Além disso, foram incluídas duas novas funcionalidades importantes:
• Importação de planilha (CSV) para atualização em massa dos NCMs dos produtos;
• Atualização manual do NCM diretamente na tela, permitindo a digitação do novo código para cada produto individualmente.

Botões e Funcionalidades do Projeto:
Caption: Baixar e Atualizar Tabela IBPTax
Hint: Download da Tabela IBPTax e Atualização dos NCMs
Funcionalidade: Inicia o processo de atualização dos dados da tabela NCMIMPOSTOMETRO, realizando o download automático de arquivos CSV a partir de um link hospedado no S3 da AWS. Após o download, os arquivos são descompactados com o WinRAR e substituídos na pasta Impostometro do sistema Integrado. Em seguida, a tabela é atualizada no banco de dados.

Caption: Validar Vigência dos NCMs
Hint: Validar data de vigência dos NCMs dos produtos
Funcionalidade: Lista os produtos com NCMs fora da vigência no DBGrid. Exibe acima da barra de progresso a mensagem:
   o Vermelha (quando há produtos inválidos): “Foram encontrados %d produtos com NCM fora da vigência.”
   o Preto (quando todos estão válidos): “Todos os produtos estão com NCM dentro da vigência.”

Caption: Exportar Produtos Fora da Vigência
Hint: Exportar produtos fora da data de vigência para planilha Excel
Funcionalidade: Exporta os produtos listados no DBGrid para um arquivo .CSV. O usuário pode consultar os dados e preencher a nova coluna "Nº NCM válido" diretamente na planilha, que poderá ser utilizada posteriormente na funcionalidade de importação.

Caption: Atualizar NCM Informado na Tela
Hint: Atualiza NCM dos produtos conforme informado na tela
Funcionalidade: Permite atualizar diretamente o NCM do produto, preenchendo a coluna “Digite o Nº NCM válido” no DBGrid. A lógica utilizada é:
   o Se o NCM informado já existir na tabela CLASFIS, o produto será vinculado a ele.
   o Caso não exista, o sistema tentará cadastrá-lo com base nas informações da tabela NCMIMPOSTOMETRO.
   o Se o NCM informado não existir na tabela NCMIMPOSTOMETRO, ele será considerado inválido e a operação será cancelada.

Caption: Importar Planilha para Atualizar NCM
Hint: Importa planilha Excel e atualiza NCM dos produtos conforme informado
Funcionalidade: Permite importar o arquivo .CSV previamente exportado e preenchido pelo usuário. Ao selecionar o arquivo, o sistema processa os dados seguindo a mesma lógica da atualização manual:
   o Vincula o produto ao NCM se ele já existir na CLASFIS.
   o Se não existir, tenta cadastrá-lo com base na tabela NCMIMPOSTOMETRO.
   o Se o NCM não estiver na tabela NCMIMPOSTOMETRO, será considerado inválido e o vínculo será cancelado.

Outros Componentes do Projeto:
Botão com ícone de engrenagem:
Hint: Alterar o link de download da Tabela IBPTax
Funcionalidade: Permite alterar temporariamente o link utilizado para o download da tabela.

DBGrid central:
Exibe os produtos que estão com o NCM fora da data de vigência. Também é possível alterar os NCM's dos produtos utilizando a última coluna do Grid 'Digite o N° NCM Válido' e clicando no botão 'Atualizar NCM Informado na Tela'.

Barra de progresso inferior:
Acompanha dois rótulos (labels) que indicam o andamento de cada processo realizado no aplicativo.

Parâmetros Envolvidos

Sem parâmetros envolvidos.

» Nota Técnica