openthorDocumentação

Positivação: carteira e movimento

Existem dois jeitos de contar “clientes que compraram” — e eles não se misturam. Um mede a cobertura da sua carteira no mês corrente; o outro conta compradores distintos em qualquer período. Os dois números quase nunca coincidem, e os dois estão certos.

O modelo carteira: a taxa de cobertura

A pergunta que ele responde: de todos os clientes que costumam comprar de você, quantos compraram este mês?

A conta: clientes positivados no mês corrente ÷ base ativa (quem comprou nos últimos 12 meses). É o principal indicador de cobertura comercial.

  • A janela é fixa no mês corrente. Pedir “positivação de março” não muda a janela — o modelo só conhece o mês em andamento.
  • A base ativa vem do movimento, não do cadastro. Conta quem comprou de fato nos últimos 12 meses — não quem está cadastrado.
  • RCAs “pseudo” ficam de fora por padrão — venda direta e carteiras órfãs são baldes operacionais, não vendedores, e distorceriam a taxa.

Ferramentas: get_positivacao_summary, get_positivacao_by_rep e get_positivacao_by_supervisor.

O modelo movimento: compradores distintos

A pergunta que ele responde: quantas caras diferentes passaram no caixa no período?

É a métrica customers dos rankings de venda — por exemplo em get_sales_by_supplier. Ela aceita qualquer período (uma semana, um trimestre, um ano) e conta clientes distintos que compraram nele.

customers NÃO é positivação de carteira

O customers de um ranking não tem base ativa nem taxa — é uma contagem. Usar esse número como “positivação” mistura os dois modelos e produz comparações que nunca vão fechar.

Dois números diferentes — os dois certos

Um exemplo fictício com o RCA João (código 42), da Distribuidora Modelo Ltda:

  • Carteira: João tem base ativa de 120 clientes (compraram nos últimos 12 meses); 78 compraram este mês → positivação de 65% (modelo carteira, mês corrente).
  • Movimento: no trimestre, 96 clientes distintos compraram com o João (modelo movimento, período pedido).

96 é maior que 78 e nenhum está errado: o trimestre é uma janela maior que o mês, e a contagem de movimento não olha a base ativa. São perguntas diferentes — não compare uma resposta com a outra.

Quem aparece na conta

  • Supervisor em branco (NULL) = “sem supervisor”. É um balde honesto: as vendas de RCAs sem supervisor não somem — elas aparecem nesse grupo.
  • Buckets de canal não são pessoas. A lista de supervisores pode incluir unidades organizacionais (canais de venda). Não trate cada linha como um gestor.
Dica

Positivação também pode ser meta (customers_target × customers_realized) — veja Metas: os cinco quadros brancos.