Cadastro de promotor
O promotor divulga a loja com um link próprio, pode praticar preços diferentes e recebe comissão sobre o que vender.
Onde fica
Menu lateral → Promotores → Novo.
Quem pode manter
promoters.manage. Registrar repasse exige promoters.register_payout sensível.
Dados do promotor
| Campo | Obrigatório | Descrição | Formato ou exemplo | Observações |
|---|---|---|---|---|
| Nome | sim | Identifica o parceiro. | “Agência Exemplo” | Aparece no relatório de comissões. |
| Status | sim | Se o código está ativo. | Ativo · Inativo | Inativo faz o link cair na loja oficial, sem quebrar a venda. |
| Descrição | não | Anotação interna sobre o parceiro. | Texto livre | — |
| Código | sim | Vai no link de divulgação. | Gerado pelo sistema ou digitado | Dica da tela: “Único por empresa. Vai no link loja.com/?promoter=CODE.” |
| Percentual de comissão | não | Quanto o promotor recebe sobre a base. | 1 (por cento) | Dica da tela: “Aplicada a tudo que o promoter vende dos produtos selecionados.” É um único percentual por promotor. |
| Dados de repasse | não | Como pagar o parceiro. | Chave Pix ou dados bancários | Dica da tela: “Chave Pix / dados bancários para o repasse manual.” |
Regras de preço do promotor
Cada linha define um ajuste de preço. Podem existir várias.
| Campo | Opções | Observações |
|---|---|---|
| Alvo | Tudo (% geral) · Passaporte · Produto | Define o alcance da regra. |
| Item | Seleção do passaporte ou produto | Só quando o alvo não é “Tudo”. |
| Direção | Desconto · Acréscimo | Desconto abaixa; acréscimo sobe. |
| Tipo | % · R$ | Percentual ou valor absoluto. |
| Valor | 10 ou 5.00 | O montante do ajuste. |
Uma regra de passaporte ou produto tem prioridade sobre a regra geral “Tudo”. Sem regra aplicável, vale o preço normal da loja. O ajuste nunca leva o preço abaixo de zero.
O que acontece ao salvar
- O link
?promoter=CÓDIGOpassa a funcionar imediatamente. - Vendas feitas por esse link guardam o promotor e o retrato de preço de tabela × preço praticado.
- A comissão passa a ser apurada no relatório de Comissões de Promotores.
O que impede a conclusão
- Nome em branco.
- Código já usado por outro promotor da mesma empresa.
Como encerrar a parceria
Marque o promotor como Inativo. O link deixa de atribuir vendas — mas continua funcionando como loja oficial, sem erro para o cliente. O histórico e as comissões já apuradas permanecem.
Regras que afetam o dinheiro
- Só a loja online atribui promotor. Vendas do PDV nunca gravam promotor.
- O cupom entra por cima do preço praticado e não altera a base da comissão.
- A comissão nunca incide sobre o excedente: a base é o menor valor entre tabela e praticado.
- Vendas canceladas ficam fora da apuração.
Exemplo de preenchimento (fictício)
| Nome | Agência Exemplo |
|---|---|
| Status | Ativo |
| Código | AGEXEMPLO |
| Percentual de comissão | 10% |
| Dados de repasse | Chave Pix fictícia informada pelo parceiro |
| Regra 1 | Alvo “Tudo” · Direção Desconto · Tipo % · Valor 5 |
| Link de divulgação | https://sua-loja/?promoter=AGEXEMPLO |