Clientes

O cliente é o pagador das suas cobranças. O cadastro guarda nome, CPF ou CNPJ, endereço e contatos, e esses dados preenchem o bloco do pagador quando você emite um boleto, um carnê, uma assinatura ou uma cobrança Pix.

Você não precisa cadastrar o cliente antes de cobrar. Ao emitir um boleto ou criar uma assinatura, o painel procura um cliente da conta com o mesmo CPF/CNPJ do pagador: se encontra, associa a cobrança a ele; se não encontra, cria o cliente com os dados informados na cobrança.

Onde fica no painel

• CRM > Gerenciar Clientes: lista de clientes.
• CRM > Importar Clientes: importação por planilha (veja Importações).
• Cadastrar > Cliente: formulário de novo cliente. O mesmo formulário abre pelo ícone de adição ao lado do título Clientes na lista.

Lista de clientes

A lista mostra as colunas ID, Nome/Razão Social, CNPJ/CPF, Telefone, Endereço e E-mail, em ordem alfabética de nome. Quando a restrição de crédito está habilitada para a conta, aparece também uma coluna com a situação de restrição de crédito de cada cliente.

Ao lado do ID, dois ícones indicam a origem do cadastro: um para cliente Gerado pela API e outro para cliente Criado por Importação de Arquivo.

Busca

O campo de busca no topo da lista aceita nome, CNPJ, etiquetas e e-mails (o texto de exemplo do campo é "Busque por Nome, CNPJ, Tags, E-mails..."). O CPF ou CNPJ pode ser digitado com ou sem pontuação.

Filtros

O botão Filtrar abre o painel de filtros:

Filtro	Opções
Busca livre	Nome, CNPJ, etiquetas, e-mails
E-mail	Ignorar E-mail, Receber E-mail
SMS	Ignorar SMS, Receber SMS
Whatsapp	Ignorar Whatsapp, Receber Whatsapp
Tipo De Cliente	Física, Jurídica
Restrição de Crédito	Não Afetado, Negativado, Positivado
Motivo proteção	Processo Judicial, Ouvidoria, Negociação, Suspeita de Fraude, Suspeita de Óbito, Outros
Proteção Contra Restrição	Todos, Protegido, Liberado

Os três últimos filtros só aparecem quando a restrição de crédito está habilitada para a conta.

Com a lista filtrada, o menu de exportação passa a se chamar Exportar Filtrados e exporta só o resultado do filtro. Sem filtro, o menu se chama Exportar Todos. Os formatos disponíveis para clientes são CSV, XLSX, ODS e JSON. Veja Exportações.

Cadastrar um cliente

1. Acesse Cadastrar > Cliente.
2. Digite o CNPJ/CPF. Para CNPJ, o formulário consulta os dados da empresa e preenche os campos que ainda estão vazios (razão social, nome fantasia, endereço, telefone).
3. Preencha os demais campos e clique no botão de salvar, no fim do formulário.

O painel confirma com "Cliente cadastrado com sucesso!" e abre a ficha do cliente.

Dados do cliente

Campo	Obrigatório	Descrição
CNPJ/CPF	Sim	Documento do pagador. Não pode ser alterado depois do cadastro e não pode se repetir na mesma conta.
Nome/Razão Social	Sim	Até 255 caracteres.
Apelido/Nome Fantasia	Não	Até 255 caracteres.
Data de Nascimento	Não	Não pode ser uma data futura.
Código externo	Não	Código do cliente no seu sistema.
E-mail	Não	E-mail principal. Não pode ser igual ao e-mail da sua conta Kobana.
E-mail opcional	Não	Segundo e-mail do cliente.
Nunca enviar e-mail para este cliente	Não	Bloqueia o envio de e-mails para o cliente.
Contato	Não	Nome da pessoa de contato.
Telefone (com DDD, DDI é opcional)	Não	Entre 10 e 15 caracteres.
Celular (DDD)	Não	2 dígitos.
Celular	Não	8 ou 9 dígitos. Precisa ser um número de celular válido para o DDD informado.
Nunca enviar Whatsapp para este cliente	Não	Bloqueia o envio de Whatsapp para o cliente.
Nunca enviar SMS para este cliente	Não	Bloqueia o envio de SMS para o cliente.

O tipo do cliente (Física ou Jurídica) não aparece no formulário: o painel define pelo documento. CNPJ válido vira Jurídica; CPF vira Física.

Endereço

Campo	Obrigatório	Descrição
CEP	Sim	Ao digitar o CEP, o formulário busca e preenche o endereço.
Endereço	Sim	Logradouro, até 255 caracteres.
Nº	Não	Até 10 caracteres.
Bairro	Sim	Até 255 caracteres.
Complemento	Não	Até 255 caracteres.
Estado	Sim	Sigla de uma UF válida.
Cidade	Sim	Até 255 caracteres.
Endereço para remessa	Não	Só aparece na edição. Versão do endereço com até 40 caracteres, usada na remessa CNAB 400.

O painel monta o Endereço para remessa a partir do endereço e do número. Se você editar esse campo à mão, o valor digitado é mantido; se não editar, ele acompanha as alterações do endereço.

Restrição de crédito

Esta parte do formulário só aparece quando a restrição de crédito está habilitada para a conta.

Campo	Obrigatório	Descrição
Máximo de Negativações	Não	Número inteiro maior que zero. Limite de negativações para este cliente.
Nunca negativar este cliente	Não	Protege o cliente contra negativação. Ao ligar, aparecem os campos abaixo.
Data limite proteção	Não	Data até a qual a proteção vale. Não pode ser uma data passada.
Motivo proteção	Não	Processo Judicial, Ouvidoria, Negociação, Suspeita de Fraude, Suspeita de Óbito ou Outros.

Etiquetas (Tags)

O campo Etiquetas (Tags) aceita várias etiquetas. As etiquetas cadastradas em Administração > Etiquetas para o tipo Clientes (ou para Todos) aparecem como sugestão, mas você pode digitar outras. Veja Etiquetas.

Ficha do cliente

A ficha mostra os dados cadastrais na lateral e, no centro, abas com o histórico do cliente:

Aba	Conteúdo
Boletos	Boletos emitidos para o cliente.
Assinaturas	Assinaturas do cliente.
Carnês	Carnês do cliente.
Restrições de Crédito	Restrições de crédito do cliente. Só aparece com a restrição de crédito habilitada.
Observações	Texto livre sobre o cliente, salvo pelo botão Salvar da própria aba.

A lateral informa também se o cliente foi criado pela API ou importado por arquivo, as datas de criação e de atualização e, para quem tem a permissão de gerenciar senhas do Portal de Boletos, a Senha do Portal do cliente.

O menu Ações da ficha tem Visualizar, Alterar, Novo boleto (abre o formulário de boleto com o CPF/CNPJ do cliente preenchido) e Excluir.

Alterar um cliente

Em Ações > Alterar, todos os campos podem ser editados, exceto o CNPJ/CPF. Ao salvar, o painel mostra "Cliente atualizado com sucesso!".

Alterar o cadastro do cliente não muda os boletos que já foram emitidos. Para levar a mudança aos boletos existentes, o formulário de edição tem duas opções:

• Quero atualizar as configurações de e-mail deste cliente nos boletos já emitidos.
• Atualizar a opção de não enviar SMS para este cliente e o celular nos boletos associados a este cliente.

aviso

Essas opções atualizam todos os boletos do cliente de uma vez. Cada boleto atualizado dispara evento, webhooks e, possivelmente, notificações por e-mail e SMS. O formulário mostra quantos boletos serão afetados antes de você salvar.

Excluir um cliente

Em Ações > Excluir, o painel pede confirmação: marque Tenho certeza que quero APAGAR o cliente e clique em APAGAR Permanentemente.

Só é possível excluir um cliente que não tem boletos, assinaturas nem carnês. Nesse caso, a opção Excluir fica desabilitada e, se a exclusão for tentada, o painel responde "O Cliente não pode ser excluído porque tem boletos, assinaturas ou carnês."

Permissões

As ações sobre clientes dependem do produto Clientes do módulo CRM nas permissões do usuário:

Ação	Permissão
Ver a lista, a ficha e as abas, editar observações	Ações Básicas
Cadastrar	Criar
Alterar	Alterar
Excluir	Excluir
Exportar a lista	Exportar
Importar clientes	Importar

A aba Restrições de Crédito exige também a permissão Restrições do módulo Restrição de Crédito.

Eventos de webhook

Código	Quando ocorre
customer.created	Cliente criado (pelo painel, pela API, por importação ou na emissão de uma cobrança).
customer.updated	Cliente alterado, quando algum campo de fato mudou.
customer.portal_password_updated	Senha do Portal do cliente alterada.
customer.deleted	Cliente excluído.

Veja a lista completa de eventos em Eventos de webhook.

Pela API

Clientes podem ser criados, consultados, alterados e excluídos pela API: veja a referência da API v1 e da API v2.