Banco de perguntas: Vendas
As perguntas do dia a dia comercial, do jeito que você fala — e, para cada uma, a ferramenta que responde, como ler o número e onde não tropeçar. Todos os valores dos exemplos são fictícios, da Distribuidora Modelo Ltda.
Perguntas e ferramentas
| Pergunta (como você fala) | Ferramenta que responde | Como ler | Cuidado |
|---|---|---|---|
| “Quanto vendi hoje / neste mês?” | get_sales_summary | Venda real, devoluções, líquido e ticket médio, numa linha só. | “Hoje” pode vir R$ 0 antes de o faturamento processar — estado real, não erro. |
| “Quanto faturei líquido de devoluções?” | get_sales_summary | net_revenue = vendas − devoluções, sem abater impostos. | Não é a base fiscal nem a venda líquida da 8128 — cada “líquido” tem a sua régua. Veja Faturado, vendido e líquido. |
| “Quem são meus melhores vendedores?” | get_top_sales_reps | Ranking por RCA; venda × líquido lado a lado mostra quem “vende e volta”. | RCA 73 é venda direta (não é uma pessoa); a devolução conta na data dela. |
| “Como está a equipe da supervisora Marina?” | get_sales_by_supervisor + get_team_of_supervisor | Líquido por equipe; “sem supervisor” é um bucket honesto, não venda sumida. | Atribuição pelo organograma atual; a lista traz buckets de canal, que não são pessoas. |
| “Quais os produtos campeões?” | get_top_products | Venda, margem e quantidade por produto no período. | Só aparecem produtos que venderam no período. |
| “Quais clientes dão pior margem?” | get_worst_margin_customers | Margem bruta por cliente, da pior para a melhor. | Aqui margin_pct é fração 0–1 (0,08 = 8%); redes podem estar fatiadas em vários códigos de cliente. |
| “Onde estou perdendo dinheiro?” (caça-prejuízo) | find_negative_realized_margin | Margem realizada líquida (8128) negativa = prejuízo real, já descontadas devoluções e impostos. | Vem sem a verba — confira a compensação no get_realized_net_margin_by_supplier. |
| “Vendi algo abaixo do custo?” | find_below_cost_sales | Notas com margem bruta negativa, da mais negativa para cima. | Inclui bonificações, que saem abaixo do custo de propósito — olhe a coluna is_bonus antes de acusar prejuízo. |
| “A margem do Fornecedor Exemplo é saudável de verdade?” | get_realized_net_margin_by_supplier | Margem sem verba × com verba (percentual 0–100) — o cheque do acordo pode virar o jogo. | Para chave com recorte de vendedor ou cliente, a verba vem omitida (vazia), nunca zero. |
| “Qual produto rende menos?” | get_realized_net_margin_by_product | Margem realizada líquida (8128) por produto. | Sempre sem verba — verba é do fornecedor, não rateia por produto. |
| “Tem produto com preço errado no cadastro?” | get_catalog_margin_quality | Margem de cadastro (8133) negativa = etiqueta errada — corrija antes de vender. | É a foto de agora, sem período; exige região e UF. |
| “Como está a meta do mês?” | company_goal · rep_goal_attainment · supervisor_goal_attainment · supplier_goal_attainment | % atingido (bruto e líquido) e quanto falta (gap). | Nunca some níveis — a mesma meta está gravada em vários quadros. Veja Metas: os cinco quadros brancos. |
| “Qual a positivação este mês?” | get_positivacao_summary · get_positivacao_by_rep · get_positivacao_by_supervisor | Clientes positivados ÷ base ativa de 12 meses (%). | Janela fixa do mês corrente; não é o “clientes” dos rankings de venda. Veja Positivação: carteira e movimento. |
| “Qual fornecedor mais vendeu? E qual rende mais?” | get_sales_by_supplier + get_realized_net_margin_by_supplier | Vender muito ≠ render muito — as duas juntas contam a história. | A devolução é atribuída à indústria do produto, não a quem emitiu a nota de devolução. |
| “Estamos crescendo?” | get_monthly_sales_trend | Série cronológica por mês, semana ou dia. | O período corrente vem parcial; meses sem venda não aparecem na série. |
Fechamento: quanto ficou do mês
Quanto faturamos em junho, líquido de devoluções?get_sales_summary responde numa linha. Na Distribuidora Modelo (números fictícios): vendas de R$ 2.450.000, devoluções de R$ 85.000, líquido de R$ 2.365.000 — as devoluções comeram 3,5% do mês, e acima de 2% costuma merecer investigação. Lembre que a devolução conta na data em que aconteceu: uma devolução feita em junho de uma venda de maio abate junho. E esse líquido não abate impostos — declare a base quando levar o número para a reunião.
Ranking: quem puxou o resultado
Top 10 vendedores por faturamento líquido em junho, de 1º a 30.get_top_sales_reps traz o ranking com venda e líquido lado a lado. A leitura fina está na distância entre os dois: o vendedor com venda alta e líquido bem menor está “vendendo e voltando” — pauta para o 1:1. E se o RCA 73 aparecer no topo, não procure o crachá: é o bucket de venda direta da empresa, não uma pessoa.
Margem: prejuízo de verdade ou bonificação?
Estamos vendendo algo no prejuízo? Mostre por produto, em junho.Duas ferramentas parecidas, papéis diferentes. find_below_cost_sales lista notas com margem bruta negativa — mas inclui bonificações, que saem abaixo do custo de propósito: a amostra grátis deixada no cliente não é prejuízo. Confira a coluna is_bonus antes de acusar alguém. O caça-prejuízo oficial é find_negative_realized_margin: a margem realizada líquida (rotina 8128), que já desconta devoluções e impostos retidos — negativa ali é dinheiro saindo de verdade. Exemplo fictício: CHOCOLATE MODELO 650G a −2,3%. Antes de cortar o produto, confira a verba do fornecedor em get_realized_net_margin_by_supplier — o acordo comercial pode transformar um item no vermelho num negócio lucrativo no agregado.
Cadastro (8133), bruta e realizada líquida (8128) medem coisas diferentes e não batem entre si — cada resposta declara qual está usando. O mapa completo está em As três margens.
Esta página ajudou? Conte para a gente — lemos tudo.