Homologação
A homologação confirma que os dados da carteira estão corretos e que o banco aceita os boletos gerados com eles. Ela é usada em carteiras com remessa CNAB: a Kobana gera um boleto de teste e um arquivo de remessa, você envia a remessa ao banco e, depois, comprova que o banco registrou o boleto.
Carteiras que podem registrar boletos por API não precisam passar pela homologação: ativar o registro por API também libera a carteira. Veja Ativação por API.
Onde fica no painel
Na tela da carteira, Ações > Iniciar Homologação (carteira em Homologação Pendente) e, depois, Ações > Finalizar Homologação (carteira em Em validação). Os mesmos botões aparecem na tela da carteira enquanto ela não está ativa. A tela se chama Homologação da carteira.
Etapa 1: iniciar a homologação
- Confirme com o seu gerente que a carteira está ativa na conta corrente.
- Confira os dados da carteira, exibidos na lateral.
- Marque as três declarações:
- Estou ciente que ao homologar a conta terei que pagar o custo de um boleto bancário que será cobrado pelo meu banco.
- Estou ciente que não poderei emitir boletos caso algum dos dados da carteira esteja errado.
- Estou ciente que após iniciar o processo terei que enviar o ARQUIVO REMESSA ao banco. Depois, enviar à Kobana o ARQUIVO RETORNO ou informar o valor do boleto para que a carteira seja 100% validada e liberada.
- Clique em Prosseguir com a Homologação.
A Kobana gera um boleto de homologação, com valor inferior a R$ 200,00, vencimento em 15 dias e um arquivo de remessa com esse boleto. A carteira passa a Em validação, e o painel lembra: "Você precisa enviar o arquivo Remessa para o banco para prosseguir com a homologação.". Sem as três declarações marcadas, o painel mostra "Você deve aceitar as três condições para iniciar o processo de homologação da conta.".
Se algum dado da carteira estiver errado, a carteira é recusada e você não poderá emitir boletos com ela.
Etapa 2: enviar a remessa ao banco
Baixe o arquivo de remessa em Ações > Baixar Arquivo Remessa, na tela da carteira, e envie pelo canal do banco. Sem o envio, o banco não registra o boleto de teste.
Etapa 3: finalizar a homologação
Depois que o banco processar a remessa, conclua de uma das duas formas.
Pelo arquivo de retorno
Baixe o arquivo de retorno no banco (ele pode levar 1 dia útil para ficar disponível) e envie à Kobana pelo botão Enviar Arquivo Retorno, na tela Finalizar Homologação. Quando o retorno confirma o registro do boleto de teste, a carteira é ativada automaticamente.
Pelo valor do boleto
- Encontre o boleto de homologação no sistema do banco. Se precisar, peça ajuda ao seu gerente.
- Em Ações > Finalizar Homologação, informe o Valor do boleto de homologação.
- Clique em Finalizar a Homologação.
Se o valor confere, a carteira passa a Ativa e o painel abre a emissão de boleto: "Sua conta foi homologada com sucesso! Você já pode gerar o primeiro boleto.". Se não confere, o painel informa que o valor é inválido e pede para conferir o extrato.
Ativação automática pelo primeiro registro
Uma carteira ainda não homologada também é ativada quando o banco confirma o registro de um boleto dela. No registro por API, a Kobana compara a agência e a conta informadas pelo banco com as da carteira; se forem diferentes, a homologação falha e é enviado o evento bank_billet_account.homologation_failed.
Permissões
Homologar exige a permissão Criar no módulo Carteiras de Cobrança.
Eventos de webhook
| Evento | Quando |
|---|---|
bank_billet_account.homologation_started | A homologação começou. |
bank_billet_account.homologation_failed | A agência ou a conta informadas pelo banco não conferem com as da carteira. |
bank_billet_account.activated | A carteira foi ativada. |