Pular para o conteúdo principal

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.

Lista de clientes

A lista​

A lista mostra nome, documento, telefone, e-mail, saldo devido, dias em atraso, classificação e data de cadastro, com busca por nome, documento ou e-mail. O saldo devido e os dias em atraso aparecem em vermelho quando há atraso, e ficam em traço quando a pessoa não deve nada. Cada linha dá acesso às ações Visualizar, Editar e Excluir.

Um filtro de Situação de dívida recorta a carteira em quatro opções: Todos, Com dívida (qualquer saldo em aberto), Vencido (com cobrança em atraso) e Em dia (sem atraso). É o atalho para separar quem precisa de cobrança de quem está regular.

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​

Resumo financeiro no topo​

Antes de qualquer coisa, quatro cards dão a posição de dívida da pessoa de relance:

  • Total devido — o valor somado das cobranças em aberto.
  • Total vencido — quanto desse total já passou do vencimento (destacado em vermelho quando há atraso).
  • Cobranças em atraso — quantos títulos estão vencidos.
  • Aging — o vencido aberto por faixa de dias em atraso: 1–30, 31–60, 61–90 e 90+. É a leitura de quão velha é a dívida daquela pessoa; quanto mais peso nas faixas da direita, mais difícil a recuperação.

Esses números vêm do agregado de todas as cobranças em aberto da pessoa, não só das que aparecem na tela.

Os cards de informação​

A página reúne o cadastro 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.

Nos contatos, cada e-mail e telefone tem botão de copiar, e todo telefone ganha um atalho para abrir a conversa no WhatsApp direto no número, poupando digitação na hora do contato.

O extrato interativo​

O extrato agora aparece em tela, não só em PDF. A seção mostra os totais (em aberto, vencido, total devido e já pago) e uma tabela com a posição de cada cobrança da pessoa (documento, vencimento, status, valor original e atual), atualizada na data da consulta. O botão Baixar PDF gera a mesma posição em documento para enviar ou arquivar. Veja Documentos gerados.

As ações​

No topo, além de Editar e Excluir, ficam 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 — abre a posição de todas as cobranças da pessoa (o extrato descrito acima), com a opção de baixar em PDF.
  • Nova cobrança — cria uma cobrança já vinculada a essa pessoa, sem precisar buscá-la de novo no formulário.
  • 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.

No card de interações recentes, o botão Registrar contato abre um diálogo para lançar uma interação à mão: o tipo (ligação, e-mail, WhatsApp, reunião ou anotação), a direção (recebido ou enviado) e um resumo do que foi tratado. É como a operação mantém no histórico da pessoa o contato que aconteceu fora da régua (uma ligação, uma conversa presencial). Pela API, a interação pode carregar também o desfecho — inclusive uma promessa de pagamento, que pausa a régua até a data prometida.

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.