Registro no banco

Todo boleto emitido precisa ser registrado no banco da carteira para poder ser pago. A Kobana pede o registro automaticamente logo depois que o boleto é criado. O caminho usado depende da carteira de cobrança:

Via	Quando é usada	Como o registro é confirmado
API (registro online)	A carteira tem uma conexão com o banco ativa e associada, e o banco oferece registro por API.	O banco responde ao pedido; a confirmação ou a recusa chega em seguida.
Arquivo de remessa CNAB	A carteira não tem registro por API disponível, mas aceita remessa CNAB.	O pedido entra num arquivo de remessa enviado ao banco. A confirmação ou a recusa chega no arquivo de retorno.

Se o pedido por API falhar e a carteira também aceitar remessa CNAB, a Kobana pode incluir o pedido na próxima remessa.

Para ativar o registro por API numa carteira, veja Ativação por API.

Registro por remessa CNAB

Quando o registro vai por remessa:

1. O pedido de registro entra na lista de comandos pendentes, em Integrações > EDI > Comandos Pendentes. Lá ficam os comandos que ainda não entraram num arquivo de remessa.
2. A remessa é gerada para a carteira: pela tela da carteira, em Ações > Gerar Remessa, ou automaticamente, quando a carteira tem envio de remessa por EDI configurado. Todos os comandos pendentes da carteira entram no arquivo.
3. O arquivo é enviado ao banco: manualmente, baixando o arquivo e enviando pelo canal do banco, ou pela caixa postal EDI.
4. O banco devolve o arquivo de retorno. Quando ele é processado, o boleto recebe a confirmação (Entrada Confirmada) ou a recusa do registro.

Os arquivos ficam em Integrações > EDI > Remessa e Integrações > EDI > Retorno. O passo a passo de remessa, retorno e caixas postais está na seção Remessa e Retorno.

caution

Na remessa manual, o boleto só passa a existir no banco depois que você envia o arquivo de remessa. Sem o envio, o pagador não consegue pagar o boleto.

Tirar um boleto da remessa

Na tela do boleto, aba CNAB, a tabela de registros de remessa mostra os comandos do boleto e a remessa em que cada um entrou. Enquanto um comando ainda não entrou em um arquivo, o ícone Não enviar o remove da lista de envio para o banco.

A aba CNAB só aparece quando a carteira aceita remessa CNAB. Ela também lista, em Retornos do banco, as ocorrências que chegaram nos arquivos de retorno para aquele boleto, com o link Ver Retorno.

Desligar a remessa numa carteira

Na edição da carteira, a opção Desabilitar geração de remessa impede que os boletos daquela carteira entrem em arquivos de remessa. Veja Configurações da carteira.

Acompanhar o registro

Na tela do boleto:

• a lateral mostra Registro no Banco (Pendente, Requisitado, Confirmado, Rejeitado, Falha ou Ignorado) e, depois da confirmação, Registrado por (API, EDI ou Manual);
• a aba Comandos lista os comandos enviados ao banco para este boleto, com operação (por exemplo, Registro, Alteração, Cancelamento, Protesto) e situação.

Situações de um comando:

Situação	O que significa
Agendado	O comando foi agendado para ser enviado depois.
Pendente	O comando aguarda envio.
Aguardando	O comando foi enviado e aguarda a resposta do banco.
Processado	O comando foi processado.
Confirmado	O banco confirmou a operação.
Falha	O banco recusou a operação ou o envio falhou.
Interrompido	O comando foi interrompido antes de ser concluído.

O item Ações > Comandos da tela do boleto abre o histórico de comandos da conta já filtrado por este boleto.

Registro recusado

Quando o banco recusa o registro, a situação do registro passa a Rejeitado, a conta recebe um alerta com o motivo informado pelo banco e é enviado o evento bank_billet.rejected. Corrija o que o banco apontou e, se for o caso, cancele o boleto e emita outro (ou use Copiar boleto).

Boletos que não são registrados

O registro não é pedido, e a situação do registro fica Ignorado, quando:

• o boleto foi criado com a opção de impedir o registro (disponível na API e na importação), para boletos que já estão registrados no banco por outro meio;
• o boleto foi cancelado antes de o registro ser pedido.

Eventos de webhook

Evento	Quando
bank_billet.register.requested	O comando de registro foi criado e aguarda envio.
bank_billet.register.confirmed	O comando de registro foi confirmado.
bank_billet.register.failed	O comando de registro falhou.
bank_billet.register.error	Uma tentativa de envio do comando teve erro.
bank_billet.registered	O boleto foi registrado.
bank_billet.rejected	O banco rejeitou o registro.

A lista completa está em Eventos de webhook.

Pela API

O registro é automático também para boletos criados pela API v1 e pela API v2.