PHPackages kkelf/bbboletocobranca - 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. [Utility & Helpers](/categories/utility) 4. / 5. kkelf/bbboletocobranca ActiveLibrary[Utility & Helpers](/categories/utility) kkelf/bbboletocobranca ====================== Boleto Banco do Brasil 1.0.18(10mo ago)0107LGPL-3.0-onlyPHPPHP >=7.0 Since Aug 28Pushed 10mo ago1 watchersCompare [ Source](https://github.com/kkelf/BBboletoCobranca)[ Packagist](https://packagist.org/packages/kkelf/bbboletocobranca)[ RSS](/packages/kkelf-bbboletocobranca/feed)WikiDiscussions main Synced 3d ago READMEChangelogDependencies (8)Versions (20)Used By (0) Boleto de Cobrança Banco do Brasil via Cobranças API ==================================================== [](#boleto-de-cobrança-banco-do-brasil-via-cobranças-api) Integração com a API de Cobranças do Banco do Brasil para registro de Boletos com QR Code Pix Projeto baseado no BBboleto e impressão baseada no novoboletophp. Link dos projetos: - Bbboleto: - novoboletophp: Instalação ---------- [](#instalação) ### Composer [](#composer) ``` composer require kkelf/bbboletocobranca ``` Ou no arquivo composer.json. ``` "kkelf/bbboletocobranca": "^1.0.0" ``` Como usar --------- [](#como-usar) ``` use BBboletoCobranca\BancoDoBrasil; use BBboletoCobranca\Constants\IndicadorPix; use BBboletoCobranca\Constants\TipoDocumento; use BBboletoCobranca\Entities\PagadorEntity; use BBboletoCobranca\Entities\BeneficiarioEntity; use BBboletoCobranca\Entities\InstrucoesEntity; use BBboletoCobranca\Requests\BoletoRequest; $bancoDoBrasil = new BancoDoBrasil([ 'clientId' => 'xxxxxxxxxxx', 'clientSecret' => 'xxxxxxxxx', 'gw_dev_app_key' => 'xxxxxx', 'logo' => 'http://placehold.it/200&text=logo', 'production' => false, 'formato' => 'html' // ou 'pdf' ]); $beneficiario = new BeneficiarioEntity; $beneficiario->setTipoDocumento(TipoDocumento::CNPJ) ->setDocumento('92.862.701/0001-58') ->setNome('DOCERIA BARBOSA DE ALMEIDA'); $pagador = new PagadorEntity; $pagador->setTipoDocumento(TipoDocumento::CPF) ->setDocumento('97965940132') ->setNome('João da Costa Antunes') ->setLogradouro('Avenida Dias Gomes 1970') ->setCep(77458000) ->setMunicipio('Sucupira') ->setBairro('Centro') ->setUf('TO'); $instrucoes = new InstrucoesEntity; $instrucoes->setInstrucoes([ '- instrução 1', '- instrução teste 2', '- instrução teste 3', ]) ->setDemonstrativo("Demonstrativo teste"); $boletoRequest = new BoletoRequest(); $boletoRequest->setConvenio(3128557) ->setCarteira(17) ->setVariacaoCarteira(35) ->setDataEmissao('2023-08-23') ->setDataVencimento('31/08/2023') ->setValorOriginal('00,21') ->setSeuNumero('987654321987654') // número para controle ->setNossoNumero('0000100017') // nosso número sequencial do banco ->setPagador($pagador) ->setBeneficiario($beneficiario) ->setInstrucoes($instrucoes) ->setIndicadorPix(IndicadorPix::QRCODE_DINAMICO); //se o formato for pdf será baixado automaticamente no register $data = $bancoDoBrasil->register($boletoRequest); echo $data; ``` Instruções ---------- [](#instruções) Para adicionar instruções que são impressas no boleto, é necessário preencher a entidade Instruções e "setar" no BoletoRequest. As instruções adicionadas abaixo serão impressas no boleto, elas estão relacionadas ao desconto, juros, multa e qualquer tipo de especificidade ligada a informação que deve ser apresentada ao pagador. ``` // ... code use BBboletoCobranca\Entities\InstrucoesEntity; $instrucoes = new InstrucoesEntity; $instrucoes->setInstrucoes([ '- instrução 1', '- instrução teste 2', '- instrução teste 3', ])->setDemonstrativo("Demonstrativo teste"); $boletoRequest = new BoletoRequest(); //... outros set's ->setInstrucoes($instrucoes) // ... ``` Desconto -------- [](#desconto) Para adicionar a instrução de desconto em seu boleto é necessário preencher a entendidade Desconto e "setar" no BoletoRequest. Nota: O desconto é opcional, caso não tenha desconto no título não há necessidade de preencher esta entidade e tbm não há necessidade de "setar" no Request ``` // ... code use BBboletoCobranca\Entities\DescontoEntity; use BBboletoCobranca\Constants\Desconto; $desconto = new DescontoEntity; $desconto->setTipo(Desconto::VALOR) ->setData('10/07/2018') ->setValor('5.00'); $boletoRequest = new BoletoRequest(); //... outros set's ->setDesconto($desconto) // ... ``` Juros ----- [](#juros) Para adicionar a instrução de juros em seu boleto é necessário preencher a entendidade Juros e "setar" no BoletoRequest. Juros possui uma combinação de valores informados que se passados de forma incorreta o Banco não aceitará os dados e consequentemente não irá registrar o boleto. Nota: O Juros é opcional, caso não tenha desconto no título não há necessiade de preencher esta entidade e tbm não há necessidade de "setar" no Request ``` // ... code use BBboletoCobranca\Entities\JurosEntity; use BBboletoCobranca\Constants\Juros; // ... code $juros = new JurosEntity; $juros->setTipo(Juros::VALOR_POR_DIA_DE_ATRASO) ->setValor('10.00'); $boletoRequest = new BoletoRequest(); //... outros set's ->setJuros($juros) // ... ``` Multa ----- [](#multa) Para adicionar a instrução de multa em seu boleto é necessário preencher a entendidade Multa e "setar" no BoletoRequest. A Multa assim como o Juros possui uma combinação de valores informados que se passados de forma incorreta o Banco não aceitará os dados e consequentemente não irá registrar o boleto. Nota: A Multa é opcional, caso não tenha desconto no título não há necessiade de preencher esta entidade e tbm não há necessidade de "setar" no Request ``` // ... code use BBboletoCobranca\Entities\MultaEntity; use BBboletoCobranca\Constants\Multa; // ... code $multa = new MultaEntity; $multa->setTipo(Multa::VALOR) ->setValor('10.00'); $boletoRequest = new BoletoRequest(); //... outros set's ->setMulta($multa) // ... ``` Avalista -------- [](#avalista) Para adicionar avalista em seu boleto é necessário preencher a entendidade Multa e "setar" no BoletoRequest. Nota: O Avalista é opcional, caso não tenha desconto no título não há necessiade de preencher esta entidade e tbm não há necessidade de "setar" no Request ``` // ... code use BBboletoCobranca\Constants\TipoDocumento; use BBboletoCobranca\Entities\AvalistaEntity; // ... code $avalista = new AvalistaEntity; $avalista->setTipoDocumento(TipoDocumento::CNPJ) ->setDocumento('09.123.123\0001-81') ->setNome('Ewerson Carvalho'); $boletoRequest = new BoletoRequest(); //... outros set's ->setAvalista($avalista) // ... ``` ### Health Score 32 — LowBetter than 69% of packages Maintenance54 Moderate activity, may be stable Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~41 days Recently: every ~61 days Total 19 Last Release 306d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/124356110?v=4)[Kleber Kelf](/maintainers/kkelf)[@kkelf](https://github.com/kkelf) --- Top Contributors [![kkelf](https://avatars.githubusercontent.com/u/124356110?v=4)](https://github.com/kkelf "kkelf (23 commits)") ### Embed Badge ![Health badge](/badges/kkelf-bbboletocobranca/health.svg) ``` [![Health](https://phpackages.com/badges/kkelf-bbboletocobranca/health.svg)](https://phpackages.com/packages/kkelf-bbboletocobranca) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M3.1k](/packages/craftcms-cms)[laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k95.4M307](/packages/laravel-horizon)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[flarum/core Delightfully simple forum software. 201.4M2.3k](/packages/flarum-core)[nativephp/mobile NativePHP for Mobile 1.1k75.1k97](/packages/nativephp-mobile) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)