BRConselhos – Adicionar FeatureFlag para Adequação API BB para comportar CNPJs alfanuméricos.

Atualização liberada para a versão Versão 03.48.04

A partir de julho de 2026, novos registros de CNPJ passarão a seguir o formato de 14 posições, sendo 8 alfanuméricas para a raiz, 4 para a ordem e 2 numéricas para os dígitos verificadores, calculados pelo Módulo 11 com base na tabela ASCII.

O BRC já possuía ajustes para tratamento de CNPJ alfanumérico, conforme documentação disponível em:
https://docs.datainfo.inf.br/brconselhos-cnpj-alfanumerico-a-partir-da-versao-03-48/

No entanto, em razão da alteração realizada pelo Banco do Brasil, prevista para 14/05, no contexto das integrações bancárias, especialmente no registro de boletos do Banco do Brasil via Pix Cobrança Registrada, foi necessário adequar as chamadas realizadas pelo BRC à API de registro de boletos.

Dessa forma, a alteração relacionada ao CNPJ alfanumérico já havia sido aplicada no BRC, porém a mudança promovida pelo Banco do Brasil exigiu ajustes adicionais na integração bancária, a fim de manter a compatibilidade com o novo comportamento esperado pela API.

Este manual trata de como ativar a featureflag para que o comportamento seja respeitado.
Junto com a atualização do pacote, foi disponibilizado o arquivo featureflags.json, temos que colocar ele na pasta raiz do BRC

Após inserir a feature flag, é possível ver como ela está configurada, virá por padrão o parâmetro como ‘false’

A diferença ficará no envio da requisição ao banco, em Integração Auditoria, ao ser enviado um boleto para a API com o parâmetro como ‘false’ ele gera uma numeração de tipo ‘inteiro’ com o CNPJ do inscrito. Com o parâmetro em ‘true’ ele enviará a string corretamente com o padrão alfanumérico. Caso não aja o arquivo da feature flag, ele considerará o parâmetro como true por padrão.