PHPackages                             gustavohmelo/integracao-bb-cobranca - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. gustavohmelo/integracao-bb-cobranca

ActiveLibrary[API Development](/categories/api)

gustavohmelo/integracao-bb-cobranca
===================================

Integração com a API de cobrança do Banco do Brasil

v1.0.1(3y ago)0182MITPHP

Since Sep 3Pushed 3y ago1 watchersCompare

[ Source](https://github.com/gustavohmelo/integracao-bb-cobranca)[ Packagist](https://packagist.org/packages/gustavohmelo/integracao-bb-cobranca)[ RSS](/packages/gustavohmelo-integracao-bb-cobranca/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Integração com a API de Cobranças do Banco do Brasil
====================================================

[](#integração-com-a-api-de-cobranças-do-banco-do-brasil)

[![Packagist](https://camo.githubusercontent.com/83879afdc4ea1e98eb0383baf9fd556bad11c676bb9f97acf42e9e90fbfbb604/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6775737461766f686d656c6f2f696e746567726163616f2d62622d636f6272616e63612e7376673f7374796c653d666c61742d737175617265)](https://github.com/gustavohmelo/integracao-bb-cobranca)

Intanciar a classe
------------------

[](#intanciar-a-classe)

```
Valores disponiveis para "Enviroment" = "sandbox" ou "production"
$bancoBrasil = new BancoBrasil('clientId', 'clientSecret', 'developerKey', 'enviroment');
```

Gerar Token
-----------

[](#gerar-token)

```
$token = $bancoBrasil->getTokenAcess();
```

Registrar Boleto
----------------

[](#registrar-boleto)

```
$registro = [
    'numeroConvenio' => '',
    'numeroCarteira' => '17',
    'numeroVariacaoCarteira' => '35',
    'codigoModalidade' => '01', //Identifica a característica dos boletos dentro das modalidades de cobrança existentes no banco. Domínio: 01 - SIMPLES; 04 - VINCULADA
    'dataEmissao' => '30.03.2021', //Data de emissão do boleto (formato "dd.mm.aaaaa").
    'dataVencimento' => '31.03.2021', //Data de vencimento do boleto (formato "dd.mm.aaaaa").
    'valorOriginal' => '10', //Valor de cobrança > 0.00, emitido em Real (formato decimal separado por "."). Valor do boleto no registro. Deve ser maior que a soma dos campos “VALOR DO DESCONTO DO TÍTULO” e “VALOR DO ABATIMENTO DO TÍTULO”, se informados. Informação não passível de alteração após a criação. No caso de emissão com valor equivocado, sugerimos cancelar e emitir novo boleto.
    'valorAbatimento' => '0',
    'quantidadeDiasProtesto' => '',
    'quantidadeDiasNegativacao' => '',
    'orgaoNegativador' => '',
    'indicadorAceiteTituloVencido' => 'S',
    'numeroDiasLimiteRecebimento' => '90',
    'codigoAceite' => 'A',
    'codigoTipoTitulo' => '2',
    'descricaoTipoTitulo' => 'DUPLICATA MERCANTIL',
    'indicadorPermissaoRecebimentoParcial' => 'N',
    'numeroTituloBeneficiario' => '1',
    'campoUtilizacaoBeneficiario' => 'UM TEXTO',
    'numeroTituloCliente' => 'nossonumero',
    'mensagemBloquetoOcorrencia' => '',
    'desconto' => [
        'tipo' => '',
        'dataExpiracao' => '',
        'porcentagem' => '',
        'valor' => '',
    ],
    'segundoDesconto' => [
        'dataExpiracao' => '',
        'porcentagem' => '',
        'valor' => '',
    ],
    'terceiroDesconto' => [
        'dataExpiracao' => '',
        'porcentagem' => '',
        'valor' => '',
    ],
    'jurosMora' => [
        'tipo' => '',
        'porcentagem' => '',
        'valor' => '',
    ],
    'multa' => [
        'tipo' => '',
        'data' => '',
        'porcentagem' => '',
        'valor' => '',
    ],
    'pagador' => [
        'tipoInscricao' => '1',
        'numeroInscricao' => '',
        'nome' => '',
        'endereco' => '',
        'cep' => '',
        'cidade' => '',
        'bairro' => '',
        'uf' => '',
        'telefone' => '',
    ],
    'beneficiarioFinal' => [
        'tipoInscricao' => '1',
        'numeroInscricao' => '',
        'nome' => '',
    ],
    'indicadorPix' => 'S'
]

$registrar = $bancoBrasil->register($registro);
```

Consultar Boleto
----------------

[](#consultar-boleto)

```
$id_boleto = 'nossonumero';
$numeroConvenio = '';
$listar = $bancoBrasil->read($id_boleto, $numeroConvenio);
```

Editar Boleto
-------------

[](#editar-boleto)

```
$id_boleto = 'nossonumero';
$data = [
    'numeroConvenio' =>  '3128557',
    'indicadorNovaDataVencimento' => 'S',
    'alteracaoData' => [
        'novaDataVencimento' => '01.04.2021',
    ],
    'indicadorAtribuirDesconto' => 'N',
    'desconto' => [
        'tipoPrimeiroDesconto' => '',
        'valorPrimeiroDesconto' => '',
        'percentualPrimeiroDesconto' => '',
        'dataPrimeiroDesconto' => '',
        'tipoSegundoDesconto' => '',
        'valorSegundoDesconto' => '',
        'percentualSegundoDesconto' => '',
        'dataSegundoDesconto' => '',
        'tipoTerceiroDesconto' => '',
        'valorTerceiroDesconto' => '',
        'percentualTerceiroDesconto' => '',
        'dataTerceiroDesconto' => '',
    ],
    'indicadorAlterarDesconto' => 'N',
    'alteracaoDesconto' => [
        'tipoPrimeiroDesconto' => '',
        'novoValorPrimeiroDesconto' => '',
        'novoPercentualPrimeiroDesconto' => '',
        'novaDataLimitePrimeiroDesconto' => '',
        'tipoSegundoDesconto' => '',
        'novoValorSegundoDesconto' => '',
        'novoPercentualSegundoDesconto' => '',
        'novaDataLimiteSegundoDesconto' => '',
        'tipoTerceiroDesconto' => '',
        'novoValorTerceiroDesconto' => '',
        'novoPercentualTerceiroDesconto' => '',
        'novaDataLimiteTerceiroDesconto' => '',
    ],
    'indicadorAlterarDataDesconto' => 'N',
    'alteracaoDataDesconto' => [
        'novaDataLimitePrimeiroDesconto' => '',
        'novaDataLimiteSegundoDesconto' => '',
        'novaDataLimiteTerceiroDesconto' => '',
    ],
    'indicadorProtestar' => 'N',
    'protesto' => [
        'quantidadeDiasProtesto' => '',
    ],
    'indicadorSustacaoProtesto' => 'N',
    'indicadorCancelarProtesto' => 'N',
    'indicadorIncluirAbatimento' => 'N',
    'abatimento' => [
        'valorAbatimento' => '',
    ],
    'indicadorCancelarAbatimento' => 'N',
    'alteracaoAbatimento' => [
        'novoValorAbatimento' => '',
    ],
    'indicadorCobrarJuros' => 'N',
    'juros' => [
        'tipoJuros' => '',
        'valorJuros' => '',
        'taxaJuros' => '',
    ],
    'indicadorDispensarJuros' => 'N',
    'indicadorCobrarMulta' => 'N',
    'multa' => [
        'tipoMulta' => '',
        'valorMulta' => '',
        'dataInicioMulta' => '',
        'taxaMulta' => '',
    ],
    'indicadorDispensarMulta' => 'N',
    'indicadorNegativar' => 'N',
    'negativacao' => [
        'quantidadeDiasNegativacao' => '',
        'tipoNegativacao' => '',
    ],
    'indicadorAlterarSeuNumero' => 'N',
    'alteracaoSeuNumero' => [
        'codigoSeuNumero' => '',
    ],
    'indicadorAlterarEnderecoPagador' => 'N',
    'alteracaoEndereco' => [
        'enderecoPagador' => '',
        'bairroPagador' => '',
        'cidadePagador' => '',
        'UFPagador' => '',
        'CEPPagador' => '',
    ],
    'indicadorAlterarPrazoBoletoVencido' => 'N',
    'alteracaoPrazo' => [
        'quantidadeDiasAceite' => '',
    ]
];

$alterar = $bancoBrasil->alter($id_boleto, $data);
```

Baixar Boleto
-------------

[](#baixar-boleto)

```
$id_boleto = 'nossonumero';
$baixar[
    'numeroConvenio' => 'convenio'
];

$baixar = $bancoBrasil->baixar($id_boleto, $baixar);
```

Informações
-----------

[](#informações)

Para mais informações sobre a API utilizada nesta integração, [Acesse este link](https://apoio.developers.bb.com.br/referency/post/5f9c2149f39b8500120ab13c)

### Exemplo

[](#exemplo)

Para ver a implementação dos métodos disponiveis, veja o arquivo example.php

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~38 days

Total

2

Last Release

1309d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7293ee8d52d1c56e7a013eaeb8fd3214d5025b5e8d8e49d99ab66d84b7c2b5eb?d=identicon)[magus94](/maintainers/magus94)

---

Top Contributors

[![gustavohmelo](https://avatars.githubusercontent.com/u/39380116?v=4)](https://github.com/gustavohmelo "gustavohmelo (5 commits)")[![marcelomelojr](https://avatars.githubusercontent.com/u/42653290?v=4)](https://github.com/marcelomelojr "marcelomelojr (1 commits)")

---

Tags

php

### Embed Badge

![Health badge](/badges/gustavohmelo-integracao-bb-cobranca/health.svg)

```
[![Health](https://phpackages.com/badges/gustavohmelo-integracao-bb-cobranca/health.svg)](https://phpackages.com/packages/gustavohmelo-integracao-bb-cobranca)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)