Api Banco do Brasil - Alteração e Inclusão de campos no Webhook da Cobrança - Payload 12/11/24

[willian_delan]

Conforme consta em https://apoio.developers.bb.com.br/referency/post/64651c4c5319490012819751

A partir de 12/11/24, serão realizadas as seguintes mudanças no formato Payload da Cobrança. Alteração da nomenclatura dos seguintes campos:

• “dataAgendamento” para “dataLiquidacao”
• “instituicaoAgendamento” para “instituicaoLiquidacao”
• “canalAgendamento” para “canalLiquidacao”

Além disso, serão incluídos os novos campos:

• “tipoPessoaPortador”: para definir se o portador é pessoa física ou pessoa jurídica
• “identidadePortador”: para indicar o CPF ou CNPJ de identificação do portador
• “nomePortador”: o nome do portador
• “formaPagamento”: para identificar a forma de pagamento do título (espécie, débito em conta, cartão de crédito ou cheque)

Acesse aqui as informações sobre o formato do payload e o detalhamento completo da alteração.

 

Comunicado aos Parceiros BB

Em breve, o Banco do Brasil deixará de identificar as chamadas de APIs integradas por Parceiros pelo campo gw-dev-app-key. Solicitamos aos parceiros que incluam no header de suas chamadas de API a seguinte chave-valor: x-bb-portal-devx-cnpj-parceiro = 11111111111111 (onde 11111111111111 é o número do CNPJ da empresa parceira, com 14 números, sem pontos ou outros caracteres não numéricos, ou seja, todos os caracteres numéricos do CNPJ devem ser informados nesse campo, inclusive zeros à esquerda) para que possamos identificar as chamadas integradas pela sua solução. Clique aqui e obtenha maiores informações.

Obs: Essa alteração na forma de identificação das chamadas se aplica somente as integrações sob o modelo de Parceria. Não há nenhuma ação a ser tomada para as integrações que não envolvam esse modelo de negócios.

 

Recusa na geração do token de consumo das APIs

Caso seja verificada recusa na geração do token de consumo das APIs (fluxo client credentials), recomendamos verificar se os IPs abaixo listados encontram-se liberados em seu firewall, para a porta 443, fluxo oauth.bb.com.br

• 170.66.14.104
• 170.66.196.33
   

Clientes usuários de Delphi com ACBr, devem utilizar a seguinte string de SCOPE:
cobrancas.boletos-info%20cobrancas.boletos-requisicao'

Não há alteração para os demais usuários

[Daniel InfoCotidiano]

 Boa tarde !
pelo que sei isso é so para implementações que utilizam Webhook  de cobrança API, nao temos por enquanto WebHook
pode confirmar com o banco por favor ?

[willian_delan]

15 minutos atrás, Daniel InfoCotidiano disse:

 Boa tarde !
pelo que sei isso é so para implementações que utilizam Webhook  de cobrança API, nao temos por enquanto WebHook
pode confirmar com o banco por favor ?

@Daniel InfoCotidianoAcredito que sim, compartilhei aqui mais de modo informativo mesmo, caso a informação seja útil para algúem.

Questionei o BB via fórum no Developers sobre para validar se aplica-se apenas a implementações que utilizam Webhook.

[willian_delan]

@Daniel InfoCotidianoSegue retorno do banco: "As mudanças no payload do Webhook implementadas hoje atingiram somente as notificações de liquidação geradas a partir da API Cobrança.".

[Daniel InfoCotidiano]

Como nao temos por enquanto webhook de mensagens,  nao vemos ter problemas.
 

[willian_delan]

1 hora atrás, Daniel InfoCotidiano disse:

Como nao temos por enquanto webhook de mensagens,  nao vemos ter problemas.
 

@Daniel InfoCotidianoBlz, pode encerrar esse tópico, era mais para compartilhar a informação e ver se teria alguma atualização por parte do ACBr.

[Alexandre de Paula]

Obrigado por reportar.

Fechando. Para novas dúvidas, criar um novo tópico.