Visão geral
O cadastro de clientes não fica isolado - ele alimenta Vendas, PDV, Orçamentos, Serviços, Agendamentos, Ordens de Serviço e Entregas. Entender como o cliente é selecionado e criado nesses fluxos agiliza o dia a dia.
Legenda: Seletor de cliente com busca, fixados e botão de novo cliente rápido.
Quando utilizar
- Para vincular cliente a uma venda, orçamento, pedido ou serviço
- Para criar cliente rápido durante o atendimento (sem sair do fluxo)
- Para usar endereço do cliente como padrão em entrega
- Para consultar histórico do cliente enquanto atende
Fluxo comum: Seletor de Cliente
Na maioria dos módulos (Vendas, PDV, Orçamentos, Serviços, Agendamentos, OS), ao iniciar um novo atendimento, abre o Seletor de Cliente com:
- Busca - digite nome, e-mail ou telefone; filtra em tempo real
- Fixados / Recentes - clientes marcados como favoritos ou usados recentemente aparecem no topo
- Lista completa - todos os clientes ativos (rolagem infinita)
- Botão "Novo cliente" (+) - cria cliente rápido (nome, e-mail, telefone)
- Botão "Remover" - limpa seleção (venda para consumidor final)
Dica
> O seletor só mostra clientes com status "Ativo". Inativos, bloqueados e arquivados não aparecem. Para usar um inativo, reative antes na lista de Clientes.
Vendas / PDV / Orçamentos
Selecionar cliente existente
- Inicie Nova Venda, Novo Pedido ou Novo Orçamento.
- No campo Cliente, clique para abrir o seletor.
- Busque ou escolha da lista de fixados/recentes.
- Cliente selecionado → nome aparece no cabeçalho da venda.
Criar cliente rápido (durante a venda)
- No seletor, clique no botão "+" (Novo cliente).
- Preencha: Nome (obrigatório), E-mail, Telefone.
- Salva → cliente criado com status Ativo, tipo Pessoa Física (padrão), sem endereço/documentos.
- Cliente já fica selecionado na venda.
Importante
> Cliente rápido não tem CPF/CNPJ, endereço, dados fiscais. Complete depois em Clientes > Editar se for emitir nota fiscal.
Consumidor final (sem cliente)
- Clique Remover (X) no cliente selecionado.
- Venda fica como "Consumidor final" - não vincula a ninguém, não exige CPF na nota (exceto se valor > limite legal).
Endereço de entrega
- Se o cliente tem endereço principal cadastrado, ele pré-preenche o endereço de entrega da venda.
- Pode alterar na hora (não salva no cadastro do cliente).
Serviços / Agendamentos
Agendar com cliente
- Em Agendamentos > Novo agendamento.
- Etapa Cliente - abra seletor, escolha ou crie rápido.
- Cliente selecionado → aparece no card do agendamento no calendário.
- No dia do atendimento, clique no agendamento > Ver detalhes do cliente abre a ficha completa.
Cliente no agendamento recorrente
- Cliente fixo toda semana? Crie agendamento recorrente semanal com o mesmo cliente.
- O sistema replica o agendamento mantendo o cliente vinculado.
Ordens de Serviço (OS)
Criar OS para cliente
- Em Ordens de Serviço > Nova OS.
- Campo Cliente - seletor padrão (busca, fixados, novo rápido).
- Cliente vinculado → aparece no cabeçalho da OS.
- Endereço principal do cliente pré-preenche o endereço da OS (se for visita técnica).
Histórico de OS do cliente
- No detalhe do cliente, não há aba de OS diretamente.
- Para ver OSs do cliente: vá em Ordens de Serviço > use a busca pelo nome do cliente.
Entregas
Endereço do cliente como padrão
- Ao criar Nova Entrega (ou no fluxo de venda com entrega), o campo Endereço busca no cadastro do cliente.
- Se cliente tem endereço principal → preenche automaticamente.
- Se tem endereço de cobrança diferente → use o botão "Usar endereço de cobrança" se aplicável.
Marketplace / Vitrine
Cliente logado no site
- Quando cliente compra logado na vitrine/marketplace, o sistema vincula automaticamente o `marketplace_user_id` ao cadastro do cliente (pelo e-mail).
- Pedidos feitos logados aparecem no histórico do cliente (aba Pedidos no detalhe).
- Avaliações (reviews) do cliente aparecem na aba Avaliações.
Cupons de aniversário
- Cupom gerado no card de aniversário → fica disponível para o cliente usar no checkout do marketplace.
- Cliente recebe via WhatsApp/notificação e aplica no carrinho.
Dicas importantes
- Sempre selecione o cliente antes de fechar venda/OS - garante histórico, nota fiscal correta, endereço de entrega e vales-compra.
- Cliente rápido = complete depois - nome+e-mail+telefone resolve na hora; volte em Clientes para por CPF, endereço, dados fiscais.
- Fixados - marque clientes frequentes como fixados (estrela no seletor) para aparecerem no topo.
- Consumidor final - use só para vendas rápidas de balcão sem nota fiscal nominal.
- Endereço de entrega - alterar na venda não altera o cadastro do cliente. Para mudar definitivo, edite em Clientes.
Problemas comuns
| Problema | Causa | Solução |
|---|---|---|
| Cliente não aparece no seletor | Status Inativo/Bloqueado/Arquivado | Ative/desarquive em Clientes |
| Cliente rápido não emite nota fiscal | Falta CPF/CNPJ e endereço | Edite o cliente depois e complete dados fiscais |
| Endereço de entrega não preenche | Cliente sem endereço principal | Cadastre endereço na aba Endereço do cliente |
| Pedido do site não aparece no histórico | Cliente não logou ou e-mail diferente | Verifique se `marketplace_user_id` está vinculado no cadastro |
| Vale-compra não aparece no PDV | Status não é "Disponível" | Confira no detalhe do cliente; só disponíveis somam |
Perguntas frequentes
Posso obrigar seleção de cliente em toda venda?
Não há configuração nativa para obrigar. Treine a equipe. Para nota fiscal, sem cliente = consumidor final (limite de valor sem CPF).
Cliente criado no PDV aparece na lista de Clientes?
Sim, imediatamente. Status Ativo, tipo Pessoa Física, sem documento/endereço.
Consigo ver o limite de crédito do cliente na venda?
Não há "limite de crédito" nativo. Use Vales-compra como crédito pré-pago. Para pós-pago (faturamento), controle externo ou observação interna.
Como vinculo um cliente do marketplace ao ERP?
Automático: se e-mail do pedido logado = e-mail do cliente no ERP, o sistema vincula `marketplace_user_id`. Se não vinculou, edite o cliente e confira se e-mails batem.
Posso ter preços diferentes por cliente?
Não há tabela de preços por cliente nativa. Use cupons personalizados ou observação interna com "Preço especial: X%".