PHPackages brenoleite8/yii2-boleto-remessa - 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. brenoleite8/yii2-boleto-remessa ActiveLibrary brenoleite8/yii2-boleto-remessa =============================== Biblioteca com boletos e sistema de remessa e retorno para o Yii2 Framework (Fork from newerton/yii2-boleto-remessa) 046PHP Since Mar 3Pushed 1y agoCompare [ Source](https://github.com/brenoleite8/yii2-boleto-remessa-adianti)[ Packagist](https://packagist.org/packages/brenoleite8/yii2-boleto-remessa)[ RSS](/packages/brenoleite8-yii2-boleto-remessa/feed)WikiDiscussions fpdf Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Yii2 Boleto, Remessa e Retorno ============================== [](#yii2-boleto-remessa-e-retorno) Pacote para gerar boletos, remessas e leitura de retorno. Requerimentos ------------- [](#requerimentos) - [PHP Extensão Intl](http://php.net/manual/pt_BR/book.intl.php) Links ----- [](#links) - [Documentação da API](http://newerton.github.io/yii2-boleto-remessa/) - [Documentos Oficiais para gerar Boleto e Remessa](https://github.com/newerton/docs-boleto-remessa) 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 newerton/yii2-boleto-remessa ``` Ou adicione manualmente ao seu composer.json: ``` "newerton/yii2-boleto-remessa": "dev-master" ``` Gerar boleto ------------ [](#gerar-boleto) ### Criando o beneficiário ou pagador [](#criando-o-beneficiário-ou-pagador) ``` $beneficiario = new \Newerton\Yii2Boleto\Pessoa([ 'nome' => 'ACME', 'endereco' => 'Rua um, 123', 'cep' => '99999-999', 'uf' => 'UF', 'cidade' => 'CIDADE', 'documento' => '99.999.999/9999-99', ]); $pagador = new \Newerton\Yii2Boleto\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 '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 \Newerton\Yii2Boleto\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 yii2, utilize da seguinte forma: */ // PDF Yii::$app->response->format = \yii\web\Response::FORMAT_RAW; $headers = Yii::$app->response->headers; $headers->add('Content-Type', 'application/pdf'); $headers->add('Content-Disposition', 'nline; boleto.pdf'); return $boleto->renderPDF(); // HTML return $boleto->renderHTML(); ``` **Gerando boleto a partir da instância do render** ``` // Gerar em PDF $pdf = new \Newerton\Yii2Boleto\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(); // Para incluir Comprovante de entrega do boleto $pdf->showComprovante(); // 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, Yii::getAlias('@webroot/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 \Newerton\Yii2Boleto\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 \Newerton\Yii2Boleto\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 = \Newerton\Yii2Boleto\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 17 — LowBetter than 6% of packages Maintenance34 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community13 Small or concentrated contributor base Maturity15 Early-stage or recently created project Bus Factor2 2 contributors hold 50%+ of commits 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/23b42430294e1918eb0368868e748b7efb5c8fbd8a66ceec132dc81f98f6d99c?d=identicon)[brenoleite8](/maintainers/brenoleite8) --- Top Contributors [![newerton](https://avatars.githubusercontent.com/u/4175945?v=4)](https://github.com/newerton "newerton (43 commits)")[![ctoigo](https://avatars.githubusercontent.com/u/2913382?v=4)](https://github.com/ctoigo "ctoigo (24 commits)")[![brenoleite8](https://avatars.githubusercontent.com/u/71729212?v=4)](https://github.com/brenoleite8 "brenoleite8 (12 commits)")[![LucianoHanna](https://avatars.githubusercontent.com/u/22209724?v=4)](https://github.com/LucianoHanna "LucianoHanna (3 commits)")[![soareseneves](https://avatars.githubusercontent.com/u/16960561?v=4)](https://github.com/soareseneves "soareseneves (2 commits)")[![mauhk](https://avatars.githubusercontent.com/u/12595727?v=4)](https://github.com/mauhk "mauhk (1 commits)")[![alvarolordelo](https://avatars.githubusercontent.com/u/1663952?v=4)](https://github.com/alvarolordelo "alvarolordelo (1 commits)")[![Rafaeldsb](https://avatars.githubusercontent.com/u/30494252?v=4)](https://github.com/Rafaeldsb "Rafaeldsb (1 commits)")[![ricardorv](https://avatars.githubusercontent.com/u/1495126?v=4)](https://github.com/ricardorv "ricardorv (1 commits)") ### Embed Badge ![Health badge](/badges/brenoleite8-yii2-boleto-remessa/health.svg) ``` [![Health](https://phpackages.com/badges/brenoleite8-yii2-boleto-remessa/health.svg)](https://phpackages.com/packages/brenoleite8-yii2-boleto-remessa) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)