Detalhes do Cliente — Perfil, Pedidos e Configurações

Visão Geral

A tela de **Detalhes do Cliente** é o painel centralizado para gerenciar todas as informações, métricas, pedidos e configurações de um cliente específico. Ela permite ao administrador ter uma visão completa do histórico, comportamento e desempenho do cliente.

Como Acessar

1. No menu lateral, clique em **Clientes**

2. Na lista de clientes, clique em **Abrir Cliente** ao lado do cliente desejado

3. Você será direcionado para o painel do cliente

Ou navegue diretamente para: `https://entregasexpressas.com.br/admin/customers/{ID_DO_CLIENTE}`

Abas Principais

O painel do cliente possui **4 abas principais**:

1. 📊 Dashboard

Exibe métricas consolidadas e análises visuais do desempenho do cliente.

**Informações Gerais:**

**Saldo da Carteira:** valor pré-pago disponível

**Último Pedido:** data e hora do pedido mais recente

**Primeiro Pedido:** data e hora do primeiro pedido realizado

**Total Geral:** valor total movimentado pelo cliente historicamente

**Métricas do Período Selecionado:**

Total de Pedidos

Pedidos Cancelados

Ticket Médio

% Cancelamento

Tempo Médio de Entrega

Serviço mais Usado (Moto, Carro, etc.)

Método de Pagamento Mais Usado

Total em Comissão

Ranking no Período (posição entre os clientes)

**Gráficos e Visualizações:**

**Pedidos por Dia:** gráfico de linha mostrando volume diário

**Distribuição de Atendimento por Entregador:** gráfico de pizza

**Mapa de Calor das Entregas:** visualização geográfica das entregas

**Matriz de Entregas (Dia x Hora):** heatmap mostrando concentração de pedidos por dia da semana e hora do dia

**Filtro de Período:**

Campos "Data Inicial" e "Data Final" permitem ajustar o período de análise

Clique em **Aplicar Filtro** para atualizar as métricas

---

2. 📦 Pedidos do Cliente

Lista todos os pedidos realizados pelo cliente, com busca e paginação.

**Informações de Cada Pedido:**

**Número do Pedido** (ex: #9952) com link para detalhes

**Cliente:** nome do cliente

**Status:** badge colorido indicando o estado atual (Cancelado, Finalizado, etc.)

**Abertura:** data e hora de criação do pedido

**Finalização:** data e hora de conclusão (quando aplicável)

**Endereços:** locais de coleta e entrega com visualização resumida

**Entrega:** informações sobre entregador e horários

**Funcionalidades:**

**Buscar:** campo de pesquisa para filtrar pedidos

**Abrir Pedido:** botão azul que leva aos detalhes completos do pedido

**Paginação:** navegação entre páginas de resultados

---

3. 💰 Carteira Digital

Gerencia o saldo pré-pago do cliente e histórico de transações.

**Informações Exibidas:**

**Saldo atual:** valor disponível em reais

**Botões de Ação:**

- **Adicionar Saldo:** (verde) para creditar valor na carteira

- **Remover Saldo:** (vermelho) para debitar valor

**Histórico de Transações:**

Tabela com colunas: Data, Status, Descrição, Vr. Creditado, Vr. Debitado

Filtro por período (mês/ano)

Mensagem "Nenhuma transação no período" quando vazio

**Observação:** A carteira pré-paga permite que clientes paguem pelos pedidos com saldo previamente carregado, sem necessidade de pagamento individual por entrega.

---

4. $ Faturas

*(Seção para gerenciamento de faturas e cobranças — ainda em desenvolvimento ou indisponível na versão atual)*

---

Editar Cliente

Ao clicar em **Editar Cliente**, você acessa uma tela com **5 abas de configuração**:

🧑 Dados

Informações básicas do cadastro:

**Logo:** upload de imagem (deixe em branco para manter)

**Nome:** nome de exibição do cliente

**Email:** endereço de e-mail

**Telefone:** contato telefônico

**Praça:** cidade/região de atuação (dropdown)

**CPF:** número do CPF (para pessoas físicas)

**CNPJ:** número do CNPJ (para empresas)

**Razão Social:** nome empresarial

**Nome Fantasia:** nome comercial

**Endereço Padrão:** endereço de coleta/entrega padrão (com autocomplete Google Maps)

**Status de envio padrão:**

- **Padrão (cliente escolhe):** cliente define o status manualmente

- **Quando configurado:** pedido é enviado automaticamente após seleção de pagamento

🏍️ Entregadores

Gerencia quais entregadores podem atender pedidos deste cliente.

Lista de entregadores vinculados

Opções para adicionar/remover entregadores da lista

🔐 Permissões

Define permissões especiais e acesso do cliente no portal.

Configurações de acesso ao portal do cliente

Permissões de funcionalidades específicas

💲 Tabela de Preços

Configura valores personalizados para este cliente.

Preços por tipo de serviço (Moto, Carro, etc.)

Descontos ou acréscimos específicos

Regras de cobrança customizadas

📱 WhatsApp

Configurações de integração com WhatsApp.

Número de WhatsApp vinculado

Notificações automáticas

Templates de mensagens

---

Botões de Ação

No Painel Principal

**Editar Cliente:** abre a tela de edição

**Excluir Cliente:** remove o cliente do sistema (cuidado!)

Na Edição

**Salvar Cliente:** salva todas as alterações

**Cancelar:** descarta mudanças e volta

---

Dicas Importantes

⚠️ **Saldo da Carteira:** Sempre verifique o saldo antes de permitir novos pedidos pré-pagos

📊 **Análise de Desempenho:** Use o Dashboard para identificar clientes VIP e padrões de uso

🔍 **Busca de Pedidos:** Na aba Pedidos, use o campo de busca para encontrar rapidamente por número ou endereço

🗺️ **Mapa de Calor:** Útil para identificar áreas de maior demanda do cliente

⏰ **Matriz Dia x Hora:** Ajuda a prever picos de demanda e otimizar alocação de entregadores

---

Próximos Passos

[Criar um Novo Cliente](#)

[Gerenciar Pedidos do Cliente](#)

[Adicionar Saldo na Carteira Digital](#)

[Configurar Tabela de Preços Personalizada](#)

---

📌 **Nota:** As configurações exibidas podem variar conforme o plano contratado e permissões do administrador.