PHPackages marcuscampos/laravel-boleto - 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. marcuscampos/laravel-boleto ActiveLibrary marcuscampos/laravel-boleto =========================== Biblioteca com boletos para o laravel 0.19(8y ago)126MITPHPPHP >=5.5.0 Since Feb 2Pushed 8y ago1 watchersCompare [ Source](https://github.com/marcus-campos/laravel-boleto)[ Packagist](https://packagist.org/packages/marcuscampos/laravel-boleto)[ Docs](https://github.com/eduardokum/laravel-boleto)[ RSS](/packages/marcuscampos-laravel-boleto/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (7)Versions (22)Used By (0) [![Packagist](https://camo.githubusercontent.com/dd60e5d67703bc50bad7c9135ec3a5a985431cf5a016983535dcdf95252e50fa/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2e7376673f7374796c653d666c61742d737175617265)](https://github.com/eduardokum/laravel-boleto)[![Packagist](https://camo.githubusercontent.com/057b0e6ab2352a5805a4e17b4b27a9dbb79da5cc03e0b322c6cec4c33dc1a1e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2e7376673f7374796c653d666c61742d737175617265)](https://github.com/eduardokum/laravel-boleto)[![Packagist](https://camo.githubusercontent.com/88849d4ee23c3e5733f69aa81cbc0cc0151d8d12e1ca920fa01925a96993f304/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2e7376673f7374796c653d666c61742d737175617265)](https://github.com/eduardokum/laravel-boleto)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/0c3e7ecd047d9bb91931c1acad6a6200bb7de02c3cc19ba28c8664c08118fa92/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/eduardokum/laravel-boleto/?branch=master)[![Build Status](https://camo.githubusercontent.com/fdf23465cb8556409d9085cf22dff78fcfc7bc120e29b732db270654db7f7935/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/eduardokum/laravel-boleto/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/0c3e7ecd047d9bb91931c1acad6a6200bb7de02c3cc19ba28c8664c08118fa92/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/eduardokum/laravel-boleto/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/054d1caee9bf3c74d53ae36e9c47f2466b17918cd10c54da0892c406a6d183e8/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/eduardokum/laravel-boleto/?branch=master)[![Build Status](https://camo.githubusercontent.com/937940b59dc688a67fad9d66b07b59ca87478fded386f7ed5c021d05ee5134c3/68747470733a2f2f7472617669732d63692e6f72672f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/eduardokum/laravel-boleto)[![GitHub forks](https://camo.githubusercontent.com/ae46694c940f3d0db86f6168a0cc3a8e4c285e238b10a08f48e49d6407e9df9c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6564756172646f6b756d2f6c61726176656c2d626f6c65746f2e7376673f7374796c653d736f6369616c266c6162656c3d466f726b)](https://github.com/eduardokum/laravel-boleto) Laravel Boleto ============== [](#laravel-boleto) Pacote para gerar boletos, remessas e leitura de retorno. Para dúvidas ou sugestões utilize o nosso grupo de discussão ------------------------------------------------------------ [](#para-dúvidas-ou-sugestões-utilize-o-nosso-grupo-de-discussão) Requerimentos ------------- [](#requerimentos) - [PHP Extensão Intl](http://php.net/manual/pt_BR/book.intl.php) Links ----- [](#links) - [Documentação da API](http://eduardokum.github.io/laravel-boleto/) - [Grupo de Discussão](https://groups.google.com/d/forum/laravel-boleto) - [Grupo no Telegram](https://t.me/laravelBoleto) Bancos suportados ----------------- [](#bancos-suportados) BancoBoletoRemessa 400Remessa 240Retorno 400Retorno 240Banco do Brasil✅✅✅ \*✅Bancoob (Sicoob)✅ \*✅✅✅ \*✅ \*Banrisul✅✅✅ \*✅Bradesco✅✅✅ \*✅Caixa✅✅✅ \*✅Hsbc✅✅✅Itau✅✅✅ \*✅Santander✅✅✅ \*✅✅Sicredi✅✅✅ \*✅ \*Banco do Nordeste✅ \*✅ \***\* necessita de homologação** Instalação ---------- [](#instalação) Via composer: ``` composer require eduardokum/laravel-boleto ``` Ou adicione manualmente ao seu composer.json: ``` "eduardokum/laravel-boleto": "dev-master" ``` Gerar boleto ------------ [](#gerar-boleto) ### Criando o beneficiário ou pagador [](#criando-o-beneficiário-ou-pagador) ``` $beneficiario = new \Eduardokum\LaravelBoleto\Pessoa([ 'nome' => 'ACME', 'endereco' => 'Rua um, 123', 'cep' => '99999-999', 'uf' => 'UF', 'cidade' => 'CIDADE', 'documento' => '99.999.999/9999-99', ]); $pagador = new \Eduardokum\LaravelBoleto\Pessoa([ 'nome' => 'Cliente', 'endereco' => 'Rua um, 123', 'bairro' => 'Bairro', 'cep' => '99999-999', 'uf' => 'UF', 'cidade' => 'CIDADE', 'documento' => '999.999.999-99', ]); ``` ### Criando o objeto boleto [](#criando-o-objeto-boleto) #### Campos númericos e suas funções [](#campos-númericos-e-suas-funções) - **numero**: campo numérico utilizado para a criação do nosso numero. (identificação do título no banco)\* - **numeroControle**: campo de livre utilização. até 25 caracteres. *(identificação do título na empresa)* - **numeroDocumento**: campo utilizado para informar ao que o documento se referente *(duplicata, nf, np, ns, etc...)* ``` $boletoArray = [ 'logo' => 'path/para/o/logo', // Logo da empresa 'dataVencimento' => new \Carbon\Carbon('1790-01-01'), 'valor' => 100.00, 'multa' => 10.00, // porcento 'juros' => 2.00, // porcento ao mes 'juros_apos' => 1, // juros e multa após 'diasProtesto' => false, // protestar após, se for necessário 'numero' => 1, 'numeroDocumento' => 1, 'pagador' => $pagador, // Objeto PessoaContract 'beneficiario' => $beneficiario, // Objeto PessoaContract 'agencia' => 9999, // BB, Bradesco, CEF, HSBC, Itáu, Santander 'agenciaDv' => 9, // se possuir 'conta' => 99999, // BB, Bradesco, CEF, HSBC, Itáu, Santander 'contaDv' => 9, // Bradesco, HSBC, Itáu 'carteira' => 99, // BB, Bradesco, CEF, HSBC, Itáu, Santander 'convenio' => 9999999, // BB 'variacaoCarteira' => 99, // BB 'range' => 99999, // HSBC 'codigoCliente' => 99999, // Bradesco, CEF, Santander 'ios' => 0, // Santander 'descricaoDemonstrativo' => ['msg1', 'msg2', 'msg3'], // máximo de 5 'instrucoes' => ['inst1', 'inst2'], // máximo de 5 'aceite' => 1, 'especieDoc' => 'DM', ]; $boleto = new \Eduardokum\LaravelBoleto\Boleto\Banco\Bb($boletoArray); ``` ### Gerando o boleto [](#gerando-o-boleto) **Gerando o boleto a partir da instância do objeto (somente um boleto)** ``` $boleto->renderPDF(); // ou $boleto->renderHTML(); // Os dois métodos aceitam como parâmetro dois booleanos. // 1º Se True, após renderizado, irá mostrar a janela de impressão. O Valor default é false. // 2º Se False, irá esconder as instruções de impressão. O valor default é true. $boleto->renderPDF(true, false); // mostra a janela de impressão e esconde as instruções de impressão ``` ``` /* * O comportamento padrão para os métodos renderPDF() e renderHTML() é retornar uma string pura. * Para gerar um retorno no controller do laravel, utilize da seguinte forma: */ // PDF return response($boleto->renderPDF(), 200, [ 'Content-Type' => 'application/pdf', 'Content-Disposition' => 'inline; boleto.pdf', ]); // HTML return response($boleto->renderHTML()); ``` **Gerando boleto a partir da instância do render** ``` // Gerar em PDF $pdf = new Eduardokum\LaravelBoleto\Boleto\Render\Pdf(); $pdf->addBoleto($boleto); // Ou, para adicionar um array de boletos $pdf->addBoletos($boletos); // Quando não informado parâmetros ele se comportará como Pdf::OUTPUT_STANDARD, enviando o buffer do pdf com os headers apropriados. $pdf->gerarBoleto(); // Para mostrar a janela de impressão no load do PDF $pdf->showPrint(); // Para remover as intruções de impressão $pdf->hideInstrucoes(); // O método gerarBoleto() da classe PDF aceita como parâmetro: // 1º destino: constante com os destinos disponíveis. Ex: Pdf::OUTPUT_SAVE. // 2º path: caminho absoluto para salvar o pdf quando o destino for Pdf::OUTPUT_SAVE. //Ex: $pdf->gerarBoleto(Pdf::OUTPUT_SAVE, storage_path('app/boletos/meu_boleto.pdf')); // salva o boleto na pasta. $pdf_inline = $pdf->gerarBoleto(Pdf::OUTPUT_STRING); // retorna o boleto em formato string. $pdf->gerarBoleto(Pdf::OUTPUT_DOWNLOAD); // força o download pelo navegador. // Gerar em HTML $html = new Eduardokum\LaravelBoleto\Boleto\Render\Html(); $html->addBoleto($boleto); // Ou para adicionar um array de boletos $html->addBoletos($boletos); // Para mostrar a janela de impressão no load da página $html->showPrint(); // Para remover as intruções de impressão $html->hideInstrucoes(); $html->gerarBoleto(); ``` Gerar remessa ------------- [](#gerar-remessa) ``` $remessaArray = [ 'agencia' => 9999, 'agenciaDv' => 9, // se possuir 'conta' => 99999, 'contaDv' => 9, // se possuir 'carteira' => 99, 'convenio' => 9999999, // se possuir 'range' => 99999, // se possuir 'codigoCliente' => 99999, // se possuir 'variacaoCarteira' => 99, // se possuir 'beneficiario' => $beneficiario, ]; $remessa = new \Eduardokum\LaravelBoleto\Cnab\Remessa\Cnab400\Banco\Bb($remessaArray); // Adicionar um boleto $remessa->addBoleto($boleto); // Ou para adicionar um array de boletos $boletos = []; $boletos[] = $boleto1; $boletos[] = $boleto2; $boletos[] = $boleto3; $remessa->addBoletos($boletos); echo $remessa->gerar(); ``` Tratar retorno -------------- [](#tratar-retorno) ``` $retorno = \Eduardokum\LaravelBoleto\Cnab\Retorno\Factory::make('full_path_arquivo_retorno'); $retorno->processar(); echo $retorno->getBancoNome(); // Retorno implementa \SeekableIterator, sendo assim, podemos utilizar o foreach da seguinte forma: foreach($retorno as $registro) { var_dump($registro->toArray()); } // Ou também podemos: $detalheCollection = $retorno->getDetalhes(); foreach($detalheCollection as $detalhe) { var_dump($detalhe->toArray()); } // Ou até mesmo do jeito laravel $detalheCollection->each(function ($detalhe, $index) { var_dump($detalhe->toArray()) }); ``` **Métodos disponíveis:** ``` $retorno->getDetalhes(); $retorno->getHeader(); $retorno->getTrailer(); ``` ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community18 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 73.2% 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 ~32 days Recently: every ~9 days Total 19 Last Release 3170d ago PHP version history (2 changes)0.1PHP >=5.3.0 0.5PHP >=5.5.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/6387cc03c61adcd4afcc135430ff626ed014379a6312d66ace5b8a1d7e5282b8?d=identicon)[marcus-campos](/maintainers/marcus-campos) --- Top Contributors [![eduardokum](https://avatars.githubusercontent.com/u/2566340?v=4)](https://github.com/eduardokum "eduardokum (281 commits)")[![devguar](https://avatars.githubusercontent.com/u/6453377?v=4)](https://github.com/devguar "devguar (26 commits)")[![leonardopinho](https://avatars.githubusercontent.com/u/956680?v=4)](https://github.com/leonardopinho "leonardopinho (14 commits)")[![edigomes](https://avatars.githubusercontent.com/u/9788003?v=4)](https://github.com/edigomes "edigomes (14 commits)")[![guicouto](https://avatars.githubusercontent.com/u/8810377?v=4)](https://github.com/guicouto "guicouto (11 commits)")[![marcus-campos](https://avatars.githubusercontent.com/u/5151894?v=4)](https://github.com/marcus-campos "marcus-campos (10 commits)")[![mprandot](https://avatars.githubusercontent.com/u/14298396?v=4)](https://github.com/mprandot "mprandot (5 commits)")[![brnpimentel](https://avatars.githubusercontent.com/u/6596579?v=4)](https://github.com/brnpimentel "brnpimentel (4 commits)")[![luizguilhermefr](https://avatars.githubusercontent.com/u/6135939?v=4)](https://github.com/luizguilhermefr "luizguilhermefr (4 commits)")[![rafwell](https://avatars.githubusercontent.com/u/2893078?v=4)](https://github.com/rafwell "rafwell (3 commits)")[![renatoagomes](https://avatars.githubusercontent.com/u/9811888?v=4)](https://github.com/renatoagomes "renatoagomes (2 commits)")[![danielAlbuquerque](https://avatars.githubusercontent.com/u/6063722?v=4)](https://github.com/danielAlbuquerque "danielAlbuquerque (2 commits)")[![dbemfica](https://avatars.githubusercontent.com/u/13237440?v=4)](https://github.com/dbemfica "dbemfica (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")[![dann95](https://avatars.githubusercontent.com/u/9970959?v=4)](https://github.com/dann95 "dann95 (1 commits)")[![ricardobarantini](https://avatars.githubusercontent.com/u/1111361?v=4)](https://github.com/ricardobarantini "ricardobarantini (1 commits)")[![emtudo](https://avatars.githubusercontent.com/u/191396?v=4)](https://github.com/emtudo "emtudo (1 commits)")[![eduardokum-curso](https://avatars.githubusercontent.com/u/17689407?v=4)](https://github.com/eduardokum-curso "eduardokum-curso (1 commits)")[![edolfuchs](https://avatars.githubusercontent.com/u/12100777?v=4)](https://github.com/edolfuchs "edolfuchs (1 commits)")[![gustcortarelli](https://avatars.githubusercontent.com/u/13963779?v=4)](https://github.com/gustcortarelli "gustcortarelli (1 commits)") --- Tags laravel-boletoeduardokum ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/marcuscampos-laravel-boleto/health.svg) ``` [![Health](https://phpackages.com/badges/marcuscampos-laravel-boleto/health.svg)](https://phpackages.com/packages/marcuscampos-laravel-boleto) ``` ### Alternatives [tymon/jwt-auth JSON Web Token Authentication for Laravel and Lumen 11.5k49.1M350](/packages/tymon-jwt-auth)[laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k84.2M225](/packages/laravel-horizon)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k25.9M107](/packages/laravel-cashier)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k12.1M99](/packages/laravel-pulse)[spatie/laravel-honeypot Preventing spam submitted through forms 1.6k6.0M60](/packages/spatie-laravel-honeypot)[php-open-source-saver/jwt-auth JSON Web Token Authentication for Laravel and Lumen 8359.8M53](/packages/php-open-source-saver-jwt-auth) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)