👥 Visão Geral dos Clientes
Gerencie seu banco de dados de clientes — armazene detalhes de contato, informações de GST e rastreie o histórico de faturas de cada cliente.
📋 Lista de Clientes
Quando você navega para Clientes no menu principal, você vê todos os seus clientes em uma tabela pesquisável com um resumo da contagem total.

Ações da Página
| Botão | Descrição |
|---|---|
| Importar CSV | Importe clientes em massa de um arquivo CSV |
| + Criar Novo Cliente | Abra o formulário de criação de cliente |
Pesquisa
Use a barra Pesquisar clientes... no topo para filtrar por nome, e-mail ou telefone do cliente. Os resultados são filtrados enquanto você digita.
Cartão de Resumo
Mostra o número total de clientes (ex: 3 TOTAL — Todos os clientes).
Colunas da Tabela
| Coluna | Descrição |
|---|---|
| ID | Número de sequência do cliente atribuído automaticamente |
| Nome do Cliente | Nome de exibição com um ícone de empresa para clientes empresariais |
| Endereço de e-mail do cliente | |
| Telefone | Número de telefone do cliente |
| Criado | Data e hora em que o cliente foi adicionado |
| Atualizado | Data e hora da última atualização |
| Ações | Ações por linha: Visualizar, Editar, Excluir |
Ações da Linha
| Ícone | Ação |
|---|---|
| Olho (Visualizar) | Abrir detalhes do cliente em modo somente leitura |
| Lápis (Editar) | Editar detalhes do cliente |
| Lixeira (Excluir) | Excluir cliente — somente se não houver faturas anexadas |
👤 Tipos de Clientes
| Tipo | Descrição |
|---|---|
| Pessoa Física | Cliente pessoal — não é necessário GSTIN |
| Empresa | Cliente empresarial — GSTIN/ID Fiscal recomendado para conformidade com o GST |
Clientes empresariais são mostrados com um ícone de prédio na coluna Nome do Cliente.
📥 Importação de CSV
Importe clientes em massa usando um arquivo CSV:
- Clique em Importar CSV
- Baixe o modelo de CSV de exemplo
- Preencha os dados do cliente
- Faça o upload do CSV preenchido
- Revise e confirme a importação
:::tip Configuração em Massa Use a importação de CSV ao mudar de outro sistema de faturamento ou ao configurar um grande número de clientes de uma só vez. :::
📊 Rastreamento de Contas a Receber
As faturas pendentes de cada cliente são rastreadas automaticamente. Vá para Contas a Receber no menu principal para ver:
- Total pendente por cliente
- Faturas individuais vencidas
- Rastreamento de pagamentos parciais
💡 Melhores Práticas
- Sempre adicione o GSTIN para clientes empresariais para conformidade com o GST
- Use o nome legal da empresa para clientes empresariais
- Defina o código de estado correto para o cálculo preciso do GST (CGST/SGST vs IGST)
- Importe clientes existentes via CSV antes de criar faturas
🔗 Relacionados
- Criar Cliente — guia completo campo a campo para adicionar um cliente
- Editar / Excluir Clientes — atualize ou remova registros de clientes