3.20.17.1

1. Informações Gerais da Versão

Produto: ILLI
Versão: 3.20.17.1
Release: r13675
Data de Lançamento: 10 de jul de 2026
Módulos impactados: PDV (caixa e venda virtual), Funções de Acesso, Cadastro de produtos (importação XML), Fiscal (NF-e), Gerenciamento de Caixa, Contas a Pagar

Versões corrigidas (Jira): r13675 - 3.20.17.1

2. Nota de Atualização (Resumo)

Release com novidade de exportar/importar função programável, ajuste fiscal no PDV ao informar CPF/CNPJ e correções em caixa, produtos e financeiro. Escopo confirmado no git (/Users/edson/dev/illi, branch r13675, tag beta-3.20.r13675.1): 17 arquivos vs origin/master, com migration DML migrations/upgrade/default/275/01_funcao.sql (funções Exportar/Importar). Tickets com commit na branch: ILLI-3717, ILLI-3929, ILLI-3947, ILLI-3963, ILLI-3967, ILLI-3975, ILLI-4019, ILLI-4020; atalho do PDV (ILLI-4014) entregue no commit #ILLI-3014. ILLI-3952 está na fixVersion do Jira, mas não está mergeada em r13675.

3. Novidades nesta Versão

Sistema — Exportar e importar função programável (ILLI-3929)

Em Sistema → Funções de Acesso, passam a existir as ações Exportar e Importar para funções do tipo Programável. O pacote exportado leva a função (e bibliotecas usadas) para outro ambiente; na importação, o operador envia só esse arquivo e a função fica disponível na grade. Migration 275 registra as funções estáticas exportar e importar e atualiza o grupo MASTER.

4. Melhorias e Ajustes

PDV — Emissão fiscal obrigatória ao informar CPF/CNPJ (ILLI-3717)

Com “Permitir cliente não cadastrado (somente CPF/CNPJ)” ativo, informar documento no caixa passa a forçar emissão fiscal mesmo quando o sistema segue com o cliente padrão (documento sem cadastro). Antes, a regra de “forçar nota com cliente identificado” só valia para cliente diferente do padrão.

5. Correções de Bugs

Produto — Duplicação após importação de XML (ILLI-3947)

O que acontecia: após importar XML pelo módulo de Pedidos e cadastrar os produtos selecionados na grade, itens eram duplicados por descrição, código ou EAN.
Por quê: o fluxo de cadastro pós-importação não tratava corretamente a unicidade dos códigos já existentes.
O que mudou: o cadastro a partir do XML deixa de gerar produtos duplicados com o mesmo código/EAN.

Fiscal — Duplicar NF-e acumula formas de pagamento (ILLI-3963)

O que acontecia: ao duplicar NF-e em cadeia (duplicar, trocar forma de pagamento, finalizar e duplicar de novo), o rascunho novo trazia formas antigas removidas e somava valores indevidos.
Por quê: a duplicação reincorporava formas de pagamento de rascunhos anteriores da cadeia, não só as vigentes na nota de origem.
O que mudou: o rascunho gerado pela duplicação copia apenas as formas de pagamento do registro duplicado, com valores coerentes.

Venda — Cores das linhas em Operações do caixa (ILLI-3967)

O que acontecia: na grade Operações do Gerenciamento de Caixa, todas as linhas ficavam iguais, sem cor por tipo (movimentação, cancelamento, DANFE etc.).
Por quê: a coloração foi perdida após ajuste anterior do botão Impressão (só com item selecionado).
O que mudou: as cores por tipo de operação foram restauradas; o botão Impressão continua aparecendo só com seleção.

Financeiro — Contas a Pagar com conta desativada (ILLI-3975)

O que acontecia: títulos ligados a conta bancária desativada sumiam da listagem de Contas a Pagar; reativar a conta fazia os lançamentos reaparecerem.
Por quê: a consulta filtrava de forma que ocultava histórico vinculado a conta inativa.
O que mudou: títulos da entidade permanecem consultáveis mesmo com a conta desativada; a desativação de conta com títulos em aberto passa a ser bloqueada quando aplicável.

Usuário — Atalhos do PDV na função programável (ILLI-4014 / commit #ILLI-3014)

O que acontecia: ao configurar função programável com acesso Caixa, as opções de atalho no menu do PDV ficavam ocultas.
Por quê: o campo “Usar atalho no menu PDV” estava com hidden: true no formulário.
O que mudou: o campo volta a ser exibido (hidden: false), permitindo configurar atalho no caixa. No git o commit está como #ILLI-3014; no Jira a entrega desta release é ILLI-4014.

PDV — Venda virtual grava só um produto (ILLI-4019)

O que acontecia: após confirmar venda virtual, recuperar o caixa, adicionar produtos comuns e finalizar, só um item era gravado no cupom, na nota e no estoque — sem mensagem de erro.
Por quê: a restauração da sessão após venda virtual não preservava corretamente todos os itens na finalização.
O que mudou: todos os produtos da venda são gravados no documento e na baixa de estoque, mesmo após passagem por venda virtual.

PDV — Filial no cadastro de cliente (Navegador PDV) (ILLI-4020)

O que acontecia: ao cadastrar cliente novo no Navegador PDV com caixa aberto em outra filial, a filial gravada não batia com a conta PDV da sessão.
Por quê: o cadastro não seguia a entidade da conta PDV aberta.
O que mudou: a filial do cliente novo reflete a loja da conta PDV em uso na abertura do caixa.

6. Mudanças Importantes

Base beta (mesmo banco): viável instalar só na beta; master/produção pode permanecer estável.

Diff origin/master…origin/r13675: 17 arquivos; 1 migration DML (275/01_funcao.sql) sem DDL de schema. A migration inclui funções Exportar/Importar, refresh do grupo MASTER e TRUNCATE de sessões (logout geral na aplicação da migration). Homologação: 3.20.r13675.1 (beta-3.20.r13675.1). Produção alvo: 3.20.17.1.

Cuidado operacional: ILLI-3717 altera o comportamento fiscal no PDV com CPF/CNPJ e cliente não cadastrado. ILLI-3975 muda visibilidade de títulos com conta desativada.

Fora do pacote git: ILLI-3952 (lentidão na abertura de módulos da retaguarda) está na fixVersion do Jira, mas a branch da issue não foi mergeada em r13675 — não tratar como entregue nesta versão.

Documentação pendente: ILLI-3929 — rascunhos em docs/ desta pasta (portal + BookStack).

7. Problemas Conhecidos

Nenhum problema conhecido comunicado para esta versão. ILLI-3952 permanece pendente de merge se ainda for desejada nesta release.

8. Tarefas Relacionadas à Versão

ILLI-3717 — PDV: emissão fiscal obrigatória ao informar CPF/CNPJ (no git)
ILLI-3929 — Sistema: exportar e importar função programável (no git + migration 275)
ILLI-3947 — Produto: duplicação de código/EAN após importação de XML (no git)
ILLI-3952 — Retaguarda: lentidão ao abrir módulos (Jira apenas — não mergeada em r13675)
ILLI-3963 — Fiscal: duplicar NF-e acumula formas de pagamento (no git)
ILLI-3967 — Venda: restaurar cores das linhas em Operações do caixa (no git)
ILLI-3975 — Financeiro: Contas a Pagar com conta bancária desativada (no git)
ILLI-4014 — Usuário: opções de atalho do PDV na função programável (Jira; commit git #ILLI-3014)
ILLI-4019 — PDV: venda virtual finaliza gravando apenas um produto (no git)
ILLI-4020 — PDV: filial incorreta no cadastro de cliente (Navegador PDV) (no git)