Vendedores¶
Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.
Módulo: Comercial
Menu: Operações → Comercial → Vendedores
Público: Comercial / Operador
Status: Publicado
Atualizado: 2026-09-08
Refs técnicas:UpsertSeller.php·SellerController·SellersPage.tsx· ADR-012
O que faz¶
Lista e mantém o cadastro de vendedores usados em cliente e contrato, com comissão, contato, endereço e hierarquia de supervisão.
Quem pode usar¶
Permissões catalog.seller.read / create / update.
Pré-requisitos¶
- Estar logado no Telvora com filial/contexto válidos.
Passo a passo¶
- Abra Operações → Comercial → Vendedores.
- Use o seletor de campo (Todos, ID, Nome, Documento, Status) + texto e clique Buscar.
- Clique em Novo (ou duplo clique na linha para editar).
- Preencha:
- Nome (obrigatório), CPF/CNPJ, telefone, celular, e-mail, status
- Endereço (CEP, logradouro, número, bairro, estado e cidade)
- Comissão padrão (%)
- Flag Comissão pelo recebimento (quando ativo, a comissão será calculada pelo recebimento)
- Flag Supervisor — se marcado, informe Comissão sobre a equipe (%)
- Supervisor — escolha um vendedor que já seja supervisor
- Salvar.
Regras importantes¶
- Vendedor inativo não aparece nos lookups de cliente/contrato (só ativos).
- Na tela de cadastro a grade mostra ativos e inativos.
- CPF/CNPJ, se informado, precisa ser válido.
- Comissão sobre a equipe só vale quando o flag Supervisor está marcado.
- O dropdown de Supervisor lista apenas vendedores com flag Supervisor ativo.
Erros / avisos comuns¶
| Mensagem / situação | O que fazer |
|---|---|
| Nenhum vendedor encontrado | Limpe a busca ou cadastre com Novo. |
| Nome obrigatório | Informe o nome antes de salvar. |
| CPF ou CNPJ inválido | Corrija o documento. |
| Supervisor inválido | Escolha alguém com flag Supervisor. |
