Julho/2026

3.20.16.5
3.20.16.6
3.20.17.0
3.20.17.1
3.20.18.0
3.20.19.1
3.20.21.0
3.20.21.1

3.20.16.5

Data: 02/07/2026

Identificação da versão:

Homologação: 3.20.r13674.0
Produção: 3.20.16.5

Resumo: Melhorias no PDV para respeitar valor mínimo e menu rápido de pagamento, remoção do módulo SQL Query do retaguarda e correção do relatório completo de situação de estoque.

⚙️ Melhorias

No PDV, formas e condições de pagamento passam a aparecer somente quando o valor da venda atende ao mínimo cadastrado na retaguarda.
Com regra de valor mínimo por parcela, o sistema considera o total da venda multiplicando o mínimo pelo número de parcelas da condição.
Formas desabilitadas no Menu Rápido de Pagamento deixam de ser exibidas na confirmação de pagamento do caixa.
No cadastro de Forma de Pagamento, o campo Valor Limite Venda passa a aceitar valores decimais em reais ou percentual.

🐞 Correções

Removido o módulo SQL Query do retaguarda — a ferramenta não fica mais disponível no menu nem por acesso direto.
Corrigido o Relatório de Situação do Estoque Completo, que falhava ao gerar a consulta por vínculo incorreto entre produto e grade.

3.20.16.6

1. Informações Gerais da Versão

Produto: ILLI
Tag homologação: 3.20.r13641.1
Versão produção: 3.20.16.6
Release: r13641
Data de Lançamento: 02/07/2026
Módulos impactados: Venda, Produto

Versões corrigidas (Jira): r13641 - 3.20.16.6

Conferência no git (produto):

Branch r13641 encontrada (commit 22aecff6b59d).
Homologação: tag git beta-3.20.r13641.1 (padrão beta-3.20.r13641.*).
Produção: 3.20.16.6 (Jira) — tag de release oficial ainda pendente no git.

2. Nota de Atualização (Resumo)

Release com cinco correções em PDV (NFC-e em contingência e filial no cadastro de cliente), cadastro de produto (canal de venda e migration de tipo Grade legado) e consulta de complementos. O diff inclui migration de dados no banco; tratar como atualização conjunta ou homologar com snapshot em base beta compartilhada.

3. Novidades nesta Versão

Sem funcionalidades novas. Foco em correções e regularização de dados legados.

4. Melhorias e Ajustes

Não há melhorias adicionais a destacar nesta versão.

5. Correções de Bugs

PDV — cancelamento automático com duas NFC-e autorizadas (ILLI-3974)

O que acontecia: em venda com contingência NFC-e, quando a transmissão normal falhava e uma segunda nota era emitida e autorizada, a mesma movimentação podia ficar com duas NFC-e autorizadas. Com Habilitar Cancelamento Automático ativo, o serviço agendado não cancelava a duplicada nem gerava devolução fora do prazo.
Por quê: o fluxo de cancelamento automático não contemplava o cenário de múltiplos documentos fiscais autorizados na mesma movimentação de venda do PDV após contingência.
O que mudou: ao detectar mais de uma NFC-e autorizada na mesma venda, o sistema trata a duplicidade automaticamente — cancela a nota excedente dentro do prazo ou emite Devolução por Cancelamento Fora do Prazo quando o cancelamento não é mais permitido na SEFAZ.

PDV — filial no cadastro de cliente (ILLI-3989)

O que acontecia: ao cadastrar cliente durante a venda no PDV, o campo Filial era preenchido e gravado com a entidade principal do usuário, mesmo quando o caixa estava aberto em outra loja.
Por quê: o cadastro de cliente no PDV usava a entidade principal do operador em vez da entidade vinculada à conta PDV da sessão corrente.
O que mudou: a filial do novo cliente passa a refletir a entidade da conta PDV em uso na abertura do caixa, garantindo rastreabilidade correta por loja.

Produto — aba Canal de Venda (ILLI-3984)

O que acontecia: na aba Canal de Venda do cadastro de produto, o fluxo de consulta, inclusão, alteração ou remoção de canais vinculados à grade/entidade não concluía corretamente — a operação não persistia ou a tela não refletia o resultado.
Por quê: falha no funcionamento da funcionalidade de canal de venda no cadastro de produto.
O que mudou: a aba Canal de Venda volta a operar normalmente: listar canais vinculados, incluir, alterar dados permitidos (código, estoque mínimo/máximo) e remover vínculos, com confirmação e atualização da lista após salvar.

Configuração — consulta de complementos (ILLI-3985)

O que acontecia: na consulta da lista de complementos, quem consumia o serviço precisava informar sempre o tipo de complemento na requisição; filtros por nome, código, alias, situação ou complemento pai, sem o tipo, não retornavam resultado.
Por quê: o endpoint de listagem tratava o tipo de complemento como critério obrigatório, limitando integrações e consultas por outros campos já visíveis no cadastro.
O que mudou: a lista aceita filtros pelos demais campos do complemento (nome, código, alias, situação, classificação, complemento pai). O tipo de complemento permanece disponível como filtro opcional para restringir o escopo.

Produto — migration de tipo Grade legado (ILLI-3992)

O que acontecia: produtos cadastrados anteriormente com o tipo Grade (modalidade descontinuada) eram gravados como Acabado ao editar e salvar na retaguarda.
Por quê: o tipo Grade legado não era mais suportado pelo cadastro atual; a edição forçava conversão incorreta para Acabado.
O que mudou: migration de dados converte todos os produtos com tipo Grade para Grade simples. Produtos de outros tipos (incluindo Acabado e Grade simples) permanecem inalterados. Após a atualização, não deve existir produto com tipo Grade.

6. Mudanças Importantes

Ambiente com beta e produção no mesmo banco: homologação na tag 3.20.r13641.1; produção prevista em 3.20.16.6.

Conclusão: exige validação cuidadosa — possível impacto estrutural no banco. A release inclui migration de dados (migrations/upgrade/default/279/01_produto.sql). Tratar como atualização conjunta (beta + master) ou homologar com restore/snapshot e prova de que a produção na versão estável continua operando após aplicar a beta.

Evidências:

Diff master…origin/r13641: 10 arquivo(s) alterado(s).
1 arquivo de migration/SQL: migrations/upgrade/default/279/01_produto.sql

Ressalvas operacionais:

Rodar migrations da beta em banco compartilhado pode quebrar a master se ela não souber ler o schema/dados novos.
Smoke test na master após atualizar a beta: abrir PDV, venda simples, pagamento, fechamento; retaguarda (login, listagem, cadastro de produto com canal de venda).

7. Documentação recomendada

Nenhum item desta versão exige guia novo de usuário ou doc interna dedicada além do changelog.

8. Problemas Conhecidos

Nenhum problema conhecido comunicado para esta versão.

9. Tarefas Relacionadas à Versão

ILLI-3974 — Cancelamento automático de NFC-e duplicada em contingência
ILLI-3984 — Correção da aba Canal de Venda no cadastro de produto
ILLI-3985 — Consulta de complementos por campos além do tipo
ILLI-3989 — Filial correta no cadastro de cliente no PDV
ILLI-3992 — Migration de produtos legados Grade para Grade simples

3.20.17.0

Resumo: Versão com foco em correções no PDV, estoque e cadastro, além da adequação ao CNPJ alfanumérico e de novas opções de filtro, exportação e configuração no dia a dia da loja.

🚀 Novidades

Novo filtro avançado no cadastro de Produto, permitindo pesquisar por código de barras e por fornecedor, como já existe nos pedidos.
Exportação em Excel e em PDF na tela de apuração de inventário, para conferir e arquivar a contagem fora do sistema.
Nova configuração para liberar movimentações com data anterior ao último inventário em lojas integradas ao LINX, sem desligar as demais regras de estoque.
A captura da nota fiscal dos pedidos passa a poder ser vinculada à entidade financeira, quando essa for diferente da entidade de destino.

⚙️ Melhorias

Importação de produtos passa a seguir mesmo quando uma linha tem erro: as demais são processadas e o sistema apresenta um relatório com as falhas encontradas.
Importação de produtos agora também preenche os campos fiscais Origem do ICMS, Produto Brinde e Grupo Fiscal, evitando ajuste manual depois da carga.
A árvore lateral da tela de Produto agora pode ser redimensionada, como já acontece em Categoria do Produto.
O parâmetro "Unidade padrão para pack" ganhou uma descrição explicando para que serve.
Ajuste na quebra de linha do cupom de devolução no PDV, melhorando a apresentação da impressão.
Adequação à Norma Técnica 2026.004, preparando o sistema para o uso do CNPJ alfanumérico.

⚠️ Atenções

No PDV com crediário, o sistema passa a exigir conta financeira associada à forma de pagamento; confira as formas de pagamento em crediário para que os títulos a receber continuem sendo gerados.

🐞 Correções

Corrigido desconto que ultrapassava o limite do parceiro quando um acréscimo era aplicado e depois cancelado no PDV.
Corrigido o total de desconto que ficava incorreto ao retomar o caixa com uma campanha promocional em andamento.
Corrigidos problemas no funcionamento de campanhas promocionais no PDV.
Corrigida a lista de itens da venda que voltava ao topo ao rolar até o último item.
Corrigida a sincronização de vendas virtuais entre PDV e retaguarda, que falhava ao seguir o fluxo errado.
Corrigida a emissão da NF-e de devolução em trocas com a troca online habilitada no PDV local.
Corrigido o cancelamento de pagamento TEF, em que o valor digitado manualmente ficava oculto para o operador.
Corrigido o CNPJ alfanumérico que era rejeitado ao informar o documento do cliente na venda.
Corrigida a busca de parceiros por CNPJ alfanumérico, que não localizava os registros.
Corrigidos os campos de CPF/CNPJ na 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 a exibição de módulos de acesso recém-criados, inclusive para o usuário Master.
Corrigida a exibição das imagens dos produtos na movimentação de estoque, agora respeitando a configuração e refletindo trocas de foto.
Corrigido o estorno de recebimento quando havia item incluído apenas no momento do recebimento.
Corrigida a contagem de inventário por código de barras, que informava produto não encontrado.
Corrigido o cadastro de crediário sem conta financeira, que encerrava a venda sem gerar o título a receber.
Corrigido o salvamento das funções programáveis nativas ao editar pela própria janela de edição.
Corrigida a consulta de NCM, em que alguns registros não apareciam na busca do produto.
Corrigido o erro de carregamento da tela inicial causado por falha de leitura no navegador.

3.20.17.1

Data: 10/07/2026

Identificação da versão:

Homologação: 3.20.r13675.1
Produção: 3.20.17.1

Resumo: Esta versão traz exportação e importação de funções programáveis, reforça a emissão fiscal no caixa quando há CPF/CNPJ informado e corrige falhas no PDV, cadastro de produtos, financeiro e gerenciamento de caixa.

🚀 Novidades

Em Sistema → Funções de Acesso, agora é possível exportar e importar funções programáveis em um único arquivo, facilitando a transferência entre ambientes.

⚙️ Melhorias

No caixa, ao informar CPF/CNPJ com a opção de cliente não cadastrado ativa, a emissão fiscal passa a ser obrigatória, mesmo quando o sistema usa o cliente padrão.

⚠️ Atenções

Lojas que usam CPF/CNPJ sem cadastro de cliente no PDV: após atualizar, confira se a venda com documento informado exige nota conforme a regra da loja.
Em Contas a Pagar, títulos ligados a conta bancária desativada voltam a aparecer na listagem — valide o histórico se a loja desativou contas recentemente.

🐞 Correções

Corrigida a duplicação de produtos (descrição, código ou EAN) ao cadastrar itens após importação de XML pelo módulo de Pedidos.
Ao duplicar NF-e em cadeia, o rascunho novo passa a trazer só as formas de pagamento da nota de origem, sem acumular formas removidas em duplicações anteriores.
Restauradas as cores das linhas na grade de Operações do Gerenciamento de Caixa, facilitando a leitura por tipo de movimento.
Em Contas a Pagar, títulos vinculados a conta bancária desativada voltam a ser exibidos na consulta.
Nas funções programáveis com acesso Caixa, as opções de atalho no menu do PDV voltam a aparecer na configuração.
No fluxo de venda virtual, ao finalizar a venda após recuperar o caixa, todos os produtos adicionados passam a ser gravados no cupom, na nota e no estoque.
No Navegador PDV, o cadastro de novo cliente passa a gravar a filial da conta PDV aberta, e não a entidade principal do usuário.

3.20.18.0

1. Informações Gerais da Versão

Produto: ILLI
Versão: 3.20.18.0
Release: r13676
Data de Lançamento: A definir
Módulos impactados: Suporte (Acesso SQL / iRelatório)

Versões corrigidas (Jira): r13676 - 3.20.18.0

2. Nota de Atualização (Resumo)

Release enxuta, com uma novidade voltada à equipe de suporte: o Illi passa a oferecer uma tela de Acesso SQL, com autenticação no registro e geração de chave segura para o Editor SQL do iRelatório. Para a loja e o caixa, não há mudança de fluxo operacional.

3. Novidades nesta Versão

Suporte — Acesso SQL e chave para o iRelatório (ILLI-4044)

Foi criado o módulo de Acesso SQL no Illi. Com login e senha de suporte (validados no servidor de registro e com permissão de consulta), a tela exibe uma chave criptografada que o Editor SQL do iRelatório usa para conectar de forma segura. Também há autenticação via API para o próprio editor. Quem não é suporte, ou não tem permissão de consulta SQL, continua bloqueado.

4. Melhorias e Ajustes

Nada adicional a destacar nesta versão.

5. Correções de Bugs

Nenhuma correção adicional a destacar nesta versão.

6. Mudanças Importantes

Quando a loja usa homologação e produção no mesmo banco, a homologação pode estar em 3.20.r13676.0 enquanto a produção permanece em 3.20.18.0 (ou na versão estável anterior).

Pode instalar só na homologação; a produção na versão estável tende a continuar operando normalmente.

A tela de Acesso SQL é ferramenta interna de suporte — não muda o dia a dia do operador da loja.
É necessário login de suporte com permissão de consulta SQL e chave de licença do iRelatório configurada no ambiente.
Vale publicar um guia interno curto (BookStack) com o passo a passo da autenticação e do uso da chave no editor.

7. Problemas Conhecidos

Nenhum problema conhecido comunicado para esta versão.

8. Tarefas Relacionadas à Versão

ILLI-4044 — Acesso SQL: tela e autenticação de suporte para o Editor SQL do iRelatório

3.20.19.1

Data: 17/07/2026

Identificação da versão:

Homologação: 3.20.r13677.3 (inclui entregas da 3.20.r13679)
Produção: 3.20.19.1 (inclui 3.20.19.0)

Resumo: Esta versão facilita a devolução no PDV ao permitir escolher uma venda do cliente, atualiza códigos de meio de pagamento na nota e corrige falhas no caixa (TEF, campanha, tela secundária), na origem do ICMS, na listagem de parceiros, no ajuste de estoque e nos modelos de importação.

🚀 Novidades

Na devolução do PDV, com o cliente selecionado, passa a existir a aba Vendas para consultar o histórico, abrir o espelho da venda e carregar os itens para devolver — além da aba de devoluções anteriores.

⚙️ Melhorias

A tabela de meios de pagamento da NF-e foi atualizada conforme o informe técnico (inclui códigos de PIX automático e TEF Book Transfer).
Em mais telas de importação (parceiros, financeiro, estoque e afins), o modelo baixado passa a trazer a aba Dicionário, com orientação das colunas — como já existia na importação de produtos.
No fiscal, o sistema passa a reconhecer a rejeição 1074 (grupo de redução de alíquota municipal não informado).

⚠️ Atenções

Lojas que usam TEF: após atualizar, valide cancelamento de pagamento e retomada de venda quando houver falha de impressão do comprovante — o PDV deixa de tratar a cobrança como cancelada se ela ainda estiver ativa na operadora.
Na devolução do PDV, a aba Vendas depende de configuração da loja; confira se ela está habilitada antes de orientar a equipe.

🐞 Correções

Na segunda tela do PDV, valores e quantidades de produtos com quantidade de atacado voltam a ser exibidos corretamente.
No ajuste de estoque, removido o teto fixo de 5.000 unidades por produto; vale o limite configurado na loja.
Em campanha no PDV, com limitador de quantidade de produtos maior que 2, o desconto volta a ser distribuído corretamente entre as unidades.
Na listagem de parceiros, a paginação volta a funcionar além dos primeiros registros.
Após erro de impressão no TEF, o PDV deixa de informar cancelamento indevido e de permitir nova cobrança da mesma venda enquanto a transação ainda estiver válida na operadora.
Na finalização da venda, a origem do ICMS do produto passa a prevalecer sobre a origem da operação no documento fiscal.

3.20.21.0

Data: 29/07/2026

Identificação da versão:

Homologação: 3.20.r13682.5
Produção: 3.20.21.0

Resumo: Esta versão atualiza NF-e e NFC-e para a Reforma Tributária (IBS, CBS e Imposto Seletivo) conforme a NT 2025.002, e corrige falhas no PDV ao acumular campanhas com acréscimo e ao compor cupons de origem na devolução.

⚙️ Melhorias

NF-e e NFC-e adequadas à NT 2025.002 (versões 1.35, 1.36 e 1.40): novos campos e validações da Reforma Tributária, incluindo indicador do local da operação, operações com ente governamental, Inscrição Suframa do emitente, devolução de tributos (cashback), grupo de alíquota zero para FM/CBS e novo tipo de nota de crédito por recusa parcial na entrega.
Na devolução fiscal, o referenciamento de documentos passa a seguir o grupo DFeReferenciado, conforme exigência da nota técnica (fase 2 da v1.40).
Tabela de meios de pagamento e regras fiscais alinhadas aos informes técnicos vigentes para emissão com IBS/CBS.

⚠️ Atenções

Lojas que emitem NF-e ou NFC-e com IBS/CBS: após atualizar, valide em homologação a emissão de nota de venda, devolução e ajustes que usem os novos campos — o pacote inclui atualização de estrutura no banco (migration).
Campanhas no PDV com benefício Valor Final que geram acréscimo e outra campanha acumulativa no mesmo produto: conferir o total da venda após a correção.

🐞 Correções

No PDV, ao acumular duas campanhas no mesmo produto, o acréscimo de uma campanha tipo Valor Final deixava de ser tratado como acréscimo e era somado ao desconto da outra campanha, reduzindo indevidamente o total da venda.
Na devolução/troca no PDV, com Compor Notas Referenciadas ativo, a referência ao cupom fiscal de origem era montada só no primeiro item; os demais itens da mesma operação ficavam sem vínculo correto na NF-e de devolução.

📚 Documentação

Guias publicados na base de conhecimento para apoiar tributação e devolução fiscal:

Tributação — cadastro de grupos e linhas de tributação na retaguarda.
Como funciona a definição da Regra Fiscal — fluxo completo de filtros, grupos fiscais e escolha da regra na venda/emissão.
Devolução com NF-e — operação de devolução no PDV com emissão de NF-e e composição de notas referenciadas.

3.20.21.1

Data: 30/07/2026

Identificação da versão:

Homologação: 3.20.r13682.6
Produção: 3.20.21.1

Resumo: Esta versão conclui o pacote da Reforma Tributária (NT 2025.002) em NF-e e NFC-e, reforça a composição de cupons de origem na devolução e mantém as correções de campanha no PDV. Em relação à 3.20.21.0, inclui ajustes finais de emissão de devolução e do evento de crédito presumido.

⚙️ Melhorias

NF-e e NFC-e adequadas à NT 2025.002 (versões 1.35, 1.36 e 1.40): novos campos e validações da Reforma Tributária, incluindo indicador do local da operação, operações com ente governamental, Inscrição Suframa do emitente, devolução de tributos (cashback), grupo de alíquota zero para FM/CBS e novo tipo de nota de crédito por recusa parcial na entrega.
Na devolução fiscal, o referenciamento de documentos passa a seguir o grupo DFeReferenciado, conforme exigência da nota técnica (fase 2 da v1.40), inclusive na retaguarda e quando há réplica de itens.
No evento de apropriação de crédito presumido, o código de classificação fica unificado na tela e o evento informa corretamente se quem solicita é o emitente ou o destinatário.
Tabela de meios de pagamento e regras fiscais alinhadas aos informes técnicos vigentes para emissão com IBS/CBS.

⚠️ Atenções

Válido instalar em produção e beta.

🐞 Correções

No PDV, ao acumular duas campanhas no mesmo produto, o acréscimo de uma campanha tipo Valor Final deixava de ser tratado como acréscimo e era somado ao desconto da outra campanha, reduzindo indevidamente o total da venda.
Na devolução/troca no PDV, com Compor Notas Referenciadas ativo, a referência ao cupom fiscal de origem era montada só no primeiro item; os demais itens da mesma operação ficavam sem vínculo correto na NF-e de devolução.
Na Troca Expressa, o fluxo de liberação e autorização ao incluir itens de devolução foi ajustado para reaproveitar corretamente o autorizador já informado na operação.
Na emissão de NF-e de devolução com layout da Reforma Tributária, o sistema deixa de misturar o grupo antigo de notas referenciadas com o DFeReferenciado, evitando rejeição ou XML inconsistente.

📚 Documentação

Guias na base de conhecimento para apoiar tributação e devolução fiscal:

Tributação — cadastro de grupos e linhas de tributação na retaguarda.
Como funciona a definição da Regra Fiscal — fluxo de filtros, grupos fiscais e escolha da regra na venda/emissão.
Devolução com NF-e — operação de devolução no PDV com emissão de NF-e e composição de notas referenciadas.