Visão geral
A tela de Detalhes do Cliente centraliza tudo o que você precisa saber sobre um contato: dados cadastrais, indicadores de compra, histórico de pedidos, vales-compra, endereços e observações da equipe.
Legenda: Aba Dados Gerais com KPIs, informações cadastrais, endereços e vales-compra.
Quando utilizar
- Para ver o perfil completo de um cliente antes de atender
- Para consultar histórico de compras (pedidos, valores, status)
- Para conferir endereços, documentos e observações internas
- Para verificar vales-compra disponíveis
- Para acessar pedidos e serviços vinculados
Como fazer
1. Abrir os detalhes
Da lista de Clientes:
- Visualização Tabela: clique na linha ou no botão Ver detalhes (ícone de olho)
- Visualização Grade (cards): clique no card ou no menu ⋮ > Ver detalhes
De outros módulos:
- Em Vendas/PDV/Orçamentos: clique no nome do cliente já selecionado
- Em Serviços/Agendamentos/OS: clique no cliente no detalhe do agendamento/OS
2. Aba "Dados Gerais" - Visão 360°
#### KPIs do cliente (topo)
| Indicador | O que mostra |
|---|---|
| Pedidos | Total de pedidos não cancelados |
| Total Gasto | Soma dos valores (pedidos pagos/entregues) |
| Valor médio | Total Gasto ÷ Pedidos |
| Última Compra | Data do pedido mais recente |
Dica
> Use esses números para classificar o cliente: "Top 10%", "Cliente em risco (sem compra > 90 dias)", "Novo (1º pedido)".
#### Dados cadastrais
- Nome, status (badge colorido), tipo (PF/PJ), ID curto (#ABC12)
- CPF ou CNPJ (formatado)
- Data de nascimento (se preenchida)
- E-mail, celular, telefone fixo, site
- Cliente desde - data do primeiro cadastro
#### Endereços
- Endereço principal - usado em entregas e notas fiscais
- Endereço de cobrança - se diferente do principal (aparece separado)
#### Observações internas
- Caixa laranja com anotações da equipe (ex: "Prefere WhatsApp", "Alérgico a látex")
- Só sua equipe vê - não vai para o cliente
#### Vales-compra (Crédito da loja)
Lista de vales gerados para este cliente:
- Valor original / Utilizado / Restante
- Status: Disponível (verde) · Utilizado (cinza) · Expirado (vermelho)
- Data de criação e validade (se houver)
- Clique para ver detalhes do vale
Legenda: Lista de vales-compra com saldo restante e status.
3. Aba "Pedidos" - Histórico de compras
Tabela com todos os pedidos do cliente (não cancelados), ordenados do mais recente para o mais antigo:
| Coluna | Descrição |
|---|---|
| Pedido | ID curto (#ABC12) - clique para abrir o pedido |
| Total | Valor do pedido |
| Status | Pago, Pendente, Enviado, Entregue, Cancelado, etc. |
| Canal | Manual, PDV, Marketplace, Loja Virtual, etc. |
| Data | Data e hora da criação |
Ações:
- Clique no ID do pedido → abre tela de detalhes do pedido
- Ordene clicando nos cabeçalhos (Data, Total, Status, Canal)
- Paginação automática (8 por página)
Importante
> A aba Pedidos agrega pedidos feitos pelo `customer_id` do ERP OU pelo `user_id`/`marketplace_user_id` vinculados (conta do cliente no marketplace). Por isso, compras feitas pelo cliente logado no site também aparecem aqui.
4. Aba "Avaliações" - Reviews do Marketplace
Se o cliente avaliou produtos/loja no marketplace, aparecem aqui:
- Estrelas (1 a 5)
- Comentário
- Data
- Produto avaliado
5. Card de Aniversário (quando aplicável)
Se o cliente tem data de nascimento cadastrada e o aniversário é hoje ou próximos dias, um card roxo destaca no topo (aba Dados Gerais, desktop) ou no início (mobile/tablet):
Ações rápidas (plano Crescer):
- Criar cupom → gera cupom de aniversário e abre tela de Cupons
- Enviar WhatsApp → abre wa.me com mensagem pronta + cupom
- Enviar notificação → push/app para o cliente (1x por ano)
Dicas importantes
- KPIs ajudam na abordagem - cliente com "Total Gasto alto + Última compra antiga" = reativação
- Vales-compra - antes de fechar venda, confira se o cliente tem saldo disponível
- Observações - leia antes de ligar/visitar; evita repetir informações
- Endereço de cobrança - confira se nota fiscal deve ir para endereço diferente
- Pedidos do marketplace - aparecem junto dos manuais; filtre pelo canal se precisar separar
Problemas comuns
| Problema | Causa | Solução |
|---|---|---|
| Pedido não aparece no histórico | Feito com e-mail/CPF diferente do cadastrado | Verifique se `marketplace_user_id` ou `user_id` estão vinculados no cadastro |
| Vale-compra não aparece | Status "Expirado" ou "Utilizado" integralmente | Filtre por status; expirados não somam no saldo |
| Aniversário não destaca | Data de nascimento não preenchida | Edite o cliente e preencha a data |
| KPIs zerados | Cliente nunca fez pedido pelo ERP | Compras só no marketplace antigo podem não agregar; contate suporte |
Perguntas frequentes
Posso ver agendamentos e ordens de serviço do cliente aqui?
Não diretamente nesta tela. Em Serviços > Agendamentos ou Ordens de Serviço, use a busca pelo nome do cliente para filtrar os dele.
O "Total Gasto" inclui pedidos cancelados?
Não. Só pedidos com situação diferente de "cancelado".
Como sei se o cliente tem vale-compra disponível?
Na aba Dados Gerais, a seção Vales-compra mostra badges: verde = disponível, cinza = usado, vermelho = expirado. O badge no topo da seção mostra o saldo total.
Consigo editar o cliente a partir dos detalhes?
Sim, botão Editar cliente no cabeçalho (desktop) ou no menu de ações (mobile).
O cliente vê as observações internas?
Não. Observações são só para sua equipe.