Faturado, vendido e líquido
Três números que parecem sinônimos — e não são. billed_value é tudo que saiu do caminhão; sale_value é o que virou dinheiro; net_revenue é o que ficou depois das devoluções. Saber qual é qual evita a briga de números na reunião.
Faturado (billed_value): tudo que saiu do caminhão
Tudo que saiu com nota fiscal — incluindo a bonificação, valorada a preço de tabela. É a medida de volume expedido, não de receita. Se a pergunta é “quanto entrou de dinheiro”, este não é o número.
A bonificação é a amostra grátis
Bonificação é mercadoria entregue sem cobrar: saiu do estoque, tem custo real, mas receita zero — a amostra grátis que você deixou no cliente. O Winthor mistura tudo na movimentação; o OpenThor separa. Se ninguém separar, a bonificação infla o “faturamento” e derruba a margem sem explicação.
Vendido (sale_value): o que virou dinheiro
Só o que foi de fato vendido — a bonificação fica de fora. É a base de receita bruta de devoluções: uma venda devolvida depois ainda está aqui.
Líquido (net_revenue): vendas menos devoluções
net_revenue = vendas menos devoluções de cliente, sem abater impostos. A devolução entra na conta na data da devolução, não na data da venda original.
Uma venda de maio devolvida em junho abate junho. O mês fechado de maio não muda — e o mês corrente parece pior do que a venda dele sozinha sugere. Não é erro: é a régua de “quanto realmente ficou” em cada mês.
Onde ver: get_sales_summary traz sale_value, return_value e net_revenue lado a lado. Nos rankings, comparar sale_value com net_revenue mostra quem “vende e volta” — por exemplo em get_top_sales_reps.
Um exemplo do começo ao fim (fictício)
A história curta: você emitiu uma nota de R$ 100; o cliente devolveu R$ 30 de mercadoria; o seu mês valeu R$ 70 — mesmo que a nota original continue dizendo R$ 100.
Agora o mês inteiro da Distribuidora Modelo Ltda, em junho (números inventados):
| Número | Valor (fictício) | O que inclui |
|---|---|---|
billed_value | R$ 2.530.000 | Tudo que saiu do caminhão: R$ 2.450.000 de venda + R$ 80.000 de bonificação a preço de tabela. |
sale_value | R$ 2.450.000 | O que virou dinheiro (sem bonificação) — bruto de devoluções. |
return_value | R$ 85.000 | Devoluções recebidas no mês, contadas na data da devolução. |
net_revenue | R$ 2.365.000 | Vendas − devoluções, sem abater impostos. |
As devoluções comeram cerca de 3,5% da venda do mês (base: return_value ÷ sale_value) — acima de 2% costuma merecer investigação.
Existem três “líquidos” — e eles nunca batem
net_revenue (vendas − devoluções, sem impostos) não é a “venda líquida” da rotina 8128 (que abate também ST/FECP) e não é a base fiscal das rotinas 8074/8062 (que abatem ST/IPI). Três réguas diferentes, três números diferentes — nenhum “errado”. Toda resposta do OpenThor declara qual base está usando; declare a sua também quando levar o número para a reunião.
A venda líquida da 8128 vive na página As três margens. As bases fiscais 8074/8062 não são servidas pelo OpenThor — confira essas direto no Winthor.
Esta página ajudou? Conte para a gente — lemos tudo.