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 digitos;
• AGENCIA_DV: 01 digito;
• CONTA_CORRENTE_NUMERO: 08 digitos;
• CONTA_CORRENTE_DV: 01 digito.
• CARTEIRA: 02 digitos;
• CARTEIRA_MODALIDADE: até 08 digitos (Carteira que será exibida no boleto);
• CARTEIRA_VARIACAO – Variação da carteira no BB.

Convênio de 04 posições

• NOSSO_NUMERO: 07 digitos (Sem DV);
• CONVENIO_NUMERO: 04 digitos.

Convênio de 06 posições

Cobrança com registro

• NOSSO_NUMERO: 05 digitos (Sem DV);
• CONVENIO_NUMERO: 06 digitos.

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 digitos (Sem DV);
• CONVENIO_NUMERO: 06 digitos.

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: Pode ser passado “INCLUSAO” ou “EXCLUSAO”, ou o código da operação para as posições 109 a 110;
• 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.