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 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".
A partir de 10/08/2026, a tarifa do boleto de cobrança emitido pela conta Kamino é cobrada apenas quando o boleto é pago pelo seu cliente — R$ 1,80 por boleto pago. Emissões que falham, boletos cancelados e boletos que não são pagos não geram cobrança de tarifa.
Como resolver os problemas mais comuns
O que fazer quando o boleto não é gerado, não fica disponível para pagamento ou não sobe, significado de cada alerta de falha na emissão e como resolver.
Antes de tudo, veja na Central de Notificações (ícone de sino) a mensagem que indica o motivo da falha e o que corrigir.
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 do dia seguinte). |
Se o problema persistir depois de corrigir os dados, ou se o boleto não é gerado, envie um print para nosso time de atendimento através do "?" em sua plataforma.
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.
Uma tentativa de emissão que falhou gera cobrança pelo boleto, mesmo que ele não tenha sido emitido?
Não. A tarifa só é cobrada quando o boleto for pago pelo seu cliente.
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.