Documentação / Código Vendedor / Ranking e comissões

Ranking e comissões

A aba Ranking é o coração do módulo: quem vendeu, quanto vendeu de verdade (líquido), e o número pronto para aplicar o seu percentual de comissão.

O que a tela mostra

No topo, dois cartões de resumo do período:

  • Vendas líquidas atribuídas — o total que passou por algum vendedor;
  • Pedidos atribuídos — quantos pedidos tiveram vendedor.

Abaixo, a tabela com o pódio:

sualoja.com.br/wp-admin — Marketing → Vendedores → Ranking
VendedorPedidosBrutoVendas líquidasTicket médio
🥇 Maria Silva64R$ 21.130R$ 18.400R$ 288
🥈 João Costa41R$ 13.870R$ 12.150R$ 296
🥉 Ana Rocha28R$ 9.410R$ 8.220R$ 294
Ranking do mês com vendas líquidas por vendedor. As telas podem variar conforme a versão.

As colunas completas: Vendedor (nome e código), Pedidos, Bruto, Frete, Reembolsos, Vendas líquidas — o número que importa para comissão — e Ticket médio (líquido ÷ pedidos).

Como a venda líquida é calculada

Venda líquida = Total do pedido − Frete − Reembolsos. Exatamente a mesma conta do Pixel Reports — os números dos dois painéis batem entre si.

Um detalhe importante sobre reembolsos: se um pedido de março for reembolsado em abril, o desconto entra no ranking de março — o mês em que a venda aconteceu. Assim o vendedor não fica com crédito de uma venda que voltou.

Filtrar por período

Use o seletor no topo da tabela: últimos 7 / 30 / 90 dias, Este mês, Mês anterior, ou Personalizado (data inicial e final). Para fechar comissão, o mais comum é usar Mês anterior nos primeiros dias do mês seguinte.

Fechando a comissão no fim do mês

  1. Abra a aba Ranking

  2. Selecione o período “Mês anterior”

  3. Olhe a coluna Vendas líquidas de cada vendedor

  4. Aplique o seu percentual de comissão sobre esse valor

    Exemplo: se a Maria fez R$ 18.400 em vendas líquidas e a comissão é 5%, ela recebe R$ 920 no mês.

O percentual é você quem define, fora do módulo — o Código Vendedor entrega o número confiável; a política de comissão é sua.

Corrigir ou atribuir um vendedor num pedido

Nem toda venda passa pelo checkout online — às vezes a consultora fecha no WhatsApp e o pedido é lançado manualmente, ou o cliente esqueceu de marcar. Para resolver, abra o pedido em WooCommerce → Pedidos e localize o seletor Vendedor, ao lado dos dados de cobrança:

  • escolha o vendedor certo na lista (ou — Sem vendedor — para remover);
  • clique em Atualizar no pedido.

A atribuição entra no ranking na hora — e toda alteração fica registrada nas notas do pedido, com quem fez a mudança e quando. Isso evita discussão depois.

Documentação do Código Vendedor · escrita com base na versão 0.1.0. As telas ilustradas podem variar conforme a versão instalada na sua loja.