Rede de Representantes
Recrute, contrate, dê um portal e gerencie sua rede de representantes comerciais — com crédito, estoque, fiscal, comissões e premiações, tudo integrado na plataforma.
O que é
Um módulo para a indústria/distribuidora gerenciar sua rede de representantes externos. Diferente de ferramentas genéricas de força de vendas, aqui tudo está no mesmo tenant: o representante consulta estoque em tempo real, vê o limite de crédito e o score do cliente, faz o pedido (que vira Pedido de Venda na indústria), acompanha a nota fiscal e o rastreio da entrega, e tem comissões, metas e premiações — com o contrato assinado digitalmente.
Fluxo completo
Acessos & telas
| Tela | Rota | Quem usa |
|---|---|---|
| Gestão da rede | /representantes (CRM → Vendas → 🤝 Representantes) | Gestor comercial |
| Página pública de recrutamento | /seja-representante?slug=<form> | Candidatos (site do cliente) |
| Assinatura do termo | /signature/sign/<token> | Representante aprovado |
| Portal do representante | /rep | Representante (login próprio) |
1. Recrutamento
Em /representantes → aba 📋 Formulários:
/seja-representante?slug=…) e coloque no site da sua empresa ("Seja um representante").2. Contrato & assinatura (Blodoc + Signature)
Ao aprovar uma candidatura, o sistema:
- Gera o termo de representação a partir de um template Blodoc (blocos: objeto, conduta, comissionamento, vigência, LGPD, anticorrupção, assinaturas), preenchido com os dados do representante;
- Dispara a assinatura digital pelo módulo Signature (link
/signature/sign/…, com hash e evidências); - Quando o representante assina, ele é ativado automaticamente.
node prisma/seeds/seed-blodoc-contrato-representante.mjs. Para editar o texto do termo, ajuste os blocos no Blodoc.3. Login & carteira
Na aba 🧑💼 Representantes, em cada representante:
- 🔑 Login cria o usuário (papel
REPRESENTANTE) com senha provisória — envie as credenciais; ele troca no 1º acesso. - 👥 Carteira vincula os clientes que ele atende. O representante só enxerga e vende para a própria carteira.
4. Portal do representante & pedido
O representante acessa /rep e tem:
- Clientes — sua carteira com limite de crédito disponível, score e situação (bloqueado/alerta/ok).
- Catálogo — produtos com estoque em tempo real e preço já com a política comercial aplicada.
- Pedido — monta o carrinho, escolhe o cliente e envia → vira um Pedido de Venda "aguardando liberação de crédito" na indústria.
- Pós-venda — acompanha o status do pedido, a 2ª via da NF e o rastreio da entrega.
5. Comissões
Aba 💰 Comissões:
- Crie as regras (ex.: 5% sobre faturamento; regras específicas por representante têm prioridade sobre a geral; aceleradores por % de meta).
- Escolha o mês e Apure o período — o sistema calcula sobre os pedidos faturados.
- Aprove (com bônus/ajuste opcional) e depois Pague — gera um título a pagar no Financeiro.
O representante vê o extrato em /rep → 💰 Comissões.
6. Ranking & premiações
Aba 🏆 Ranking: veja o ranking por faturamento, % da meta ou nº de pedidos (com níveis Bronze/Prata/Ouro). Crie campanhas de premiação com prêmios por posição e apure os ganhadores. O representante vê o ranking e as premiações na tela inicial do portal.
7. Logística & política comercial
Aba 🚚 Logística:
- Rastreio: para cada pedido de representante, defina transportadora, código e status, e adicione eventos. Para Correios, a URL de rastreamento é montada automaticamente. O representante acompanha no detalhe do pedido.
- Políticas comerciais: crie regras de preço/desconto por região, cliente ou tabela por SKU. Elas são aplicadas automaticamente no catálogo do representante (prioridade: específica do rep > geral).
Conceitos
| Termo | O que é |
|---|---|
| Carteira | Conjunto de clientes que um representante atende (define o que ele vê) |
| Score de aderência | Nota do candidato no formulário de recrutamento (por pesos das respostas) |
| Crédito disponível | Limite do cliente − títulos a receber em aberto |
| Política comercial | Regra de preço/desconto aplicada automaticamente no pedido |
| Apuração de comissão | Cálculo por representante e período sobre pedidos faturados |
| Nível | Bronze/Prata/Ouro pela % da meta atingida |
FAQ
O representante vê clientes de outros representantes?
Não. Cada um enxerga apenas a própria carteira.
O pedido do representante já emite nota?
Não automaticamente — ele cria um Pedido de Venda que a indústria libera (crédito/estoque) e fatura. A 2ª via da NF aparece no portal quando autorizada.
Posso editar o texto do contrato?
Sim — edite os blocos do template "Termo de Representação Comercial" no Blodoc.
A comissão é paga automaticamente?
Não. Você aprova e marca como paga; o sistema gera o título a pagar no Financeiro para o pagamento ser conduzido lá.