Manual de Preços do Pedido — SuperMobile
Para quem é: equipe de suporte e vendedores que usam o app de pedidos do SuperMobile.
O que este manual responde:
- Como o sistema decide o preço de cada item do pedido?
- Quando aparece a tela perguntando se quero usar o preço promocional?
- Por que o preço mudou quando aumentei a quantidade?
- O que acontece se eu trocar a tabela de preço com itens lançados?
- Quando o preço não bate com o que esperei, onde verificar?
1. Como o preço aparece na tela
Sempre que você seleciona um produto no item do pedido, o sistema calcula o preço automaticamente, considerando três coisas, nesta ordem:
- Promoção do produto — desconto de prazo definido no cadastro do produto. Quando vigente, abre uma janela perguntando se você quer usar o preço promocional.
- Preço por faixa de quantidade — alguns produtos têm preços específicos para certa quantidade de venda na tabela escolhida (ex: a partir de 50 unidades, R$ 70).
- Desconto geral da tabela — quando o produto não tem preço específico para a tabela, aplica-se o percentual de desconto cadastrado na própria tabela.
Você sempre pode editar o preço unitário manualmente depois — o sistema só sugere o valor inicial.
2. Os três caminhos de preço
Caminho A: Promoção do produto
Quando o produto está em promoção (data corrente dentro do período cadastrado e percentual de desconto maior que zero), o sistema mostra uma caixa de diálogo:
Usar preço promocional?
Produto X está em promoção:
- Preço da tabela: R$ 90,00
- Preço promocional: R$ 80,00
Se o vendedor clica "Sim, usar promoção", o item fica com o preço promocional (R$ 80,00 no exemplo) e é marcado como "venda promocional" no banco.
Se clica "Não, manter preço da tabela", o item segue com o preço calculado pelos caminhos B ou C.
A decisão é registrada no campo MOB_PROMOCAO_VALOR do item: 1 quando aceitou promo, 0 ou vazio quando recusou ou não havia promo.
Caminho B: Preço por faixa de quantidade
Alguns produtos têm preços específicos para uma tabela e quantidade mínima. Por exemplo, o produto "Detergente 5L" na tabela "Atacado" pode ter:
| Quantidade mínima | Preço unitário |
|---|---|
| 5 | R$ 90,00 |
| 50 | R$ 70,00 |
| 500 | R$ 50,00 |
O sistema pega a maior faixa em que a quantidade lançada se encaixa:
- Quantidade 4 unidades → não atinge nem a primeira faixa → cai no Caminho D (preço de venda puro, sem desconto)
- Quantidade 12 → atinge a faixa de 5 → R$ 90,00
- Quantidade 60 → atinge a faixa de 50 → R$ 70,00
- Quantidade 600 → atinge a faixa de 500 → R$ 50,00
Caminho C: Desconto geral da tabela
Quando o produto não tem nenhum preço específico cadastrado na tabela (nenhuma linha em "Preço por produto + tabela"), aplica-se o percentual de desconto cadastrado na própria tabela sobre o preço de venda do produto.
Exemplo:
- Tabela "Promocional" tem 10% de desconto.
- Produto "Detergente 5L" não tem preço específico nessa tabela.
- Preço de venda cadastrado: R$ 100,00.
- Preço aplicado: R$ 100,00 × (1 − 10%) = R$ 90,00.
Caminho D (caso especial): Preço de venda puro
Acontece quando o produto tem preços específicos na tabela (existe ao menos uma faixa de quantidade), mas a quantidade lançada está abaixo da menor faixa.
Exemplo:
- Detergente 5L na tabela "Atacado", faixa mínima de 5 unidades, preço R$ 90.
- Quantidade lançada: 3.
- O sistema usa o preço de venda puro do cadastro (sem desconto da tabela).
A lógica por trás: se o produto tem preço específico na tabela, é porque a política comercial dele nesta tabela é "atacado a partir de N unidades". Comprar abaixo do mínimo não é "atacado", então cai pro preço de balcão.
3. Resumo visual da regra
4. Mudando a quantidade
O sistema recalcula automaticamente o preço quando você altera a quantidade de um item:
- Aumentou e cruzou uma faixa → preço cai pra faixa nova.
- Diminuiu e voltou pra faixa anterior → preço sobe.
- Desceu abaixo da menor faixa → preço vai pro preço de venda puro (Caminho D).
Exceção: se você aceitou a promoção, o preço promocional fica fixo. Mudanças de quantidade não saem da promoção.
Em pedidos antigos que você abre para editar, o sistema não recalcula automaticamente os itens já salvos quando você só muda a quantidade. Ele preserva o preço original — pra evitar surpresa em pedidos com muito tempo. Se quiser forçar recálculo, troque o produto ou a tabela.
5. Trocando a tabela de preço
Se você muda a tabela com itens já lançados, aparece uma janela de confirmação:
Recalcular preços com a nova tabela?
Você está alterando a tabela de preço com X itens já lançados. Os valores unitários serão recalculados de acordo com a nova tabela e qualquer preço promocional aceito será removido.
- Recalcular → Todos os itens recebem o preço novo da tabela escolhida. Promoções aceitas são desfeitas (você pode reaplicar uma a uma ao reabrir cada item, se ainda for o caso).
- Cancelar → A tabela volta pra anterior. Preços ficam como estavam.
6. Vendedor responsável (campo "Cód. vendedor")
Cada pedido tem um vendedor responsável. O campo aparece na aba Dados Principais:
- Vendedor regular: o campo é preenchido automaticamente com o seu código e fica bloqueado. Você não pode alterar.
- Admin / Superadmin: o campo é editável — você pode lançar pedido em nome de qualquer vendedor.
Quem pode editar pedidos de outros vendedores?
- Vendedor regular: não. Se tentar abrir pedido alheio, recebe a mensagem "Você só pode editar pedidos do seu próprio usuário." e volta pra listagem.
- Admin / superadmin: sim. Pode abrir, editar e até trocar o vendedor associado.
Filtro "Meus pedidos" na listagem: clica no badge para ver apenas os seus.
7. Quando o preço não bate — guia rápido de suporte
Sintoma: "O preço veio diferente do que combinamos com o cliente"
Roteiro de triagem:
Confirme a tabela de preço que está selecionada no pedido (aba "Dados Principais", campo "Tabela de preço"). Tabela errada = preço errado.
Veja o cadastro do produto:
- Tem promoção vigente? Conferir período de início/fim e percentual.
- Qual é o preço de venda cadastrado?
Veja a tabela de preço:
- O produto tem preço específico nessa tabela? Se sim, qual é a quantidade mínima da faixa que se aplica?
- A tabela tem desconto geral?
Veja a quantidade lançada do item.
Com essas 3 informações, é possível bater na regra acima e identificar de onde veio o valor.
Sintoma: "Por que apareceu a janela de promoção?"
Significa que o produto tem promoção vigente cadastrada no mestre. O vendedor precisa decidir se aceita ou recusa. Se a promoção foi cadastrada por engano, o cadastro precisa ser ajustado pelo time responsável.
Sintoma: "Mudei a quantidade e o preço não atualizou"
Verifique se é um pedido antigo aberto pra edição: pedidos já salvos não recalculam automaticamente quando só a quantidade muda. Para forçar recálculo, troque o produto do item, ou troque a tabela do pedido (e confirme no diálogo).
Sintoma: "Aceitei a promoção, mas o pedido fechou com outro preço"
Isso pode indicar que a tabela foi trocada depois da aceitação da promo (a troca de tabela limpa promoções aceitas). Verifique o histórico de alterações — se o vendedor mudou a tabela após capturar o item, o sistema avisa que vai recalcular tudo.
Sintoma: "Não consigo alterar a tabela / não consigo abrir esse pedido"
- Pedido fechado (situação "F"): nenhum campo aceita alteração — incluindo tabela e itens.
- Pedido alheio (você não é o vendedor do pedido): só admin / superadmin abre.
- Pedido sem itens lançados: dá pra trocar tabela direto sem confirmação.
8. FAQ rápido
P: O preço promocional substitui o preço da tabela? R: Sim, quando o vendedor aceita. Se recusar, o sistema cai no preço calculado pela tabela.
P: Posso ter dois produtos com o mesmo código mas em tabelas diferentes? R: Não. O código do produto é único. O que muda por tabela é o preço dele. Cadastre uma linha em "Preço por produto + tabela" para cada combinação que tem regra específica.
P: Quando uso desconto manual no item, o que acontece? R: Você pode editar o campo "Valor unitário" diretamente — o sistema aceita. O preço calculado pelo sistema é só uma sugestão.
P: Por que pedidos antigos não recalculam? R: Para preservar o histórico comercial — se a política de preço mudar depois, pedidos já fechados com cliente não devem mudar de valor sozinhos.
P: O que muda quando faço o cliente assinar? R: A assinatura é capturada no canvas, gravada junto com o pedido (no servidor) e fica disponível ao reabrir o pedido para visualização ou no PDF.
P: Onde o preço final fica registrado? R: No campo MOB_VALOR_UNIT de cada item de pedido. O total do pedido é o somatório de (quantidade × valor unitário) menos descontos do item e do pedido.
9. Quando escalar pro time técnico
Acionar o time de TI quando:
- O sistema mostra erro técnico ao calcular preço (mensagem em vermelho com código).
- O preço calculado claramente não bate nenhum dos 4 caminhos descritos acima — pode indicar dados corrompidos ou bug.
- Promoção cadastrada não aparece na hora da venda mesmo dentro do período.
- O campo "Cód. vendedor" está vazio depois de criar pedido novo (deveria vir preenchido).
- Pedido carregou sem assinatura mesmo o cliente tendo assinado em pedido anterior.
Anote sempre:
- Código do pedido
- Código do produto
- Código da tabela de preço
- Quantidade lançada
- Valor que apareceu vs valor esperado
Esses 5 dados permitem reproduzir o caso no ambiente de teste.
Última atualização: 2026-05-01