O que são os alertas de validação de boleto
Para garantir que nenhuma cobrança seja emitida com dados incompletos — e que seu cliente nunca receba um boleto inválido —, a Kamino passou a exibir alertas preventivos em pontos-chave do fluxo de cobrança.
Esses alertas aparecem em três momentos: na criação ou edição de um recebimento, na tela de detalhe da cobrança e na central de notificações (quando uma falha já ocorreu após a tentativa de emissão).
Alerta na criação e edição do recebimento
Ao criar ou editar um recebimento com forma de recebimento por boleto, a Kamino verifica automaticamente se todos os requisitos estão preenchidos antes de salvar.
Os requisitos verificados incluem:
Pessoa com endereço completo cadastrado
CNPJ ou CPF da pessoa cadastrado e válido
Conta bancária vinculada à forma de recebimento com integração ativa
Data de vencimento não retroativa (boleto não pode ser emitido para o mesmo dia — D+0)
Se algum requisito não for atendido, a Kamino exibe um alerta descrevendo o que precisa ser corrigido antes de salvar.
Alerta no detalhe da cobrança
Na tela de detalhe de uma cobrança existente, caso os dados da pessoa ou da conta bancária tenham sido alterados após a criação e agora estejam incompletos, a Kamino exibe um alerta indicando o problema.
Isso evita surpresas quando a tentativa de emissão do boleto ocorrer — você resolve o problema antes mesmo de tentar emitir.
Notificação de falha na emissão de boleto
Quando uma tentativa de emissão de boleto falha (por exemplo, por falta temporária de saldo, instabilidade bancária ou dado inválido), a Kamino registra a falha e exibe uma notificação na Central de Notificações (ícone de sino no topo da tela).
A notificação inclui o nome do cliente e o motivo da falha, para que você possa agir rapidamente.
Além disso, na Central de Cobranças a Situação da cobrança é atualizada para "Falha".
Boletos emitidos via conta Kamino têm o custo debitado apenas quando a emissão é bem-sucedida. Tentativas com falha não geram cobrança de tarifa.
Como resolver os problemas mais comuns
Mensagem de alerta | O que fazer |
Endereço não cadastrado | Acesse o cadastro da Pessoa e preencha o endereço completo. |
CNPJ/CPF inválido ou ausente | Acesse o cadastro da Pessoa e verifique o documento fiscal. |
Integração bancária inativa | Acesse Configurações > Integrações bancárias e verifique o status da conexão. |
Boleto não pode ser emitido em D+0 | Edite a data de vencimento para uma data futura (a partir de amanhã). |
Saldo insuficiente para emissão | Verifique o saldo da conta Kamino. A emissão de boleto custa R$ 2,00. |
Perguntas frequentes
O alerta bloqueia o salvamento do recebimento? Depende do problema. Dados obrigatórios ausentes bloqueiam a emissão do boleto; a Kamino indica o que precisa ser corrigido antes de prosseguir.
A cobrança é cancelada automaticamente quando há falha na emissão? Não. A cobrança permanece no sistema. Você pode resolver o problema apontado e tentar emitir novamente.
Onde vejo o histórico de tentativas de emissão? Na Página da Cobrança, a seção Histórico registra cada tentativa com o respectivo status.