Pular para o conteúdo principal

Comandos e protesto

Além de registrar, alterar e cancelar, você pode mandar outras instruções ao banco sobre um boleto já registrado: protestar, sustar protesto, conceder abatimento, alterar dados do pagador, entre outras. No painel, essas instruções são os comandos do boleto, enviados ao banco como ocorrências no arquivo de remessa CNAB.

Onde fica no painel​

Na tela do boleto, menu Comandos. O menu só aparece quando a carteira do boleto aceita remessa CNAB e o boleto não está nas situações Gerando ou Inválido.

O menu lista apenas as instruções que o banco da carteira aceita. A lista muda de banco para banco.

Passo a passo​

  1. Abra o boleto e clique em Comandos.
  2. Escolha a instrução. O painel pede confirmação: "Você tem certeza que quer notificar o banco sobre: …".
  3. Confirme. O painel mostra que a operação foi "colocado(a) na lista de envio para o banco".

A instrução entra na lista de comandos pendentes (Integrações > EDI > Comandos Pendentes) e vai para o banco no próximo arquivo de remessa da carteira. A resposta do banco chega no arquivo de retorno e aparece na aba CNAB do boleto, em Retornos do banco.

cuidado

Na remessa manual, a instrução só chega ao banco quando você gera e envia o arquivo de remessa. Veja Registro no banco.

Enquanto a instrução não entrou em um arquivo de remessa, você pode retirá-la pela aba CNAB do boleto, ícone Não enviar.

Instruções disponíveis​

O nome de cada instrução no menu é o mesmo usado pela Kobana para todos os bancos. Alguns exemplos:

InstruçãoPara que serve
Pedido de BaixaPede ao banco que baixe o boleto.
Alteração do VencimentoEnvia a nova data de vencimento.
Concessão de Abatimento / Cancelamento de AbatimentoConcede ou cancela abatimento no valor do boleto.
Concessão de desconto / Cancelamento de descontoConcede ou cancela desconto.
ProtestarPede o protesto do boleto.
Não ProtestarPede que o boleto não seja protestado.
Sustar protesto e baixar TítuloSusta o protesto e baixa o boleto.
Sustar protesto e manter em carteiraSusta o protesto e mantém o boleto em cobrança.
Cancelar instrução automática de protestoCancela o protesto automático configurado.
Alterar Nome do Pagador, Alteração de endereço do pagador, Alterar CEP do pagadorAtualiza dados do pagador no banco.
Não cobrar juros de mora / Cobrar juros de moraLiga ou desliga a cobrança de juros.
Solicitar negativação expressa / Excluir negativação expressaPede ou exclui a negativação pelo banco.

Só aparecem no menu as instruções que o banco da carteira aceita.

Quando uma instrução não é aceita​

O painel mostra "Operação não disponível para este banco." quando:

  • o banco da carteira não aceita aquela instrução;
  • a instrução está na lista Ocorrências Bloqueadas no CNAB da carteira;
  • o boleto foi criado com a opção de impedir o registro;
  • a instrução é Entrada de Título (registro) e o boleto já foi registrado ou não está nas situações Gerando, Rascunho ou Aberto.

Protesto​

O protesto pode ser configurado de duas formas:

  • Na emissão: o campo Dias para Protesto, em Informações para remessa, diz em quantos dias o banco deve protestar o boleto não pago. Depois de emitido, o campo pode ser alterado em Ações > Alterar quando o banco da carteira aceita essa alteração. Veja Alteração de boleto.
  • Depois de emitido: pelo menu Comandos, com as instruções Protestar, Não Protestar e as de sustação, conforme o banco.

Em caso de protesto, o cartório pede o comprovante, assinado pelo pagador, de aceitação do boleto (veja o campo Aceite em Emissão de boleto). As respostas do banco, como confirmação da instrução de protesto, envio a cartório ou título protestado e baixado, aparecem em Retornos do banco, na aba CNAB do boleto. Um boleto protestado e baixado pelo banco passa a Cancelado, com Cancelado por: Banco.

Permissões​

Enviar comandos exige a permissão Enviar Comandos para o Banco no módulo Boletos.

Eventos de webhook​

EventoQuando
bank_billet.protest.requestedUm comando de protesto foi criado.
bank_billet.protest.confirmedO comando de protesto foi confirmado.
bank_billet.protest.failedO comando de protesto falhou.

A lista completa está em Eventos de webhook.

Pela API​

Pedidos de protesto e de sustação também podem ser enviados pela API. Veja a API v1.