Estrutura do Produto
Estrutura Produto — Rastreabilidade (Portal Easypac)
A tela de Estrutura Produto é onde você cadastra de que é composto cada produto final: os componentes (ingredientes), com a quantidade e a unidade de medida de cada um, e a formulação do próprio produto final.
Visão Geral
A tela de Estrutura Produto é onde você cadastra de que é composto cada produto final: os componentes (ingredientes), com a quantidade e a unidade de medida de cada um, e a formulação do próprio produto final. A tela não movimenta estoque; ela apenas mantém a receita do produto.
A tela só mostra dados depois que você escolhe uma Empresa e um Produto Final e clica em Filtrar.
Pré-requisitos
Para usar a tela de Estrutura Produto, você precisa da permissão de visualizar estrutura de produto e de ao menos uma empresa vinculada ao seu usuário.
O produto final precisa estar cadastrado e ativo na empresa escolhida. Os componentes precisam ser produtos já cadastrados e ativos.
Permissões e Perfis de Acesso
- Abrir a tela e consultar estruturas: permissão de visualizar estrutura de produto.
- Incluir, editar e excluir componentes e salvar a formulação: quem abre a tela pode fazer essas operações.
- Ver empresas no filtro: o filtro Empresa mostra apenas as empresas vinculadas ao seu usuário.
Fluxo Operacional
Fluxo — consultar a estrutura de um produto final
- Abra Rastreabilidade → Estrutura Produto.
- Confira a Empresa (a sua empresa padrão já vem marcada) ou escolha outra.
- No campo Produto Final, abra a pesquisa, localize o produto e selecione-o.
- Clique em Filtrar. Aparecem o quadro de Formulação, os cartões de totais e a grade de Componentes/Ingredientes.
Fluxo — incluir ou editar um componente
- Com a estrutura consultada, clique em Novo, ou selecione a linha e clique em Editar (o duplo clique também abre a edição).
- Escolha o Produto Filho, informe a Quantidade e escolha a Unidade de Medida.
- Clique em Salvar. A janela fecha e a grade é atualizada.
Fluxo — excluir um componente
- Selecione a linha na grade e clique em Excluir.
- Confirme com Ok no diálogo “Tem certeza?”. A grade é atualizada.
Fluxo — registrar a formulação do produto final
- Com a estrutura consultada, informe no quadro Formulação a Quantidade Formulação e a Unidade de Medida Formulação.
- Clique em Salvar.
Interface e Comportamentos da Tela
Filtros
O painel de filtros tem dois campos obrigatórios e o botão Filtrar:
- Empresa: a sua empresa padrão já vem marcada.
- Produto Final: campo de pesquisa com lupa e botão de limpar. O produto escolhido aparece como código – nome.
Ao trocar a Empresa, o Produto Final escolhido é limpo, porque os produtos finais dependem da empresa.
Pesquisa de Produto Final e de Produto Filho
Os campos Produto Final e Produto Filho abrem uma janela de pesquisa ao pressionar Enter ou clicar na lupa. O texto digitado antes já entra como busca.
- A janela “Produtos Final” lista os produtos finais da empresa selecionada.
- A janela “Produto Filho (Componente/Ingrediente)” lista os produtos que podem ser componentes. O próprio produto final não aparece nela.
Para escolher, dê duplo clique na linha ou marque a linha e clique em “Selecionar”. A janela só fecha pelo X ou ao selecionar. Se você clicar em “Selecionar” sem marcar nenhuma linha, o campo fica vazio.
Quadro Formulação
O quadro “Formulação” tem os campos obrigatórios Quantidade Formulação e Unidade de Medida Formulação e os botões Salvar e Cancelar. Ao filtrar, o quadro mostra a formulação já gravada do produto.
Cartões de totais
O quadro mostra “Produto Selecionado:” com o nome do produto final e dois cartões:
- Total de Componentes: quantidade de componentes da estrutura.
- Unidades Totais: soma das quantidades de todos os componentes, sem considerar a unidade de cada um.
Os cartões são atualizados sempre que a grade é recarregada.
Grade de Componentes/Ingredientes
A grade exibe as colunas Id, Produto Filho (Componente/Ingrediente), Quantidade e Unidade, com todos os componentes do produto final. A caixa de busca pesquisa nos componentes exibidos.
Os botões são:
- Novo: abre a janela de cadastro vazia.
- Editar: abre a edição da linha selecionada (ou dê duplo clique na linha).
- Excluir: remove o componente da linha selecionada.
Janela de componente
A janela tem três campos obrigatórios e os botões Cancelar e Salvar:
- Produto Filho (Componente/Ingrediente): pesquisa em janela.
- Quantidade: número positivo, com vírgula como separador decimal.
- Unidade de Medida: lista com busca; você também pode digitar uma unidade que não esteja na lista.
O título é “Cadastro de componente:” no cadastro novo e “Edição de componente ({componente}):” na edição, com os campos já preenchidos.
Unidades de medida
A lista oferece: Grama, Miligramas, Microgramas, Quilogramas, Tonelada, Mililitros, Litros, Metros, Centímetros, Milímetros, Metros Quadrados, Metros Cúbicos, Quilocalorias, Quilojoules, Unidade, Caixa, Pacote, Fardo, Peça, Conjunto, Par, Rolo e Dúzia. A grade mostra a sigla (por exemplo G, KG, UN).
Feedbacks ao Usuário
Avisos e confirmações
| Situação | Feedback | Texto exibido |
|---|---|---|
| Salvar componente ou formulação com campo obrigatório vazio | Aviso; nada é gravado | “Preencha todos os campos obrigatórios.” |
| Clique em Excluir | Confirmação com Ok e Cancelar | “Tem certeza? / Você está prestes a remover o componente: {id} – {componente}” |
| Componente salvo ou excluído | Sucesso; grade atualizada | “Operação efetuada com sucesso.” |
| Formulação salva | Sucesso | “Formulação salva com sucesso!” |
Mensagens de erro
| Situação | O que fazer |
|---|---|
| Erro ao salvar ou excluir componente, ou ao salvar ou carregar a formulação | Anotar o texto exibido e acionar o suporte técnico. |
Troubleshooting
A opção Estrutura Produto não aparece ou o acesso é negado
O que fazer: solicitar ao administrador a permissão de visualizar estrutura de produto.
O filtro Empresa vem vazio ou desabilitado
O que fazer: solicitar ao administrador que vincule ao menos uma empresa ao seu usuário.
A tela abre sem nenhuma estrutura
O que fazer: escolher Empresa e Produto Final e clicar em Filtrar. A tela não carrega dados ao abrir.
O botão Filtrar não carrega nada
O que fazer: preencher Empresa e Produto Final. Se o Produto Final ficou vazio depois de clicar em “Selecionar” sem marcar linha na pesquisa, escolher o produto de novo.
O produto final não aparece na pesquisa
O que fazer: conferir se a Empresa escolhida é a do produto e se o produto está ativo. Em empresas com muitos produtos, digitar parte do nome ou o código para trazer o produto ao início da lista.
O produto desejado não aparece na pesquisa de Produto Filho
O que fazer: conferir se o produto está ativo no cadastro. O próprio produto final nunca é oferecido como componente.
“Preencha todos os campos obrigatórios” ao salvar
Mensagem exibida: “Preencha todos os campos obrigatórios.”
O que fazer: preencher todos os campos marcados com asterisco. Atenção: quantidades menores que 1 (por exemplo 0,500) são recusadas pela tela. Nesse caso, informar a quantidade em unidade menor (por exemplo 500 G em vez de 0,500 KG) ou acionar o suporte técnico. O mesmo vale para o quadro de Formulação.
Nada acontece ao salvar depois de limpar o Produto Final
O que fazer: abrir de novo a pesquisa de Produto Final, selecionar o produto e clicar em Filtrar.
Mensagem de erro ao salvar ou excluir
O que fazer: anotar o texto exibido e acionar o suporte técnico.
A exclusão mostrou sucesso, mas o componente continua na grade
Mensagem exibida: “Operação efetuada com sucesso.”
O que fazer: clicar em Filtrar novamente. Se o componente continuar, acionar o suporte técnico.
A formulação aparece com quantidade zero e sem unidade
O que fazer: se o produto nunca teve formulação informada, isso é o esperado. Se já tinha, acionar o suporte técnico informando o produto e a empresa.
A formulação foi salva com sucesso, mas o valor anterior voltou
Mensagem exibida: “Formulação salva com sucesso!”
O que fazer: acionar o suporte técnico.
Uma quantidade aparece como “0.000”
O que fazer: nenhuma ação. A grade mostra “0.000” quando a quantidade é zero ou não foi informada.
Um produto inativado ainda aparece como componente
O que fazer: se o componente não deve mais compor o produto, excluí-lo da estrutura.
Unidades Totais soma quantidades de unidades diferentes
O que fazer: o cartão soma os números sem considerar a unidade (por exemplo, 2 KG + 3 UN = 5). Use-o como referência apenas quando todos os componentes tiverem a mesma unidade.
Casos de Uso
Caso 1 — Cadastrar a estrutura de um produto final novo
A analista de qualidade abre Rastreabilidade → Estrutura Produto, com a empresa padrão já marcada. Seleciona o Produto Final “1042 – Hambúrguer Bovino 90 g” e clica em Filtrar. A grade vem vazia. Ela clica em Novo, escolhe o Produto Filho “310 – Carne Bovina Moída”, informa Quantidade “80,000” e Unidade “G” e clica em Salvar. Aparece “Operação efetuada com sucesso.” e o cartão Total de Componentes passa a 1.
Caso 2 — Corrigir a quantidade de um componente
O usuário dá duplo clique na linha “Sal Refinado”. A janela abre com o título “Edição de componente (Sal Refinado):”. Ele altera a Quantidade para “2,000” e clica em Salvar. A grade e os cartões são atualizados.
Caso 3 — Excluir um componente e registrar a formulação
O usuário seleciona “Corante Artificial”, clica em Excluir e confirma. Depois, no quadro Formulação, informa Quantidade Formulação “100,000” e Unidade “KG” e clica em Salvar, recebendo “Formulação salva com sucesso!”.
Caso 4 — Trocar de empresa durante a consulta
Com “1042 – Hambúrguer Bovino 90 g” escolhido, o usuário troca a Empresa para a filial. O campo Produto Final é limpo. Ele escolhe um produto final da filial e clica em Filtrar.