Status do boleto

Todo boleto tem duas informações de estado, exibidas na lateral da tela do boleto:

• Situação: em que ponto do ciclo de vida o boleto está (aberto, vencido, pago, cancelado…);
• Registro no Banco: em que ponto está o registro do boleto no banco.

As duas também são filtros da lista em Recebimentos > Boletos > Gerenciar (botão Filtrar, campos Situação e Situação do Registro).

Situação

Situação	O que significa
Gerando	O boleto foi criado e está sendo gerado. A tela mostra "Aguarde, seu boleto estará pronto em alguns instantes".
Rascunho	O boleto aguarda o banco confirmar o registro e devolver o nosso número. Acontece em carteiras em que o banco é responsável pelo nosso número. A tela mostra "Boleto aguardando confirmação bancária".
Inválido	Os dados não passaram na validação feita depois de salvar (validação em segundo plano). A tela lista os campos com erro em "O boleto bancário é inválido!". O boleto não é gerado.
Falha ao gerar	A geração do boleto não foi concluída.
Aberto	O boleto foi gerado e está disponível para pagamento.
Vencido	O boleto aberto passou da data de vencimento sem pagamento.
Pago	O boleto recebeu o pagamento.
Cancelado	O boleto foi cancelado.
Bloqueado	O boleto foi bloqueado para análise pela Kobana. A conta recebe um e-mail avisando.
Estornado	O pagamento de um boleto bloqueado foi estornado.

Transições

Gerando ──────────────► Aberto ──► Vencido
Rascunho ─────────────► Aberto
Falha ao gerar ───────► Aberto
Gerando ──────────────► Inválido
Gerando ──────────────► Falha ao gerar

Aberto / Vencido / Cancelado ──► Pago
Gerando / Rascunho / Inválido / Falha ao gerar / Aberto / Vencido ──► Cancelado
Bloqueado ──► Estornado
Vencido ──► Aberto      (o vencimento foi alterado para hoje ou para o futuro)
Pago ──► Aberto         (o pagamento registrado foi excluído)

Regras das transições:

• Aberto para Vencido: uma rotina diária, que roda em dias úteis, muda para Vencido os boletos abertos cujo vencimento já passou.
• Vencido para Aberto: quando você altera o vencimento de um boleto vencido para hoje ou para uma data futura, ele volta a Aberto.
• Para Pago: o boleto só passa a Pago quando há um pagamento registrado nele, seja informado pelo banco (retorno CNAB, API ou Pix) ou informado manualmente. Com pagamentos parciais configurados, ele passa a Pago quando atinge a quantidade de pagamentos ou quando a soma paga alcança o valor do boleto.
• Cancelado para Pago: um boleto cancelado ainda pode ser pago se o banco informar o pagamento.
• Pago para Aberto: se o pagamento for excluído em Recebimentos > Boletos > Recebimentos e o boleto deixar de estar quitado, ele volta a Aberto.

Quando um boleto é pago com valor diferente do cobrado, a conta recebe o alerta "Boleto pago no valor diferente do cobrado".

Quem cancelou

Na lateral de um boleto cancelado aparecem:

Informação	Valores
Cancelado por	Cliente (cancelado pela sua conta, no painel ou pela API), Banco ou Sistema
Motivo de Cancelamento	O motivo escolhido no cancelamento. Quando o banco cancelou, aparece "Baixa automática do banco".

Veja Cancelamento, baixa e exclusão.

Registro no Banco

Situação do registro	O que significa
Pendente	O registro ainda não foi pedido ao banco.
Requisitado	O pedido de registro foi enviado e aguarda resposta.
Confirmado	O banco confirmou o registro.
Rejeitado	O banco recusou o registro. A conta recebe um alerta com o motivo informado pelo banco.
Falha	O pedido de registro falhou.
Ignorado	O boleto não será registrado pela Kobana: foi criado com a opção de impedir o registro, ou foi cancelado antes do registro.

Quando o registro é confirmado, a lateral do boleto mostra também Registrado por (API, EDI ou Manual). Veja Registro no banco.

Eventos de webhook

Evento	Quando
bank_billet.created	O boleto foi criado.
bank_billet.updated	O boleto foi alterado.
bank_billet.registered	O banco confirmou o registro.
bank_billet.rejected	O banco rejeitou o registro.
bank_billet.overdue	O boleto passou a Vencido.
bank_billet.paid	O boleto passou a Pago.
bank_billet.canceled	O boleto passou a Cancelado.
bank_billet.blocked	O boleto passou a Bloqueado.

A lista completa está em Eventos de webhook.

Pela API

A situação e o registro do boleto também aparecem na consulta pela API v1 e pela API v2.