Pular para o conteúdo principal

👤 Base de Clientes e Gestão de Tutores

O módulo Clientes e Pets centraliza as informações de contato, perfil civil (Pessoa Física ou Jurídica), histórico de relacionamento, controle financeiro de débitos em aberto e o vínculo direto com os animais atendidos pela clínica ou pet shop.

Base de Clientes e Pets Figura 6: Painel da Base de Clientes e Pets com indicadores de cadastros, filtros por origem/tipo de pessoa e tabela com status de saúde financeira.

📊 Indicadores da Base de Clientes​

No topo da tela de clientes (/clientes), o VetDaily apresenta quatro cartões com métricas consolidadas em tempo real:

  • Clientes Ativos: Total de tutores habilitados para agendamentos e compras.
  • Inativos: Clientes arquivados que não realizam movimentações recentes ou solicitaram descadastro.
  • Total Cadastrado: Somatório geral de registros de clientes na clínica.
  • Novos Clientes (Mês): Volume de novos tutores cadastrados dentro do mês corrente, permitindo acompanhar o crescimento da carteira da clínica.

🔍 Busca Rápida e Filtros Avançados​

Para agilizar o atendimento na recepção em horários de pico, a barra de ferramentas conta com busca preditiva e filtros segmentados:

  1. Campo de Busca Global:
    • Permite localizar o tutor digitando qualquer termo: Nome, CPF/CNPJ (com ou sem pontuação), Nome do Pet, Telefone/WhatsApp ou E-mail.
  2. Origem do Cliente:
    • Filtre por canal de captação (ex: Indicação de Amigo, Instagram, Fachada da Loja, Google, etc.).
  3. Tipo de Pessoa:
    • Alterne entre Pessoa Física e Jurídica, Somente Pessoa Física (PF) ou Somente Pessoa Jurídica (PJ).
  4. Status do Cadastro:
    • Ativos, Inativos ou Todos.

📋 Colunas da Listagem e Saúde Financeira​

A tabela de clientes destaca informações críticas antes mesmo de abrir a ficha do tutor:

  • Tutor / CPF: Nome completo do responsável e documento principal validado.
  • Saúde Financeira:
    • Selo verde Sem pendências: Cliente em dia, sem dívidas ou faturas vencidas.
    • Selo âmbar/vermelho Com pendências: Indica a existência de vendas a prazo em aberto ou faturas atrasadas, alertando a recepção antes de novos procedimentos.
  • Contatos: Telefone principal formatado com máscara e botão para disparo de mensagens.
  • Pets: Quantidade de animais associados ao tutor.
  • Status: Indicador visual Ativo ou Inativo.
  • Ações:
    • Visualizar (Ícone de Olho): Abre a tela completa de detalhes e abas do tutor.
    • Editar (Ícone de Lápis): Abre o formulário para alteração de dados cadastrais.
    • Ativar/Inativar (Ícone Liga/Desliga): Altera a disponibilidade do cadastro sem apagar o histórico.

➕ Cadastrando um Novo Cliente / Tutor​

Ao clicar no botão "+ Novo cliente", o modal de cadastro é exibido com validação instantânea:

  1. Tipo de Pessoa:
    • Pessoa Física (PF): Exige Nome Completo e CPF (validado pelo algoritmo oficial de dígitos verificadores). Campo opcional de RG.
    • Pessoa Jurídica (PJ): Exige Razão Social, Nome Fantasia, CNPJ e Inscrição Estadual.
  2. Canais de Comunicação:
    • Telefone Principal: Com máscara automática para fixo ou celular com nono dígito.
    • Telefone Secundário: Contato de recado ou emergência.
    • E-mail: Utilizado para envio de notas fiscais, receitas digitais e lembretes de vacina.
    • Preferência de Contato: Escolha entre WhatsApp, E-mail, Ligação ou SMS.
  3. Endereço Completo (Integração CEP):
    • Ao digitar o CEP de 8 dígitos, o sistema consulta a base dos Correios e preenche automaticamente Logradouro, Bairro, Cidade e UF, necessitando apenas informar o número e complemento.
  4. Origem e Notas Internas:
    • Registro de onde o cliente conheceu a clínica e observações de relacionamento (ex: "Solicitou sempre confirmação prévia por WhatsApp").

📂 Painel de Detalhes do Tutor (/clientes/:id)​

Ao abrir a visualização detalhada de um cliente, o sistema apresenta um cabeçalho executivo com o avatar do tutor, selos de preferência e quatro abas temáticas de gestão:

Detalhes do Tutor e Abas Figura 7: Tela de detalhes do tutor com cabeçalho de perfil, abas de navegação (Resumo Geral, Dados Cadastrais, Pacientes/Pets e Financeiro).

1. 📋 Aba: Resumo Geral​

Visão consolidada para rápida consulta da recepção:

  • Informações de Contato: Telefones, e-mail e cidade do tutor.
  • Endereço: Visualização do endereço cadastrado.
  • Notas Internas: Observações e alertas operacionais registrados pela equipe.
  • Pets Vinculados:
    • Exibe cards com avatar, nome do pet, raça e sexo.
    • Botão "+ Novo Pet": Abre o formulário de cadastro de animal já com o tutor preenchido.
    • Link "Ficha ->": Direciona imediatamente para o prontuário completo do paciente.

2. 📝 Aba: Dados Cadastrais​

  • Exibe o espelho documental completo do tutor (documentos, contatos e endereços).
  • Permite acionar o botão "Editar Cadastro" no canto superior direito para retificações de endereço, telefone ou documentos.

3. 🐾 Aba: Pacientes / Pets​

  • Lista detalhada de todos os animais pertencentes ao tutor.
  • Mostra a espécie, raça, pelagem, sexo, idade e status de cada pet.
  • Permite vincular novos animais ao mesmo tutor sem sair da página.

4. 💳 Aba: Financeiro do Cliente​

Esta aba centraliza a conta corrente do tutor com a clínica:

  • Saldo Total em Aberto: Montante acumulado de vendas faturadas ou parcelas pendentes.
  • Cobranças em Aberto (open_sales):
    • Tabela com todas as vendas a prazo pendentes de quitação.
    • O operador pode selecionar uma ou várias cobranças simultaneamente por meio das caixas de seleção (checkbox).
    • Recebimento Parcial ou Total: O sistema permite informar o valor exato a ser liquidado para cada venda selecionada.
    • Registrar Pagamento: Selecione a forma de pagamento (Pix, Cartão, Dinheiro), a data da entrada e confirme a quitação.
  • Histórico de Recibos Emitidos:
    • Relação de todos os pagamentos já realizados pelo tutor com data, valor e forma.
    • Estorno Controlado: Permite cancelar e estornar um recebimento mediante inserção obrigatória do motivo para auditoria financeira.