Alteração de boleto

Depois de emitido, um boleto pode ter alguns dados alterados. Parte das alterações fica só na Kobana; outras, como vencimento e valor, precisam ser comunicadas ao banco, e a Kobana envia um comando de alteração.

Onde fica no painel

Na tela do boleto (ou na lista de boletos), menu Ações > Alterar. O formulário se chama Alterar Boleto e é salvo pelo botão Alterar Boleto.

O item Alterar aparece para boletos nas situações Aberto, Vencido, Falha ao gerar, Pago e Cancelado, e só para carteiras de bancos com integração de boleto. Nos outros casos, o painel informa "Boleto não pode ser editado.".

Campos que podem ser alterados

O formulário muda conforme a situação do boleto.

Boleto Aberto, Vencido ou Falha ao gerar

Campo	Quando aparece	Vai para o banco?
Vencimento	Quando o banco da carteira aceita alteração de vencimento	Sim
Quantia	Quando o banco da carteira aceita alteração de valor	Sim
Demonstrativo	Sempre	Não
Instruções para o Caixa	Sempre	Não
Dias para Protesto	Quando o banco da carteira aceita alterar os dias para protesto	Sim
Etiquetas (Tags)	Sempre	Não
Nome do arquivo anexo	Sempre	Não

caution

Alguns bancos não aceitam a alteração do vencimento ou do valor. Quando o banco não aceita, o campo não aparece no formulário.

Boleto Pago ou Cancelado

O formulário mostra só o campo Etiquetas (Tags). Se o boleto já estiver marcado como baixado, a alteração não é salva (veja as regras abaixo).

Observações

A aba Observações da tela do boleto guarda anotações internas e pode ser editada em qualquer situação. Ao salvar, o painel mostra "Observações atualizadas com sucesso.".

O que acontece ao salvar

Mensagem	O que aconteceu
Boleto enviado para atualização junto ao provedor financeiro.	Você alterou um campo que o banco precisa saber (vencimento, valor, dias para protesto). A Kobana salvou a alteração e criou um comando de Alteração para o banco.
Boleto atualizado com sucesso!	Você alterou só campos internos (demonstrativo, instruções, etiquetas, nome do arquivo anexo) ou não alterou nada. Nenhum comando foi enviado ao banco.
Boleto atualizado em nossa base de dados, mas não foi possível enviar para atualização junto ao provedor financeiro: …	A alteração foi salva na Kobana, mas o comando para o banco não pôde ser criado. O motivo aparece na mensagem.
Este boleto foi marcado como 'baixado' e por esse motivo ele não pode sofrer alterações.	O boleto está marcado como baixado. Veja abaixo.

O comando de alteração segue o mesmo caminho do registro: por API, quando a carteira tem registro online, ou como instrução na próxima remessa CNAB (por exemplo, a ocorrência Alteração do Vencimento). Acompanhe na aba Comandos do boleto. Veja Registro no banco.

Regras

• Boleto vencido com novo vencimento: se você altera o vencimento de um boleto Vencido para hoje ou para uma data futura, ele volta para Aberto.
• Boleto baixado: depois que o boleto é baixado, o formulário Alterar Boleto não salva mudanças e mostra a mensagem de boleto baixado; a aba Observações continua editável. Um boleto quitado é considerado baixado na data do pagamento, exceto quando o pagamento foi informado como quitação recebida diretamente por outra via. Um boleto também é baixado quando você usa Marcar como baixado (veja Cancelamento, baixa e exclusão).
• Boleto ainda não registrado: se o boleto não foi registrado, o vencimento não passou e a carteira está com a geração de remessa desabilitada, salvar a alteração pede o registro ao banco de novo.

Permissões

Alterar boletos exige a permissão Alterar no módulo Boletos.

Eventos de webhook

Evento	Quando
bank_billet.updated	O boleto foi alterado.
bank_billet.update.requested	O comando de alteração foi criado.
bank_billet.update.confirmed	O comando de alteração foi confirmado.
bank_billet.update.failed	O comando de alteração falhou.

A lista completa está em Eventos de webhook.

Pela API

A alteração também pode ser feita pela API v1 e pela API v2.