3.20.17.0
Resumo: 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 fortefoco pesoem de correçãocorreções no PDV, estoque, cadastro de parceirosestoque e produtos.cadastro, Umalém dos eixos principais é ada adequação ao CNPJ alfanumérico (Norma Técnica 2026.004), que aparece em vendas, MDF-e, buscae de parceirosnovas opções de filtro, exportação e cadastros. Também entram novas facilidades operacionais: filtro avançado em Produto, exportação em Excel/PDFconfiguração no inventário,dia configuraçãoa de bloqueio por data de inventário e vínculodia 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.loja.
3.
🚀 Novidades nesta Versão
ILLI-3926Novo — Filtrofiltro avançado no cadastro de Produto:Produto, apermitindo listagem de Produto passa a oferecer filtro avançadopesquisar por parâmetro e valor (incluindo código de barras e fornecedor),por nofornecedor, mesmo padrãocomo já disponívelexiste nos pedidos.
Exportação em
EstoqueExcel >e Pedido.em ILLI-3951PDF — Exportação da apuração de inventário: ana tela de apuração de
inventárioinventário, ganhapara as opções separadas de exportar em Excelconferir e
emarquivar PDF,a alémcontagem dafora impressãodo já existente.sistema.
ILLI-3966 — Bloqueio de movimentação por data de inventário configurável: em filiais integradas ao LINX, é possível liberar porNova configuração aspara liberar movimentações com data anterior ao último inventário finalizado,em lojas integradas ao LINX, sem desligar outrasas demais regras de estoque.
ILLI-3883A —captura Captura de NF-e do pedido pela entidade financeira: nova configuração que prioriza ada nota fiscal dos pedidos passa a poder ser vinculada à entidade financeirafinanceira, quando elaessa éfor diferente da entidade de destino, ajustando o fluxo de recebimento em Estoque > Pedido > Receber.destino.
4.
⚙️ Melhorias e Ajustes
ILLI-3935 — Importação de produtos tolerantepassa a falhas:seguir aomesmo encontrarquando uma linha comtem erro, a importação passa a ignorar apenas essa linha, continua comerro: as demais são processadas e gerao sistema apresenta um relatório com as falhas,falhas emencontradas.
vezImportação de
interromperprodutos todoagora otambém arquivo.preenche ILLI-3946os — Camposcampos 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 exigiamevitando ajuste manual
produtodepois ada produto.carga.
ILLI-3938A — Árvoreárvore lateral redimensionável em Produto: ada tela de Produto ganhaagora divisorpode arrastávelser para redimensionar a árvore lateral,redimensionada, como já ocorreacontece em Categoria do Produto.
ILLI-3922 — Descrição noO parâmetro "Unidade padrão para pack": oganhou parâmetrouma passa a exibir legendadescrição explicando suapara finalidadeque (unidade padrão de produto do tipo grade).serve.
ILLI-3943 — Cupom de devolução no PDV: ajusteAjuste na quebra de linha do cupom de devolução,devolução no PDV, melhorando a apresentação da impressão.
ILLI-3949Adequação —à Norma Técnica 2026.004004, (CNPJpreparando alfanumérico): adequação doo sistema aospara schemaso e ao cronograma da NT 2026.004, baseuso do suporte ao CNPJ alfanumérico.
⚠️ Atenções
ILLI-3940Esta —versão Parâmetrostem novárias relatóriomudanças fiscais (CNPJ alfanumérico em vendas, MDF-e e cadastros; emissão de pedidoNF-e (técnico):de adevolução funçãona quetroca geraonline). Após atualizar, valide uma venda, uma troca com devolução e uma emissão fiscal antes de operar normalmente.
No PDV com crediário, o
relatório de pedidosistema passa a
receberexigir conta financeira associada à forma de pagamento; confira as formas de pagamento em crediário para que 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; melhoratítulos a
estabilidadereceber econtinuem asendo regressão.gerados.
5.
🐞 Correções de Bugs
ILLI-3902 — Desconto acima do limite do parceiro após cancelar acréscimo (PDV)
OCorrigido desconto que acontecia: ao aplicar acréscimo, depois desconto e então cancelar o acréscimo, o desconto permanecia e permitia conceder mais desconto do queultrapassava o limite do parceiro autorizava.quando um acréscimo era aplicado e depois cancelado no PDV.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, masCorrigido o total de desconto
internoque ficava
negativo.incorreto 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ósao retomar o
caixa.caixa com ILLI-3893 — Problemas nauma campanha nopromocional PDV
em andamento.
OCorrigidos que acontecia: falhasproblemas no funcionamento de campanhas promocionais no PDV.
Por quê: inconsistências no tratamento da campanha duranteCorrigida a venda.
O que mudou: o comportamento das campanhas no PDV foi corrigido.
ILLI-3927 — Listalista de itens da venda voltaque voltava 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.item.
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:Corrigida a sincronização de
vendavendas virtualvirtuais entre PDV e retaguarda, que falhava
eao não concluía.
Por quê: o sistema chamavaseguir o fluxo
de movimentação detalhe em vez do fluxo de orçamento.errado.
O que mudou:Corrigida a vendaemissão virtual passa a ser tratada pelo fluxo de orçamento e a sincronização conclui sem erro.
ILLI-3944 —da NF-e de devolução nãoem emitidatrocas nacom a troca online (habilitada no 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.local.
Por quê:Corrigido 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
pagamento TEF, Oem 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
passamanualmente aficava ficaroculto visível durantepara o
cancelamento.operador.
Corrigido ILLI-3961 —o CNPJ alfanumérico que era rejeitado ao informar documento na venda (PDV)
O que acontecia: com CNPJ alfanumérico habilitado, informar o documento do cliente
pelona atalhovenda.
Corrigida a busca 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 parceiroparceiros por CNPJ alfanumérico
Oalfanumérico, 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:Corrigidos os campos de CPF/CNPJ
dana MDF-
e, que não aceitavam CNPJ alfanumérico.
Corrigido o erro ao pesquisar parceiro por nome quando o texto continha barra invertida.
Corrigido o login 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 pesquisaexibição 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.
ILLI-3911 — Login e módulos de acesso recém-criados
criados,
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 apareciainclusive para o
usuário Master.
PorCorrigida quê:a o tratamento de permissões de módulos novos estava inconsistente.
O que mudou: o usuário do novo módulo consegue logar dentroexibição das
permissõesimagens edos o módulo passa a aparecer para o Master.
ILLI-3918 — Imagens ignoradasprodutos na movimentação de estoque
estoque, agora 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 respeitarrespeitando a configuração e
arefletindo refletir alteraçõestrocas de foto.
Corrigido ILLI-3925o —estorno Estornode falharecebimento comquando havia 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 itensmomento do
pedido original com itens incluídos no recebimento.
O que mudou: o estorno passaCorrigida a concluir de forma consistente nesses casos.
ILLI-3936 — Contagemcontagem de inventário por código de barras
Obarras, 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 reconheciaCorrigido o códigocadastro de barras do item.
O que mudou: o produto passa a ser localizado corretamente pelo código de barras na contagem.
ILLI-3937 — Crediáriocrediário sem conta financeira no PDV
Ofinanceira, que acontecia: o PDV finalizava vendas em crediário mesmo sem conta financeira associada à forma de pagamento, encerrandoencerrava 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:Corrigido o
PDVsalvamento passadas afunções bloquearprogramáveis 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:nativas 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.edição.
PorCorrigida quê:a o salvamento pela janelaconsulta de ediçãoNCM, não gravava o conteúdo.
Oem 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.busca do produto.
PorCorrigido quê:o a consulta não retornava parte dos NCM cadastrados.
O que mudou: a consultaerro 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 interrompidocausado por
um errofalha de
decodificaçãoleitura 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
