O identificador que o banco usa para reconhecer o boleto. Sem ele, não há boleto.
A regra que rege tudo
Boleto já enviado ao banco não se mexe aqui — mexe-se no aplicativo do banco.
A
O que a tela faz — e o que não faz
Importante antes de atender
Ela lista os boletos emitidos no período, mostra o que o banco respondeu de
cada um — registro, baixa, rejeição — e permite três manutenções.
Ela também gera a remessa de boletos e lê o arquivo de retorno
(botão Remessa…, com a conta bancária escolhida no filtro); ver a seção F.
Por que isso importa no primeiro contato: remessa e retorno estão portados desde 09/09/2026
(17 leiautes de banco). Se a tela pede o código do banco ("bancoNaoPortado"), é a conta bancária sem
o código preenchido e sem nome que permita deduzir o banco — não é defeito, é cadastro a completar.
O que já está portado da leitura: a ocorrência que o banco devolveu aparece
normalmente na grade, então dá para ver registro, baixa e rejeição de cada boleto.
B
A trava do boleto já enviado
Vale para alterar e para excluir
É a regra central da tela: depois que o boleto foi para o banco na remessa, quem manda nele
é o banco. Mudar aqui não mudaria lá — o cliente continuaria recebendo o
boleto antigo.
Bloqueia
Boleto já enviado — a alteração tem de ser feita no aplicativo do banco.
Boleto já enviado na remessa … — a exclusão tem de ser feita no aplicativo do banco.
QuandoO boleto já saiu numa remessa. A mensagem da exclusão traz qual remessa.
SairNão há como: a alteração ou o cancelamento precisam ser feitos no canal do banco. Depois, o retorno traz a ocorrência e a grade acompanha.
Todos
C
Alterar o vencimento
Só antes de enviar
Bloqueia
Data inválida! O vencimento não pode ser retroativo.
QuandoO novo vencimento é anterior a hoje. Um boleto com vencimento no passado não é pagável.
Todos
Bloqueia
Informe a data de vencimento
Boleto não encontrado.
Boleto não encontrado (nosso número …).
QuandoFalta a data, ou o boleto não existe mais — normalmente tela aberta antes de outra pessoa excluir.
Todos
D
Excluir o boleto
Excluir aqui é apagar o nosso número
Aviso
A exclusão apaga o "nosso número", não o título
ComportamentoO que se exclui é o boleto — o vínculo com o banco. O título financeiro continua existindo e cobrável; ele apenas deixa de ter boleto emitido.
ConsequênciaDepois disso o título pode receber um boleto novo, com outro nosso número.
Todos
Bloqueia
Boleto sem nosso número.
QuandoO registro não tem nosso número — não há boleto para excluir.
Todos
E
Trocar a carteira, em lote
Muda conta e carteira de vários de uma vez
Bloqueia
Marque ao menos um boleto.
Informe a conta bancária.
QuandoTrocar a carteira sem seleção, ou sem a conta de destino.
O que a troca fazMuda a conta bancária e a carteira dos boletos marcados — é a operação usada quando a cobrança migra de banco.
Todos
F
Remessa e retorno: o que foi portado
Diferença conhecida — não abrir defeito
Esta é a tela com a maior parte pendente do módulo, e a razão é boa o suficiente para
estar escrita aqui.
Peça
Situação
Geração da remessa de boletos
Portada (09/09/2026) — os 17 leiautes de banco, banco a banco, cada um com as suas posições e o seu dígito verificador
Leitura do arquivo de retorno
Portada (09/09/2026) — os leiautes de retorno, com a baixa do que foi liquidado
Ocorrências já gravadas
Portada — a grade mostra registro, baixa e rejeição normalmente
As três manutenções
Portadas — são as seções C, D e E
Como foi conferido, já que a remessa não guarda a linha enviada: o dígito verificador
contra o que o próprio banco devolveu no retorno, a leitura do retorno contra o que o sistema
antigo gravou, a largura de cada linha e o nome do arquivo.
Mudanças de 13/09/2026, acompanhando o sistema antigo:
Vortx (310): o dígito do nosso número com resto 1 passa a ser "0" — era "P",
como no Bradesco. É o que o banco devolvia: das 1.854 linhas de retorno do
central, as 171 com resto 1 voltavam com "0".
Bradesco (237): a coluna Ocorrência lê o retorno em toda filial; antes só em
sete cidades (CAJURU, JURUENA, COLORADO, CAMPO GRANDE, CAMBE, NOVA ESPERANÇA, CASCAVEL), e nas
demais saía vazia.
Itaú (341) em CAMPINAS: a remessa sai com o CNPJ da própria filial (era o literal
10.989.834/0015-20), e o retorno passa pela conferência de CNPJ como nas demais.
Sofisa (637): nenhum título vai a protesto (CAMBE, RIBEIRAO e CUIABA protestavam em
5 dias), e o CNPJ do cabeçalho é sempre o da filial (IPORA levava um literal).
Sicredi (748): saiu o tratamento de PORTO ALEGRE (o "18" do nosso número e o CNPJ
literal do cabeçalho), e o retorno é lido em toda filial.
Daycoval (707) e Pine (643): o sacador/avalista é a razão social da filial (era "BMG
FOODS").
Mudanças de 14/09/2026:
Sofisa (637): o boleto sai "com correspondente" (nosso número no segmento Q, dígito
pelo módulo 11) quando a conta tem banco correspondente cadastrado
(conta_bancaria.codigo_banco_corresp) ou quando o nosso número tem mais de 10
algarismos. Era a filial de COLINA. No central isso vale para as contas com
correspondente 033 — CAMBE, COLORADO e PAICANDU —, onde antes só os nossos números longos saíam
assim.
QI (329) e Ouribank (712): o sacador/avalista do campo 335 leva o CNPJ da filial (era
o literal 10.989.834/0001-25).
Sicoob (756), retorno: o sistema antigo deixou de somar 1 dia à data de crédito em
ENTRE RIOS. O porte nunca somou; as duas pontas agora dizem o mesmo.
G
Como o erro chega na tela
Para o QA reproduzir e reportar
Toda resposta sai com HTTP 200; quem diz o que aconteceu é o
statuscode no corpo — 400 para as recusas deste documento.
Ao abrir chamado, informe o nosso número do boleto: é por ele que o banco
identifica o registro, e é o que permite cruzar a ocorrência com o extrato da cobrança.
Nenhuma regra bate com essa busca. Tente um trecho menor da mensagem, ou limpe os filtros.