Promotores
Promotores são parceiros que divulgam a loja com um link próprio. Podem praticar preços diferentes dos da loja oficial e recebem comissão sobre o que venderem.
Como funciona
Linkloja.com/?promoter=CODIGO
Preço praticadoAs regras do promotor ajustam o valor
VendaGuarda o promotor e congela preço de tabela × praticado
Comissão e repasseApuração e registro do pagamento
Quem pode acessar
promoters.view— ver promotores.promoters.manage— cadastrar e editar promotores e suas regras.promoters.view_commissions— ver a apuração de comissões.promoters.register_payoutsensível — registrar um repasse.
Como acessar
Menu lateral → Promotores. O submenu Repasses concentra os pagamentos.
?promoter=CÓDIGO) e a Comissão é o percentual único do parceiro. Um
promotor Inativo não deixa de funcionar: o link continua abrindo a loja, apenas sem atribuir a
venda a ele. O botão Repasses leva ao registro dos pagamentos.
Os nomes de promotores foram substituídos por fictícios.
O cadastro do promotor
- Nome e status (ativo ou inativo).
- Código — único por empresa; vai no link de divulgação. Pode ser gerado pelo sistema ou digitado.
- Percentual de comissão — um único percentual por promotor (não há percentual por produto).
- Dados de repasse — chave Pix ou dados bancários, usados no pagamento manual.
- Regras de preço do promotor — ajustes de valor por alvo.
Regras de preço do promotor
| Campo | Opções |
|---|---|
| Alvo | Tudo (percentual geral), Passaporte ou Produto |
| Item | O passaporte ou produto específico, quando o alvo não é “tudo” |
| Direção | Desconto (abaixa) ou Acréscimo (sobe) |
| Tipo | Percentual (%) ou Valor (R$) |
| Valor | O montante do ajuste |
A regra mais específica vence: uma regra de passaporte ou produto tem prioridade sobre a regra geral “tudo”. Em caso de empate, a decisão é determinística. Sem regra aplicável, vale o preço normal.
Regras de negócio
- Atribuição só na loja online. O PDV nunca grava promotor — existe uma trava no banco para isso.
- Vale a atribuição vigente na compra. O último código acessado na sessão prevalece; navegar sem o parâmetro mantém o último.
- Código inválido ou inativo não quebra a venda — a compra segue como loja oficial, sem promotor. (Diferente de um cupom inválido, que gera erro.)
- O preço praticado é recalculado no servidor.
- O desconto abaixa e o acréscimo sobe, com piso em zero — o ajuste nunca leva o preço abaixo de zero.
- Ordem com cupom: primeiro o ajuste do promotor forma o preço praticado; o cupom entra por cima. O cupom não altera a base da comissão.
- A comissão usa o retrato congelado na venda (preço de tabela e preço praticado), não recalcula preço.
- A comissão nunca incide sobre o excedente: a base é o menor valor entre tabela e praticado; o repasse é o excedente mais o percentual sobre a base.
- Vendas canceladas ficam fora da apuração.
Repasses
A tela Promotores → Repasses registra os pagamentos feitos ao promotor. O registro é manual — o sistema apura o valor devido, mas quem confirma o pagamento é a empresa.
Passo a passo: colocar um promotor para vender
- Cadastre o promotor com nome, status ativo e percentual de comissão.
- Gere ou defina o código de divulgação.
- Configure as regras de preço, se ele praticar valores diferentes.
- Informe os dados de repasse (chave Pix ou dados bancários).
- Entregue o link no formato
https://sua-loja/?promoter=CODIGO. - Acompanhe as vendas pelo relatório de Comissões de Promotores.
- Registre o repasse quando o pagamento for feito.
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
| A venda não foi atribuída ao promotor | O cliente entrou sem o parâmetro ou o código estava inativo | Conferir o link e o status do promotor |
| Venda do PDV não conta para o promotor | Comportamento intencional | Promotor atua apenas na loja online |
| Comissão menor que o esperado | A base é o menor valor entre tabela e praticado | Revisar as regras de preço do promotor |
| Código já existe | Códigos são únicos por empresa | Escolher outro código |
Boas práticas
- Use códigos curtos e memorizáveis — eles vão em material impresso e redes sociais.
- Inative o promotor em vez de excluir: o histórico de vendas continua íntegro.
- Combine claramente com o parceiro como cupons interagem com o preço praticado.
- Faça a conferência dos repasses pelo relatório de comissões.