[ACBR-8930] ACBR Boleto - Geração de Boleto do Banco do Brasil via API

[Sergio Fuchs]

Bom dia a todos

Estava com o erro ao tentar gerar um boleto via api do BB, estava da dando o erro abaixo, mas conversando com o gerente da conta, ele informou que não precisamos passar o campo "numeroTituloCliente".
Para convênio tipo 3, basta não enviar o campo "numeroTituloCliente" no JSON.

Pois a nossa conta esta configurada (Banco Numera e Cliente emite e expede) mas conferindo, o fonte o ACBR sempre monta este campo usando o número do convênio.
Tem algum jeito de fazer com que este campo não seja adicionado no envio do Boleto?
 

Quando é preenchido o campo "numeroTituloCliente" , retorna o erro:
"Para este tipo de convênio não é permitido ao cliente informar o número do boleto (Banco numera).",

Mas quando comentei a linha abaixo na Unit ACBrBoletoW_BancoBrasil_API, consegui gerar o boleto.

LJsonObject.AddPair('numeroTituloCliente', Boleto.Banco.MontarCampoNossoNumero(ATitulo));

Tipos de convênio para registro:
 3 (Banco Numera e Cliente Emite e Expede)  ou
 4 (Cliente Numera, Emite e Expede) 

https://apoio.developers.bb.com.br/referency/post/5f4f8885b71fb5001268c9d7
   

Sugestão: eu ter a opção de informar o tipo do convênio e de acordo com o tipo do convênio enviar o campo "numeroTituloCliente" ou não ?
Ou tem alguma outra opção para não enviar este campo?
 

Obrigado

[Juliomar Marchetti]

não seria só validar?

[Sergio Fuchs]

8 horas atrás, Juliomar Marchetti disse:

não seria só validar?

Não, porque eu preciso passar o número do convenio, e este MontarCampoNossoNumero interno ele monta o campo usando o número do Convênio.

[Sergio Fuchs]

Por enquanto para os Boletos do Banco do Brasil API, vou deixar assim:

if (ATitulo.ACBrBoleto.Cedente.ResponEmissao = tbCliEmite) then
  LJsonObject.AddPair('numeroTituloCliente', Boleto.Banco.MontarCampoNossoNumero(ATitulo));

 

Para o nosso caso que o Banco é responsavel pela emissão, não precisa gerar o campo "numeroTituloCliente"

[Juliomar Marchetti]

Em 02/10/2025 at 17:02, Sergio Fuchs disse:

Por enquanto para os Boletos do Banco do Brasil API, vou deixar assim:

if (ATitulo.ACBrBoleto.Cedente.ResponEmissao = tbCliEmite) then
  LJsonObject.AddPair('numeroTituloCliente', Boleto.Banco.MontarCampoNossoNumero(ATitulo));

 

Para o nosso caso que o Banco é responsavel pela emissão, não precisa gerar o campo "numeroTituloCliente"

Deixou essa mudança ou já viu se as novas modificações no componente atende você?

[Sergio Fuchs]

1 hora atrás, Juliomar Marchetti disse:

Deixou essa mudança ou já viu se as novas modificações no componente atende você?

Boa tarde

Ainda estou tendo que fazer esta alteração, quando atualizamos o ACBR, no nosso caso continua com este problema na geraçao do título do Banco do Brasil.

[valterpatrick]

Em 22/01/2026 at 17:19, Sergio Fuchs disse:

Boa tarde

Ainda estou tendo que fazer esta alteração, quando atualizamos o ACBR, no nosso caso continua com este problema na geraçao do título do Banco do Brasil.

Conseguiu resolver?

[Sergio Fuchs]

Em 02/02/2026 at 22:25, valterpatrick disse:

Conseguiu resolver?

Bom dia

Com a alteração abaixo, resolve o problema no meu caso, mas ainda não esta no repositório, eu altero manualmente a Unit ACBrBoletoW_BancoBrasil_API, qd atualizo o ACBR.

if (ATitulo.ACBrBoleto.Cedente.ResponEmissao = tbCliEmite) then
  LJsonObject.AddPair('numeroTituloCliente', Boleto.Banco.MontarCampoNossoNumero(ATitulo));

 

 

 

[valterpatrick]

1 hora atrás, Sergio Fuchs disse:

Bom dia

Com a alteração abaixo, resolve o problema no meu caso, mas ainda não esta no repositório, eu altero manualmente a Unit ACBrBoletoW_BancoBrasil_API, qd atualizo o ACBR.

if (ATitulo.ACBrBoleto.Cedente.ResponEmissao = tbCliEmite) then
  LJsonObject.AddPair('numeroTituloCliente', Boleto.Banco.MontarCampoNossoNumero(ATitulo));

 

 

 

Se possível anexe a unit alterada.

 

Foi criada a tarefa ACBR-8930 para análise do caso e parecer por parte da equipe de consultores.

Qualquer novidade será divulgada aqui no tópico.

[Daniel InfoCotidiano]

Por favor pode validar com a minha unit (salve a sua unit antes de sobrescrever);
Como padrao, quando não enviado o NossoNumero em outros bancos, nós nao enviamos. entao ao invéz de validar pelo TbBancoEmite, vamos tentar seguir o mesmo padrao.
E vc nao informa o nossoNumero no titulo.

ACBrBoletoW_BancoBrasil_API.pas

Isso vai evitar outros clientes que enviam para o BB nossoNumero como bancoEmite.

Nos meus testes em sandbox nao consigo passar da validação e tenho a resposta do banco (quando nao envio o campo numeroTituloCliente:

{
    "codigo": "4851985",
    "versao": "1",
    "mensagem": "Para este tipo de convênio é obrigatório informar o número do boleto (Cliente numera).",
    "providencia": "Informe o número do boleto e tente novamente.",
    "ocorrencia": "091255178523"
}

Vou pedir um especial favor.
Como você nao é usuario PRO
Habilite o log Webservices e envie para [email protected] (devido a dados sensiveis do log)

Pode me informar qual carteira e convenio / modalidade esta usando no seu envio 

[Daniel InfoCotidiano]

Por favor no email colocar o link deste topico para podermos identificar a origem

[Daniel InfoCotidiano]

@Sergio Fuchs
Bom dia, chegou a testar com minha unit e realizar os testes solicitados?

[Sergio Fuchs]

3 horas atrás, Daniel InfoCotidiano disse:

@Sergio Fuchs
Bom dia, chegou a testar com minha unit e realizar os testes solicitados?

Boa tarde, vou tentar fazer o teste hoje no máximo amanhã e já te respondo.

[Sergio Fuchs]

@Daniel InfoCotidiano 
Fiz o teste com a unit nova e deu certo o envio do boleto.
Já encaminhei no email o arquivo q vc tinha pedido.

Obrigado