✏️ Visualizar, Editar e Excluir Produtos

Mantenha seu catálogo de produtos preciso visualizando detalhes, atualizando preços, corrigindo códigos HSN, ajustando configurações de impostos e removendo produtos que não são mais vendidos.

Cada linha de produto na lista possui três ícones de ação na coluna Ações:

Ícone	Ação	Quem pode usar
Olho	Visualizar detalhes do produto (diálogo somente leitura)	Todos os usuários
Lápis	Editar produto	Todos os usuários
Lixeira	Excluir produto	Somente Admin

---

👁️ Visualizando um Produto

Como Visualizar

1. Vá para Produtos no menu principal
2. Encontre o produto na lista (use a barra de pesquisa se necessário)
3. Clique no ícone Visualizar (olho) na linha do produto
4. Um diálogo de detalhes somente leitura é aberto, mostrando todas as informações do produto

O que o Diálogo de Visualização Mostra

Campo	Descrição
Nome do Produto	Nome de exibição
Preço Unitário	Preço de venda
Taxa de Imposto	% de GST aplicado
Tipo de Imposto	Categoria de imposto (ex: Tributável)
Categoria de Imposto	Herdado ou personalizado
Grupo de Produtos	Categoria
Unidade	Unidade de medida
Código HSN	Código de classificação GST
Usar Taxa de Imposto do Grupo	Se o imposto do grupo é aplicado
Quantidade (por unidade)	Estoque atual
MRP	Preço Máximo de Varejo
Código de Barras	Código de barras / SKU se definido
País de Origem	País de fabricação se definido
Número de Série	Número de série se definido
Campos Personalizados	Quaisquer metadados chave-valor extras

---

✏️ Editando um Produto

Como Abrir o Formulário de Edição

1. Vá para Produtos no menu principal
2. Encontre o produto na lista (use a barra de pesquisa se necessário)
3. Clique no ícone Editar (lápis) na linha do produto
4. O formulário do produto é aberto com todos os valores atuais pré-preenchidos
5. Faça suas alterações
6. Clique em Salvar

O que Você Pode Editar

Todos os campos do produto são editáveis a qualquer momento:

Seção	Campos
Básico	Nome do Produto, Descrição, Categoria do Produto, Unidade
Preços	Preço Unitário (Preço de Venda), MRP, Tipo de Desconto (Nenhum / Percentual / Valor)
Imposto	Taxa de Imposto (%), alternância Usar Taxa de Imposto do Grupo, Tipo de Imposto, caixas de seleção TCS/TDS
Conformidade	Código HSN / SAC (use o botão Preencher HSN automaticamente ou insira manualmente)
Estoque	Quantidade do Produto por Unidade
Metadados	Campos Personalizados (pares chave-valor, + Adicionar Campo)

:::info Impacto das Edições nas Faturas A edição de um produto atualiza apenas o registro do catálogo. Faturas finalizadas existentes retêm os dados do produto que foram capturados na criação da fatura — elas nunca são modificadas retroativamente. Faturas em rascunho usarão os dados atualizados do produto quando recalculadas. :::

Alterações de Preço

Quando você atualiza o Preço Unitário ou o MRP:

• ✅ Novas faturas usam o novo preço
• ✅ Faturas finalizadas/pagas mantêm o preço original (conformidade de auditoria)
• ⚠️ Faturas em rascunho abertas podem precisar de revisão manual se os preços forem importantes

Alterações na Taxa de Imposto

Quando você altera a Taxa de Imposto (ou ativa/desativa Usar Taxa de Imposto do Grupo):

• Novas faturas pegam a taxa atualizada
• Faturas existentes não são afetadas
• Se o produto usa Usar Taxa de Imposto do Grupo, atualizar a taxa padrão da categoria altera todos os produtos nessa categoria simultaneamente — mais eficiente do que editar cada produto individualmente

Correção do Código HSN / SAC

O código HSN/SAC pode ser corrigido a qualquer momento:

1. Abra o formulário de edição do produto
2. Clique em Preencher HSN automaticamente para procurar o código automaticamente, ou digite-o diretamente (4, 6 ou 8 dígitos)
3. O sistema valida o formato antes de salvar

:::warning Conformidade com GST A correção de um código HSN/SAC afeta apenas faturas futuras. Faturas finalizadas passadas mantêm seu código original. Se um período de declaração já estiver fechado, consulte seu consultor fiscal antes de alterar códigos em produtos com transações existentes. :::

Reatribuição de Categoria

Você pode mover um produto para uma Categoria de Produto diferente selecionando uma nova categoria no formulário de edição. Isso altera:

• A categoria mostrada na lista de produtos
• A taxa de imposto herdada (se Usar Taxa de Imposto do Grupo estiver ativado)

Faturas existentes não são afetadas por alterações de categoria.

---

🗑️ Excluindo um Produto

:::warning Somente Admin O ícone de Excluir é visível apenas para usuários Admin. :::

Passos para Excluir

1. Vá para Produtos
2. Encontre o produto a ser removido
3. Clique no ícone Excluir (lixeira) na linha do produto
4. Um diálogo de confirmação aparece — clique em Confirmar para prosseguir
5. O produto é removido do catálogo

Quando a Exclusão é Bloqueada

aviso

Um produto não pode ser excluído se for referenciado por faturas finalizadas ou pagas. O sistema mostrará uma mensagem de erro se você tentar excluir tal produto.

Condição	Pode Excluir?
Produto nunca usado em nenhuma fatura	✅ Sim
Produto usado apenas em faturas em rascunho	✅ Sim (rascunhos atualizados)
Produto em uma fatura finalizada	❌ Não
Produto em uma fatura paga	❌ Não

---

Cenários Comuns

Cenário 1: Aumento de Preço

Situação: Seu fornecedor aumentou os custos e você precisa atualizar o preço de venda.

1. Edite o produto → atualize o Preço Unitário (Preço de Venda)
2. Opcionalmente, atualize o MRP se o MRP também mudou
3. Clique em Salvar
4. Resultado: Todas as novas faturas usam o novo preço; faturas passadas inalteradas

Cenário 2: Código HSN Incorreto Foi Usado

Situação: O código HSN inserido quando o produto foi criado estava incorreto.

1. Edite o produto → clique em Preencher HSN automaticamente ou corrija o código diretamente
2. Clique em Salvar
3. Resultado: Faturas futuras usam o código corrigido
4. Faturas passadas retêm o código original — revise com seu contador se o erro afeta as declarações de GST já enviadas

Cenário 3: Produto Não Mais Vendido

Situação: Você descontinuou um produto e não quer que ele apareça em novas faturas.

Opções:

• Exclua-o — possível apenas se não tiver faturas finalizadas
• Renomeie-o com um prefixo [DESCONTINUADO] para que os usuários saibam que não devem selecioná-lo
• Mova-o para uma categoria "Descontinuado" para separação visual

Cenário 4: Taxa de Imposto Incorreta

Situação: A taxa de GST de um produto está errada.

1. Se o produto usa Usar Taxa de Imposto do Grupo → edite a taxa de imposto padrão da Categoria de Produto; todos os produtos nessa categoria são atualizados automaticamente
2. Se o produto tem uma taxa personalizada → edite o produto → desative Usar Taxa de Imposto do Grupo → defina a Taxa de Imposto (%) correta
3. Clique em Salvar

---

⚠️ Solução de Problemas

Alterações Não Salvando

Problema: As edições do produto não estão sendo salvas.

1. Verifique se há erros de validação mostrados em vermelho
2. Garanta que todos os campos obrigatórios estão preenchidos (Categoria do Produto, Unidade, Nome do Produto, Preço Unitário, Taxa de Imposto, Código HSN)
3. Verifique se o Preço Unitário é um número válido (≥ 0)
4. Verifique se o código HSN tem exatamente 4, 6 ou 8 dígitos sem zeros à esquerda

Não é Possível Excluir o Produto

Problema: Ícone de exclusão não visível, ou a exclusão falha.

Motivo	Solução
Não é um usuário Admin	Contate o Admin da sua empresa
Produto usado em faturas finalizadas/pagas	Renomeie com o prefixo [DESCONTINUADO] em vez disso

Código HSN Não Salvando

Problema: O campo do código HSN mostra um erro de validação.

1. O código deve ter exatamente 4, 6 ou 8 dígitos
2. Não são permitidos espaços ou caracteres especiais
3. Não pode ser todo de zeros (ex: 0000 é inválido)
4. Use Preencher HSN automaticamente para encontrar o código correto

---

🔗 Relacionados

• Visão Geral dos Produtos — referência de recursos do catálogo e status de estoque
• Criar um Produto — adicione novos produtos ao catálogo
• Grupos de Produtos — gerencie taxas de imposto e padrões de HSN em nível de categoria