Versão inicial: 1.0.0

Identificação: “001“, “1“, “BB” ou “Banco do Brasil”

Carteiras: 31, 11, 17, 12, 51, 16 e 18.

Geral

Os seguintes parâmetros se aplicam a todas as carteiras.

• AGENCIA_NUMERO: 04 dígitos;
• AGENCIA_DV: 01 digito;
• CONTA_CORRENTE_NUMERO: 08 dígitos;
• CONTA_CORRENTE_DV: 01 digito.
• CARTEIRA: 02 dígitos;
• CARTEIRA_MODALIDADE: até 08 dígitos (Carteira que será exibida no boleto);
• CARTEIRA_VARIACAO – Variação da carteira no BB.

Convênio de 04 posições

• NOSSO_NUMERO: 07 dígitos (Sem DV);
• CONVENIO_NUMERO: 04 dígitos.

Convênio de 06 posições

Cobrança com registro

• NOSSO_NUMERO: 05 dígitos (Sem DV);
• CONVENIO_NUMERO: 06 dígitos.

Cobrança sem registro

As carteiras 16 e 18 são da modalidade de cobrança sem registro e tem o nosso número livre de 17 posições.

• NOSSO_NUMERO: 17 dígitos (Sem DV);
• CONVENIO_NUMERO: 06 dígitos.

Convênio de 07 posições (Acima de 1.000.000)

• NOSSO_NUMERO: 10 dígitos (Sem DV);
• CONVENIO_NUMERO: (Letras) 07 dígitos;
• CARTEIRA_CONVENIO: 07 dígitos (Depreciada usar “CONVENIO_NUMERO”);
• OCORRENCIA (Letras): Pode ser passado “INCLUSAO” ou “EXCLUSAO”, ou o código da operação para as posições 109 a 110 (Usado na remessa apenas);
• DOCUMENTO_ESPECIE (Letras): posições 148 a 149.

WebService (V2)

Para se conectar via WebService através da API intitulada “Cobrança Bancária” adicione os dados abaixo no mapeamento com os dados de inicialização.

Dados de conexão

• CONVENIO_NUMERO: Número do convênio junto ao BB;
• CARTEIRA – Número da carteira fornecida pelo BB.
• CARTEIRA_VARIACAO – Número de variação da carteira (02 dígitos).
• CERTIFICADO_ARQUIVO – Caminho absoluto do arquivo no formato PFX;
• CERTIFICADO_SENHA – Senha do arquivo PFX;
• CLIENT_ID – Fornecido pelo BB;
• CLIENT_SECRET – Fornecido pelo BB;
• developer_application_key (Letras): Fornecido pelo BB.

Dados de homologação

Paga obter os dados de teste, no portal do desenvolvedor ( https://app.developers.bb.com.br/ ). Não é necessário certificado em homologação (Verificado por último em NOV/2023).

ATENÇÃO: Qualquer instrução/suporte sobre como criar a conta de testes, ou dados como Convênio, Carteira, Variação… Ou instruções sobre o que preencher nos campos deve ser tirada diretamente junto ao banco. O suporte a API se limita ao uso das funções com os dados válidos. Você pode optar por suporte complementar, favor verificar custos e disponibilidade.

Principais erros

• “Convenio/Carteira/Variacao nao cadastrado.“: Verifique os dados corretos junto ao banco;
• Java antigo: A versão do Java 1.8 deve ser a mais recente, final acima de 400 (o Maker consuma ver com o Java 1.8.0_281 em 2024, esta versão não deve ser atualizada).