# 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