Caça-prejuízo (onde o dinheiro vaza)

Carlos, gerente financeiro da Distribuidora Modelo Ltda, desconfia que “tem produto saindo no vermelho”. Em quinze minutos e três perguntas, ele encontra os produtos com prejuízo real, verifica se a verba do fornecedor compensa e descobre se o defeito está na etiqueta ou na ponta.

Antes de começar

• Seu assistente de IA conectado — veja Conectar o claude.ai.
• Sua conta precisa enxergar o domínio de Vendas.
• Leia As três margens — este tutorial usa duas delas o tempo todo.

Passo 1 — Onde estou perdendo dinheiro?

Onde estamos perdendo dinheiro em junho? Liste os produtos com margem realizada negativa.

4 produtos com margem realizada líquida negativa em junho (sem verba):
1. CHOCOLATE MODELO 650G — −2,3%
2. BISCOITO MODELO 400G — −1,4%
3. BALA MODELO 700G — −0,9%
4. WAFER MODELO 140G — −0,2%

Como ler: essa é a margem oficial do Winthor (rotina 8128) — já descontou devoluções e impostos retidos. O percentual vai de 0 a 100: −2,3% significa que cada R$ 100 vendidos do CHOCOLATE MODELO 650G devolveram R$ 2,30 de prejuízo real. E atenção à base declarada: sem verba. A verba não é rateável por produto — é o próximo passo. Ferramenta: find_negative_realized_margin.

Passo 2 — O fornecedor compensa com verba?

O CHOCOLATE MODELO 650G é do Fornecedor Exemplo S.A. Antes de cortar o produto, olhe o fornecedor inteiro:

Qual a margem realizada do Fornecedor Exemplo S.A. em junho, com e sem verba?

Fornecedor Exemplo S.A. — junho (margem 8128, % de 0 a 100):
- Margem sem verba: 12,1%
- Margem com verba: 15,8%
- Verba no período: R$ 40.000

Como ler: a verba é o dinheiro que o fornecedor devolve por acordo comercial — vem por fora, no boleto do acordo, não na nota. Ela pertence ao fornecedor inteiro: não dá para dizer quanto dela “é” do chocolate. Por isso, a decisão de manter ou cortar um produto no vermelho se toma no agregado: um SKU a −2,3% pode ser parte de um negócio que rende 15,8% com verba. Ferramenta: get_realized_net_margin_by_supplier.

Passo 3 — É defeito de etiqueta?

Falta saber onde o prejuízo nasce: na tabela de preço (cadastro) ou na ponta (desconto, devolução). A margem de cadastro exige região e UF — a base de preços é por região:

O CHOCOLATE MODELO 650G está com margem negativa também no cadastro de preços? Região 2, UF SP.

CHOCOLATE MODELO 650G — cadastro de preços (rotina 8133, região 2 / SP):
- Margem calculada da tabela: −1,8%
- Margem digitada no cadastro: 12,0% (diverge da calculada)
- sem_tributacao: false

Como ler: a margem de cadastro é a da etiqueta — o que a tabela de preço promete hoje, antes de qualquer venda. Aqui ela já nasce negativa: o prejuízo do Passo 1 não foi acidente da ponta, foi a tabela. A divergência entre a margem digitada (12,0%) e a calculada (−1,8%) confirma o erro de cadastro. Dois outros desfechos possíveis:

• Cadastro saudável → o prejuízo veio da ponta: desconto na venda ou devolução. A conversa é comercial, não de cadastro.
• sem_tributacao = true → o produto está vendável sem figura tributária para a UF; a margem exibida assume ICMS zero (superestimada de propósito). Ação: cadastrar a rota fiscal.

Ferramenta: get_catalog_margin_quality.

A matriz de decisão

Cruzando as duas margens, cada produto cai em um destes quatro quadrantes:

E, em qualquer quadrante, sem_tributacao = true é um chamado à parte: cadastre a tributação da UF antes de confiar na margem exibida.

O que fazer com isso

• CHOCOLATE MODELO 650G: cadastro negativo → corrigir a tabela de preço hoje, antes do próximo pedido.
• Os outros três produtos: rodar o Passo 3 para cada um e classificar na matriz.
• Fornecedor Exemplo S.A.: com verba, o agregado rende 15,8% — o produto fica no mix, mas com a etiqueta consertada.

Próximos passos

• get_realized_net_margin_by_product — a margem realizada de todos os produtos, não só os negativos.
• As três margens — etiqueta, caixa e fim do mês, lado a lado.
• Fechamento do mês — o retrato completo onde este caça-prejuízo se encaixa.