Clientes
Clientes são as pessoas (físicas ou jurídicas) da sua carteira — na interface, a página Clientes do menu lateral. Todo o resto do sistema gira em torno deles: cobranças, acordos, notificações e o portal do devedor sempre apontam para um cliente.

A lista
A lista mostra nome, documento, telefone, e-mail, classificação e data de cadastro, com busca por nome, documento ou e-mail. Cada linha dá acesso às ações Visualizar, Editar e Excluir.
O cadastro
O formulário de Novo Cliente tem estas seções:
- Informações Básicas — Nome (obrigatório), Razão Social (para empresas), Tipo de Documento (CPF ou CNPJ) e Número do Documento (apenas números), Apelido (ou nome fantasia), Data de Nascimento, Classificação e ID Externo.
- Emails — quantos endereços precisar, com tipo (Pessoal, Comercial, Financeiro).
- Telefones — país, DDD e número, com tipo (Celular, Fixo, Comercial, WhatsApp).
- Endereços — rua, número, complemento, bairro, cidade, UF e CEP.
- Tags — etiquetas livres para organizar e filtrar a carteira.
- Informações Adicionais — Observações em texto livre e Dados Customizados em JSON, para guardar qualquer metadado do seu negócio (código do contrato, vendedor responsável, etc.).
Dois campos merecem atenção especial:
- Documento (CPF/CNPJ): além de identificar o cliente, é o que o devedor usa para confirmar a identidade no portal (4 últimos dígitos) e uma das chaves de deduplicação na importação.
- ID Externo (
external_id): o identificador do cliente no seu sistema (ERP, CRM, planilha). É a chave de deduplicação preferencial em importações e integrações — quando presente, vence o documento. Se você mantém a carteira sincronizada com outro sistema, preencha sempre.
O detalhe do cliente
A página de um cliente reúne tudo em cards: informações pessoais, classificação (com tags e observações), contatos, endereços, as últimas cobranças da pessoa (com vencimento e dias em atraso), notificações recentes, interações recentes e os dados customizados.
No topo, além de Editar e Excluir, ficam três ações específicas:
- Link do Portal — gera um link seguro do portal do devedor para essa pessoa. Ao gerar um link novo, os anteriores são revogados; o link tem validade e o devedor confirma os 4 últimos dígitos do documento antes de ver qualquer valor.
- Extrato — gera um PDF com a posição de todas as cobranças da pessoa (documento, vencimento, status, valor original e atual) e os totais em aberto, vencido e já pago. Veja Documentos gerados.
- Reclassificar — altera manualmente a classificação do cliente, com campo de motivo opcional. Veja Classificações para entender quando isso é necessário e quando o sistema faz sozinho.
Boas práticas
- Contato é combustível da régua: cliente sem e-mail nem telefone não recebe nada. Priorize completar esses campos na importação.
- Excluir é definitivo (a interface pede confirmação). Se o problema é "não contatar", o caminho certo é a supressão/opt-out, que preserva o histórico.
- Use tags para recortes operacionais (carteira antiga, atacado, região) e Dados Customizados para o que precisa viajar junto do cliente em integrações.