Lista de Tabelas de Preço
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Tabelas de Preço Última atualização: 20/04/2026
Para que serve
Exibe todas as tabelas de preço cadastradas no tenant. Permite buscar, filtrar, criar, abrir e remover tabelas. Também oferece o atalho "Gerar de Custo" para criar uma nova tabela automaticamente a partir do custo calculado dos produtos.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Acesse Menu > Comercial > Tabelas de Preço.
- Use o campo de busca para filtrar por código ou descrição.
- Use os seletores "Tipo" e "Situação" para refinar os resultados.
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro de edição.
- Clique em "Nova Tabela" para criar uma tabela manualmente.
- Clique em "Gerar de Custo" para criar uma tabela automaticamente a partir dos custos calculados de uma filial (ver detalhes na seção de validações).
- Clique no ícone de lixeira para remover uma tabela (confirmação obrigatória).
- A lista carrega automaticamente mais registros ao rolar até o fim (scroll infinito, lotes de 50).
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Código ou descrição | Filtra em tempo real |
| Tipo | Não | Venda, Custo, Pauta, Promoção | Filtro de coluna |
| Situação | Não | Ativa, Inativa, Rascunho | Filtro de coluna |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| ID | Identificador interno sequencial |
| Descrição | Nome da tabela |
| Tipo | Tag colorida: Venda (azul), Custo (roxo), Pauta (ciano), Promoção (magenta) |
| Itens | Quantidade de produtos cadastrados na tabela |
| Vigência | Período no formato DD/MM/AAAA → DD/MM/AAAA (ou "Indeterminado") |
| Situação | Tag: Ativa (verde), Inativa (cinza), Rascunho (laranja) |
| Ações | Lixeira para remover |
Modal "Gerar de Custo"
Cria uma nova tabela com um item para cada produto que tem custo calculado na filial escolhida.
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Filial | Sim | Filial cujos custos serão usados | Pré-selecionada com a filial ativa |
| Método de formação | Sim | Markup Divisor ou Markup Multiplicador | Default: Markup Divisor |
| Margem desejada | Não | Percentual de lucro embutido | Fica salvo na tabela |
| Comissão padrão | Não | Percentual de comissão | Fica salvo na tabela |
| Descrição da tabela | Sim | Nome da nova tabela | Máximo 255 caracteres |
| Tipo | Não | Venda, Custo, Pauta, Promoção | Default: Venda |
| Situação | Não | Ativa, Inativa, Rascunho | Default: Rascunho |
| Vigência início | Sim | Data inicial da vigência | Default: hoje |
| Vigência fim | Não | Data final da vigência | Vazio = indeterminada |
| Ignorar produtos bloqueados | Não | Liga/desliga | Default: ligado |
| Observações | Não | Texto livre | Máximo 500 caracteres |
Validações e regras
- O botão "Gerar" no modal exige filial, método e descrição.
- Produtos sem custo calculado ou com markup matematicamente impossível são ignorados e contados em "Produtos pulados".
- A lista usa scroll infinito: novos registros carregam ao atingir 200 px do fundo da tela.
- Remover uma tabela dispara confirmação antes de excluir.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar tabelas de preço" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
| "Erro ao remover tabela" | Tabela em uso ou erro na API | Verifique se a tabela está vinculada a pedidos ou canais ativos |
| ⚠️ CONFIRMAR texto literal | Erro retornado pela API ao gerar de custo | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
tabelasPrecoService(tabelas-preco.service) - Serviço auxiliar:
filiaisService(carrega filiais para o modal Gerar de Custo) - Depende de custos calculados por filial (módulo de custo de produto)
Dúvidas frequentes
Por que alguns produtos foram pulados ao gerar de custo? O produto não tem custo_total_formacao_preco calculado ou o percentual de margem informado tornaria o markup matematicamente inválido (divisor <= 0). Verifique o custo do produto no módulo de estoque/compras.
Posso ter várias tabelas ativas ao mesmo tempo? Sim. A tabela usada em cada venda é definida no cadastro do canal de venda, da região de venda ou diretamente no pedido/orçamento.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |