x-bb-portal-devx-cnpj-parceiro no Header da API do Banco do Brasil

[Aggille Sistemas de Gestão]

Bom dia... recebi um email do banco do Brasil, solicitando que seja incluída uma tag x-bb-portal-devx-cnpj-parceiro no header das requisições por api.
Nessa tag deve ir o cnpj da minha empresa. Ja existe essa propriedade no componente ?
Segue abaixo íntegra do email ...

 

Boa tarde, parceiro AGGILLE SISTEMAS DE GESTAO LTDA, 

No Banco do Brasil, buscamos sempre entregar aos nossos clientes as soluções mais modernas e eficientes do mercado. E, para que ocorra o processo de melhoria contínua em nossos serviços, é muito importante comprovarmos, por exemplo, se as chamadas de APIs que chegam até nós, são originadas por alguma solução tecnológica criada e gerenciada por você, parceiro.

Essa identificação permite que seus clientes integrados com as nossas APIs desfrutem de vantagens e tarifas exclusivas e que você parceiro, tenha acesso a canais de suporte técnico priorizado e a novos recursos e APIs de maneira antecipada, além de outras vantagens, como participação em eventos do Banco do Brasil e a possibilidade de ter a sua marca divulgada no nosso portal de APIs (https://www.bb.com.br/site/developers/), podendo utilizar a marca BB em suas ações promocionais.

Para que essa identificação ocorra de forma tempestiva, é necessário que se inclua no header de suas chamadas de API a seguinte chave-valor:

x-bb-portal-devx-cnpj-parceiro = cnpj_da_sua_empresa

Esta inclusão deve ser feita nas chamadas aos seguintes endpoints:

·       https://api-ip.bb.com.br/checkout/v1

·       https://api-bbpay.bb.com.br/checkout/v2

·       https://api.bb.com.br/cobrancas/v1

·       https://api.bb.com.br/cobrancas/v2

·       https://api.bb.com.br/dda/v1

·       https://api-extratos.bb.com.br/extratos/v1

·       https://api-ip.bb.com.br/pagamentos-lote/v1

·       https://api-ip.bb.com.br/pagamentos-lote/v2

·       https://api.bb.com.br/pix/v1

·       https://api-pix.bb.com.br/pix/v2

·       https://api.bb.com.br/pix-bb/v1

·       https://api.bb.com.br/recebimentos-bb/v3

·       https://api-ip.bb.com.br/servicos-arrecadacao/v1

·       https://api-ip.bb.com.br/servicos-arrecadacao/v2

·       https://api-ip.bb.com.br/servicos-arrecadacao/v3

·       https://api.bb.com.br/validacao-contas/v1

Obs.: sempre que, porventura, forem criadas pelo BB novas APIs e/ou novos endpoints, a inclusão da chave também deverá ser feita.

Como o uso da chave x-bb-portal-devx-cnpj-parceiro no header, não será mais obrigatório o uso da app-key única do parceiro nas chamadas, podendo (recomendamos) utilizar a app-key do cliente final.

A partir de 01/07/2024, só reconheceremos como chamadas feitas através de suas soluções, aquelas que contenham essa chave-valor. Sem ela, consideraremos que a chamada foi realizada diretamente pelo cliente final, sem o uso de suas soluções tecnológicas.

Estaremos à disposição para ajudá-los nessa alteração e para tirar eventuais dúvidas:

·       pelo fórum do Portal Developers

·       pelo e-mail [email protected]

Ainda assim, se necessária uma reunião 

[Aggille Sistemas de Gestão]

vou adicionar a propriedade no componente, implementar no BB e submeter para a aprovação...

[Aggille Sistemas de Gestão]

Seguem fontes alterados...

criei e propriedade CnpjParceiro na classe TBoleto...
é só utilizar 
FBoleto.CnpjParceiro                   := 'cnpj da sua softwarehouse'

por enquanto somente o banco do Brasil está solicitando...

 

sds,

ACBrBancoBrasil.pas ACBrBoleto.pas ACBrBoletoWS.Rest.pas ACBrBoletoW_BancoBrasil_API.pas

[Daniel InfoCotidiano]

@Aggille Sistemas de Gestão
Obrigado pela contribuição.
Criado a Tarefa TK-6274 , assim que concluida reportamos aqui.

[icozeira]

Boa noite.

a propriedade cnpjparceiro foi adicionada no compoenente acbrboleto?

Em 26/11/2024 at 16:46, Aggille Sistemas de Gestão disse:

Seguem fontes alterados...

criei e propriedade CnpjParceiro na classe TBoleto...
é só utilizar 
FBoleto.CnpjParceiro                   := 'cnpj da sua softwarehouse'

por enquanto somente o banco do Brasil está solicitando...

 

sds,

ACBrBancoBrasil.pas 116.24 kB · 0 downloads ACBrBoleto.pas 266.96 kB · 0 downloads ACBrBoletoWS.Rest.pas 12.88 kB · 0 downloads ACBrBoletoW_BancoBrasil_API.pas 41.03 kB · 0 downloads

 

[Daniel InfoCotidiano]

Bom dia @icozeira
Esta em nosso backlog esta tk.
Vou me posicionar sobre e te aviso aqui

[Daniel InfoCotidiano]

@icozeira
Pode testar com nossos ajustes por favor.
Fizemos de uma forma diferente para que no futuro possamos aproveitar o mesmo campo para outros bancos.

ACBrBancoBrasil.pas

ACBrBoletoWS.Rest.pas

ACBrBoletoW_BancoBrasil_API.pas

ACBrBoleto.pas

[Aggille Sistemas de Gestão]

Bom dia.. testei aqui e está incluindo de forma correta o header nas requisições...

solicitei ao meu contato no BB se ele tem como confirmar se o header está chegando corretamente...

mas ao meu ver está tudo certo...

[Daniel InfoCotidiano]

Obrigado pelos testes!
Aguardo uma resposta antes de realizar o commit
 

[Aggille Sistemas de Gestão]

confirmei lá com o BB e a informação está chegando corretamente.. tudo funcionando 100%

[Daniel InfoCotidiano]

Obrigado por reportar.

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