# Julho/2026 # 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](https://kb.illimitar.pro/books/sistema/page/tributacao) — cadastro de grupos e linhas de tributação na retaguarda. * [Como funciona a definição da Regra Fiscal](https://kb.illimitar.pro/books/sistema/page/como-funciona-a-definicao-da-regra-fiscal) — fluxo completo de filtros, grupos fiscais e escolha da regra na venda/emissão. * [Devolução com NF-e](https://kb.illimitar.pro/books/illi-operacao-loja/page/devolucao-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.