3.20.17.0

1. Informações Gerais da Versão

Produto: ILLI

Tag de homologação: 3.20.r13572

Versão de produção: 3.20.17.0

Release (branch): r13572

Data de Lançamento: A definir

Módulos impactados: Financeiro, Estoque, Produto, Venda, Sistema, Fiscal, Acesso, TEF

A homologação usa a tag; a produção passa a usar o número oficial 3.20.17.0 após a publicação.

2. Nota de Atualização (Resumo)

Versão de manutenção com forte peso de correção no PDV, estoque, cadastro de parceiros e produtos. Um dos eixos principais é a adequação ao CNPJ alfanumérico (Norma Técnica 2026.004), que aparece em vendas, MDF-e, busca de parceiros e cadastros. Também entram novas facilidades operacionais: filtro avançado em Produto, exportação em Excel/PDF no inventário, configuração de bloqueio por data de inventário e vínculo da captura de NF-e à entidade financeira. A conferência do diff no repositório do produto indicou alteração estrutural no banco (migrations), o que exige cuidado em base compartilhada — detalhado na seção 6.

3. Novidades nesta Versão

ILLI-3926 — Filtro avançado no cadastro de Produto: a listagem de Produto passa a oferecer filtro avançado por parâmetro e valor (incluindo código de barras e fornecedor), no mesmo padrão já disponível em Estoque > Pedido.
ILLI-3951 — Exportação da apuração de inventário: a tela de apuração de inventário ganha as opções separadas de exportar em Excel e em PDF, além da impressão já existente.
ILLI-3966 — Bloqueio de movimentação por data de inventário configurável: em filiais integradas ao LINX, é possível liberar por configuração as movimentações com data anterior ao último inventário finalizado, sem desligar outras regras de estoque.
ILLI-3883 — Captura de NF-e do pedido pela entidade financeira: nova configuração que prioriza a nota fiscal vinculada à entidade financeira quando ela é diferente da entidade de destino, ajustando o fluxo de recebimento em Estoque > Pedido > Receber.

4. Melhorias e Ajustes

ILLI-3935 — Importação de produtos tolerante a falhas: ao encontrar uma linha com erro, a importação passa a ignorar apenas essa linha, continua com as demais e gera um relatório com as falhas, em vez de interromper todo o arquivo.
ILLI-3946 — Campos fiscais na importação de produtos: a importação passa a aceitar e aplicar Origem do ICMS, Produto Brinde e Grupo Fiscal, campos que antes ficavam vazios e exigiam ajuste manual produto a produto.
ILLI-3938 — Árvore lateral redimensionável em Produto: a tela de Produto ganha divisor arrastável para redimensionar a árvore lateral, como já ocorre em Categoria do Produto.
ILLI-3922 — Descrição no parâmetro "Unidade padrão para pack": o parâmetro passa a exibir legenda explicando sua finalidade (unidade padrão de produto do tipo grade).
ILLI-3943 — Cupom de devolução no PDV: ajuste na quebra de linha do cupom de devolução, melhorando a apresentação da impressão.
ILLI-3949 — Norma Técnica 2026.004 (CNPJ alfanumérico): adequação do sistema aos schemas e ao cronograma da NT 2026.004, base do suporte ao CNPJ alfanumérico.
ILLI-3940 — Parâmetros no relatório de pedido (técnico): a função que gera o relatório de pedido passa a receber os parâmetros de movimentação de conferência e de fluxo. Ajuste interno, sem mudança visível ao usuário.
ILLI-3905 — Testes unitários da classe Util (técnico): ampliação e consolidação da suíte de testes unitários dos utilitários de formatação, filtros, datas, documentos e NF-e. Não há impacto visível ao usuário; melhora a estabilidade e a regressão.

5. Correções de Bugs

ILLI-3902 — Desconto acima do limite do parceiro após cancelar acréscimo (PDV)

O que acontecia: ao aplicar acréscimo, depois desconto e então cancelar o acréscimo, o desconto permanecia e permitia conceder mais desconto do que o limite do parceiro autorizava.
Por quê: o cancelamento de um ajuste não reavaliava os limites vinculados ao parceiro.
O que mudou: o sistema volta a respeitar o percentual do parceiro após o cancelamento do acréscimo.

ILLI-3950 — Total de desconto incorreto ao retomar caixa com campanha (PDV)

O que acontecia: com campanha de desconto em valor fixo, ao recarregar e retomar o caixa a promoção aparecia desativada, mas o total de desconto interno ficava negativo.
Por quê: a retomada do caixa não reconciliava o desconto de campanha com os indicadores da venda.
O que mudou: o total de desconto e o estado da campanha passam a ficar consistentes após retomar o caixa.

ILLI-3893 — Problemas na campanha no PDV

O que acontecia: falhas no funcionamento de campanhas promocionais no PDV.
Por quê: inconsistências no tratamento da campanha durante a venda.
O que mudou: o comportamento das campanhas no PDV foi corrigido.

ILLI-3927 — Lista de itens da venda volta ao topo (PDV)

O que acontecia: em vendas com muitos itens, ao rolar até o último item a lista não o fixava e voltava para o topo.
Por quê: falha de interferência visual na rolagem da lista de itens.
O que mudou: o último item permanece visível e a navegação na lista fica estável.

ILLI-3924 — Sincronização de venda virtual (PDV/retaguarda)

O que acontecia: a sincronização de venda virtual falhava e não concluía.
Por quê: o sistema chamava o fluxo de movimentação detalhe em vez do fluxo de orçamento.
O que mudou: a venda virtual passa a ser tratada pelo fluxo de orçamento e a sincronização conclui sem erro.

ILLI-3944 — NF-e de devolução não emitida na troca online (PDV local)

O que acontecia: com troca online e emissão de NF-e de devolução habilitadas, a troca era concluída e o cupom gerado, mas a NF-e de devolução não era emitida.
Por quê: o fluxo de devolução/troca não disparava a emissão fiscal.
O que mudou: após o cupom de troca, a NF-e de devolução passa a ser emitida automaticamente.

ILLI-3942 — Valor oculto no cancelamento de TEF

O que acontecia: ao cancelar um pagamento TEF e digitar o valor manualmente, o campo ficava restrito e o cliente não via o valor sendo digitado.
Por quê: o campo de valor no cancelamento não exibia o conteúdo informado.
O que mudou: o valor digitado passa a ficar visível durante o cancelamento.

ILLI-3961 — CNPJ alfanumérico rejeitado ao informar documento na venda (PDV)

O que acontecia: com CNPJ alfanumérico habilitado, informar o documento do cliente pelo atalho de CPF/CNPJ na venda rejeitava ou tratava incorretamente o valor.
Por quê: o campo não reconhecia letras como parte do CNPJ.
O que mudou: o PDV passa a aceitar e tratar corretamente o CNPJ alfanumérico nesse fluxo.

ILLI-3933 — Busca de parceiro por CNPJ alfanumérico

O que acontecia: com a máscara de CNPJ alfanumérico habilitada, a busca por CNPJ na listagem de parceiros não localizava os registros.
Por quê: o filtro não considerava os caracteres alfanuméricos.
O que mudou: a busca passa a encontrar parceiros com CNPJ alfanumérico.

ILLI-3960 — CPF/CNPJ na MDF-e não aceitavam CNPJ alfanumérico

O que acontecia: ao emitir ou editar uma MDF-e rodoviária, vários campos de CPF/CNPJ mantinham a máscara antiga e rejeitavam CNPJ alfanumérico válido.
Por quê: esses campos não haviam sido adequados à nova máscara.
O que mudou: os campos de CPF/CNPJ da MDF-e passam a tratar o CNPJ alfanumérico como o restante do sistema.

ILLI-3903 — Erro ao buscar parceiro com barra invertida

O que acontecia: ao digitar \ na pesquisa de parceiros, o sistema exibia erro inesperado (falha de sintaxe SQL) em vez de retornar a lista.
Por quê: o caractere não era tratado como texto literal na consulta.
O que mudou: a barra invertida passa a ser tratada como parte do termo buscado, sem erro.

O que acontecia: um usuário vinculado apenas a um módulo novo não conseguia logar, e o módulo criado por usuário comum não aparecia para o Master.
Por quê: o tratamento de permissões de módulos novos estava inconsistente.
O que mudou: o usuário do novo módulo consegue logar dentro das permissões e o módulo passa a aparecer para o Master.

ILLI-3918 — Imagens ignoradas na movimentação de estoque

O que acontecia: com o parâmetro de exibir imagens ativo, as fotos não apareciam na movimentação de estoque e, quando apareciam, não atualizavam ao trocar a imagem.
Por quê: a configuração não era respeitada na listagem da movimentação.
O que mudou: as imagens passam a respeitar a configuração e a refletir alterações de foto.

ILLI-3925 — Estorno falha com item incluído só no recebimento

O que acontecia: ao incluir um produto novo apenas no recebimento e depois tentar estornar, a operação não concluía e podia deixar a movimentação em estado intermediário.
Por quê: o estorno não tratava movimentações que misturam itens do pedido original com itens incluídos no recebimento.
O que mudou: o estorno passa a concluir de forma consistente nesses casos.

ILLI-3936 — Contagem de inventário por código de barras

O que acontecia: ao adicionar um produto na contagem pelo código de barras, o sistema informava que o produto não foi encontrado.
Por quê: a busca da contagem não reconhecia o código de barras do item.
O que mudou: o produto passa a ser localizado corretamente pelo código de barras na contagem.

ILLI-3937 — Crediário sem conta financeira no PDV

O que acontecia: o PDV finalizava vendas em crediário mesmo sem conta financeira associada à forma de pagamento, encerrando a venda sem gerar o título a receber.
Por quê: faltava validação da conta financeira antes de concluir a venda em crediário.
O que mudou: o PDV passa a bloquear o crediário sem conta financeira associada, garantindo a geração do financeiro.

ILLI-3939 — Salvar edição de função programável nativa

O que acontecia: ao editar o conteúdo de uma função programável nativa e salvar pela própria janela de edição, as alterações não eram persistidas; só gravavam pelo botão principal.
Por quê: o salvamento pela janela de edição não gravava o conteúdo.
O que mudou: o salvamento passa a funcionar também pela janela de edição.

ILLI-3941 — NCM não aparecem na consulta do produto

O que acontecia: ao consultar NCM no produto, alguns registros não apareciam na busca.
Por quê: a consulta não retornava parte dos NCM cadastrados.
O que mudou: a consulta de NCM passa a exibir os registros esperados.

ILLI-3934 — Erro de JavaScript ao carregar a tela inicial

O que acontecia: ao acessar a instância, o carregamento da tela inicial podia ser interrompido por um erro de decodificação no navegador.
Por quê: o script tentava decodificar em base64 um valor inválido, interrompendo a execução.
O que mudou: a tela inicial passa a carregar normalmente mesmo sem essa informação de atualização.

6. Base beta — homologação (mesmo banco)

Cenário: a loja usa dois sistemas no mesmo banco de dados — master/produção na versão estável e beta/homologação na versão em teste.

Homologação (beta): 3.20.r13572
Produção (master): 3.20.17.0 (ou versão estável anterior até publicar)

Conclusão (análise do diff git — r13572): exige validação cuidadosa — possível impacto estrutural no banco.

Esta release altera estrutura/migrations no banco compartilhado. Tratar como atualização conjunta (beta + master) ou homologar com restore/snapshot, comprovando que a produção na versão estável continua operando após aplicar a beta.

Evidências do diff master…origin/r13572:

81 arquivos alterados.
2 arquivos de migration/SQL no pacote: migrations/upgrade/default/274/01_imp_produto.sql e migrations/upgrade/default/276/01_configuracao.sql.
4 ocorrências de comandos DDL (ALTER/CREATE/DROP de tabela/coluna) no patch.

Ressalva operacional: rodar as migrations da beta em banco compartilhado pode quebrar a master se ela não souber ler o schema novo.

Smoke test na master após atualizar a beta: abrir PDV, fazer uma venda simples, pagamento e fechamento; na retaguarda, login, uma listagem e um fluxo financeiro. Se falhar, tratar como bloqueio à liberação.

7. Mudanças Importantes

Fiscal / CNPJ alfanumérico: validar em ambiente de teste as vendas, a MDF-e e os cadastros com CNPJ alfanumérico antes de operar (Norma Técnica 2026.004).
Troca online / NF-e de devolução: confirmar a emissão da NF-e de devolução em uma troca com troca online habilitada no PDV local.
Crediário no PDV: com a nova validação, revisar as formas de pagamento em crediário para que tenham conta financeira associada e continuem gerando título a receber.
Base compartilhada: esta versão inclui migrations; em base beta, confirmar se a master opera com apenas a beta atualizada ou se exige atualização conjunta (ver seção 6).

8. Documentação recomendada

Recomenda-se guia curto para as novidades de maior uso operacional: filtro avançado no cadastro de Produto (ILLI-3926), exportação em Excel/PDF na apuração de inventário (ILLI-3951) e a configuração de bloqueio por data de inventário para filiais LINX (ILLI-3966). As correções e ajustes fiscais não exigem guia dedicado além deste changelog.

9. Problemas Conhecidos

Não há problemas conhecidos comunicados para esta versão.

10. Tarefas Relacionadas à Versão

ILLI-3883 — Captura de NF-e do pedido vinculada à entidade financeira
ILLI-3893 — Correção de problemas em campanhas no PDV
ILLI-3902 — Desconto acima do limite do parceiro após cancelar acréscimo (PDV)
ILLI-3903 — Erro ao buscar parceiro por nome com barra invertida
ILLI-3905 — Testes unitários da classe Util (técnico)
ILLI-3911 — Login falha com módulo novo e módulo não aparece para o Master
ILLI-3918 — Imagens ignoradas na movimentação de estoque
ILLI-3922 — Descrição explicativa no parâmetro "Unidade padrão para pack"
ILLI-3924 — Erro ao sincronizar venda virtual (fluxo de orçamento)
ILLI-3925 — Estorno falha com item incluído só no recebimento
ILLI-3926 — Filtro avançado por código de barras e fornecedor no cadastro de Produto
ILLI-3927 — Lista de itens da venda volta ao topo no PDV
ILLI-3933 — Busca de parceiro por CNPJ alfanumérico
ILLI-3934 — Erro de JavaScript ao carregar a tela inicial
ILLI-3935 — Importação de produtos continua com relatório de falhas
ILLI-3936 — Contagem de inventário por código de barras
ILLI-3937 — Bloquear crediário sem conta financeira no PDV
ILLI-3938 — Redimensionar a árvore lateral na tela de Produto
ILLI-3939 — Salvar edição de função programável nativa pela janela de edição
ILLI-3940 — Novos parâmetros no relatório de pedido (técnico)
ILLI-3941 — NCM que não apareciam na consulta do produto
ILLI-3942 — Valor oculto no cancelamento de TEF
ILLI-3943 — Quebra de linha no cupom de devolução do PDV
ILLI-3944 — NF-e de devolução não emitida na troca online (PDV local)
ILLI-3946 — Campos fiscais faltantes na importação de produto
ILLI-3949 — Norma Técnica 2026.004 — CNPJ alfanumérico
ILLI-3950 — Total de desconto incorreto ao retomar caixa com campanha
ILLI-3951 — Exportação em Excel e PDF na apuração de inventário
ILLI-3960 — CPF/CNPJ na MDF-e não aceitavam CNPJ alfanumérico
ILLI-3961 — CNPJ alfanumérico rejeitado ao informar documento na venda (PDV)
ILLI-3966 — Configurar bloqueio de movimentação com data anterior ao último inventário