Módulo de Clientes
O módulo de Clientes permite cadastrar, visualizar, editar e organizar os pagadores das suas cobranças. Ao vincular cobranças a clientes cadastrados, você melhora a rastreabilidade e os relatórios financeiros.
Acesso: Menu lateral → Clientes (/clientes)
Listagem de Clientes
A tela principal exibe todos os clientes cadastrados com as colunas:
| Coluna | Descrição |
|---|---|
| Nome | Nome completo ou razão social |
| CPF / CNPJ | Documento fiscal do cliente |
| Endereço de e-mail para notificações | |
| Telefone | Número de contato |
| Status | Ativo, Inativo ou Bloqueado |
| Ações | Ver detalhes, Editar, Excluir |
Filtros Disponíveis
- Busca por nome ou documento: Digite no campo de busca para localizar clientes.
- Filtro por status: Filtre por Ativo, Inativo ou Bloqueado.
- Tags: Filtre clientes por tags associadas.
Cadastrar Novo Cliente
- Na listagem, clique em Novo Cliente (botão superior direito) ou acesse
/cliente/novo. - Preencha os campos obrigatórios:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome / Razão Social | ✅ Sim | Nome completo ou nome empresarial |
| CPF / CNPJ | ✅ Sim | Documento com ou sem formatação |
| ✅ Sim | Usado para envio de cobranças e notificações | |
| Telefone | Não | Formato: (11) 99999-9999 |
| Endereço | Não | Rua, número, complemento, CEP, cidade, estado |
| Tags | Não | Etiquetas para segmentação (ex: VIP, Inadimplente) |
- Clique em Salvar Cliente.
O CPF/CNPJ é validado automaticamente. Documentos inválidos ou duplicados são rejeitados.
Visualizar Detalhes do Cliente
Clique no nome de um cliente para acessar a tela de detalhes (/cliente/:code):
- Dados cadastrais — Informações completas do cliente
- Histórico de cobranças — Todas as cobranças vinculadas ao cliente
- Resumo financeiro — Total pago, pendente e em aberto
- Tags associadas — Etiquetas de segmentação
Editar Cliente
- Na listagem ou na tela de detalhes, clique em Editar.
- Modifique os campos desejados.
- Clique em Salvar Alterações.
A edição do CPF/CNPJ não é permitida após o cadastro para preservar o histórico financeiro. Para corrigir um documento, crie um novo cliente.
Status do Cliente
| Status | Significado | Comportamento |
|---|---|---|
| Ativo | Cliente operacional | Pode receber novas cobranças |
| Inativo | Cliente desativado manualmente | Não aparece nas seleções de nova cobrança |
| Bloqueado | Bloqueio por inadimplência ou fraude | Restrito pelo administrador |
Tags e Segmentação
Tags são etiquetas personalizadas que podem ser associadas a clientes para:
- Segmentar clientes por categoria (ex: "Aluno", "Fornecedor", "VIP")
- Filtrar cobranças por grupo de clientes
- Aplicar regras de split automático por tag
Gerencie suas tags em Configurações → Tags.
Exportar Lista de Clientes
- Na listagem, aplique os filtros desejados.
- Clique em Exportar.
- Selecione o formato:
- CSV — Para importação em planilhas ou CRM
- PDF — Para relatórios impressos
Regras de Negócio
- Cada cliente é identificado de forma única pelo CPF ou CNPJ dentro de uma conta.
- Um mesmo cliente pode ter múltiplas cobranças simultâneas.
- A exclusão de um cliente é permitida apenas se não houver cobranças vinculadas a ele.
- Clientes com cobranças em aberto não podem ser desativados sem encerrar as cobranças antes.