Metas: os cinco quadros brancos
O Winthor grava a mesma meta em até cinco níveis. É a mesma meta escrita em cinco quadros brancos diferentes — quem soma os quadros acha que a meta é até 5× maior do que ela é.
Os cinco níveis
| Nível | Código | O que é |
|---|---|---|
| Empresa | FL | A meta total da empresa no mês. |
| Supervisor | SV | A mesma meta, repartida por equipe. |
| Vendedor | M | A mesma meta, repartida por RCA. |
| Vendedor × fornecedor | F | A mesma meta, repartida por RCA e indústria. |
| Gerente | GC | Nível gerencial — não servido pelo OpenThor. |
Os níveis se conferem entre si: a soma das metas dos supervisores bate com a da empresa; a soma dos vendedores também. Exemplo fictício: se a meta de junho da Distribuidora Modelo é R$ 2.500.000 (nível empresa), os quadros dos supervisores somam R$ 2.500.000, e os dos vendedores também.
Somar empresa + supervisores + vendedores + fornecedores daria perto de R$ 10.000.000 — um número que não existe. Cada quadro branco já contém a meta inteira.
Atingimento: bruto ou líquido?
pct_attained usa o realizado bruto de devoluções — é a convenção da rotina 8055, e o número que o seu time já conhece. pct_attained_net desconta as devoluções. Os dois vêm na escala 0–100.
Dá para “bater a meta” no bruto e não no líquido. Exemplo fictício, base declarada:
- Meta de junho: R$ 2.500.000.
- Realizado bruto: R$ 2.450.000 →
pct_attained= 98% (base bruta, convenção 8055). - Devoluções do mês: R$ 85.000 → realizado líquido R$ 2.365.000 →
pct_attained_net= 94,6% (base líquida de devoluções).
Nenhum dos dois está errado. Só declare qual base você está usando antes de anunciar o resultado na reunião.
Positivação como meta
Além do valor em R$, a meta pode pedir clientes positivados: customers_target (quantos clientes a meta pede que comprem) contra customers_realized (quantos compraram). Exemplo fictício: meta de 800 clientes, 742 realizados.
Na visão por fornecedor, a positivação realizada não é somada entre fornecedores — um cliente que compra de duas indústrias contaria duas vezes. O que “positivado” significa (e o que não significa) está em Positivação: carteira e movimento.
As ferramentas pinam um nível — de propósito
Cada ferramenta de meta responde por um único nível. Assim você não soma quadros por engano.
| Sua pergunta | Nível | Ferramenta |
|---|---|---|
| “A empresa bateu a meta do mês?” | Empresa (FL) | company_goal |
| “Como está a meta do vendedor João?” | Vendedor (M) | rep_goal_attainment |
| “E a equipe da supervisora Marina?” | Supervisor (SV) | supervisor_goal_attainment |
| “E a meta do Fornecedor Exemplo S.A.?” | Vendedor × fornecedor (F, agregado) | supplier_goal_attainment |
Em todas, gap_value é quanto falta para a meta — em R$, na base bruta.
Na API crua, fixe o nível você mesmo
O endpoint cru /v1/goals devolve as linhas de todos os níveis. Sem o filtro goal_level, uma exportação para planilha soma a mesma meta várias vezes — a armadilha dos cinco quadros, agora em CSV. Sempre fixe goal_level. Sintaxe de filtro: Sintaxe de consulta.
Esta página ajudou? Conte para a gente — lemos tudo.