2017 © Pedro Peláez
 

library laravel-boleto

Biblioteca de boletos para o laravel

image

diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  • Thursday, May 25, 2017
  • by diegomoura
  • Repository
  • 1 Watchers
  • 1 Stars
  • 16 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 150 Forks
  • 0 Open issues
  • 19 Versions
  • 7 % Grown

The README.md

Packagist Packagist Packagist Scrutinizer Code Quality Build Status Scrutinizer Code Quality Code Coverage Build Status GitHub forks, (*1)

Laravel Boleto

Pacote para gerar boletos, remessas e leitura de retorno., (*2)

Para dúvidas ou sugestões utilize o nosso grupo de discussão

Requerimentos

Bancos suportados

Banco Boleto Remessa 400 Remessa 240 Retorno 400 Retorno 240
Banco do Brasil :white_check_mark: :white_check_mark: :white_check_mark:
Bancoob (Sicoob) :white_check_mark: * :white_check_mark: :white_check_mark: *
Banrisul :white_check_mark: :white_check_mark: :white_check_mark:
Bradesco :white_check_mark: :white_check_mark: :white_check_mark:
Caixa :white_check_mark: :white_check_mark: :white_check_mark:
Hsbc :white_check_mark: :white_check_mark: :white_check_mark:
Itau :white_check_mark: :white_check_mark: :white_check_mark:
Santander :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Sicredi :white_check_mark: :white_check_mark: :white_check_mark: *

* necessita de homologação, (*3)

Instalação

Via composer:, (*4)

composer require Diegomoura/laravel-boleto, (*5)

Ou adicione manualmente ao seu composer.json:, (*6)

"Diegomoura/laravel-boleto": "dev-master", (*7)

Gerar boleto

Criando o beneficiário ou pagador

$beneficiario = new \Diegomoura\LaravelBoleto\Pessoa([
    'nome' => 'ACME',
    'endereco' => 'Rua um, 123',
    'cep' => '99999-999',
    'uf' => 'UF',
    'cidade' => 'CIDADE',
    'documento' => '99.999.999/9999-99',
]);

$pagador = new \Diegomoura\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

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 \Diegomoura\LaravelBoleto\Boleto\Banco\Bb($boletoArray);

Gerando o boleto

Gerando o boleto a partir da instância do objeto (somente um boleto), (*8)

$boleto->renderPDF();
// ou
$boleto->renderHTML();

// Os dois métodos aceita como parâmetro 2 boleano.
// 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

```php /* * O comportamento padrão para os métodos renderPDF e renderHTM é retornar uma string pura. * Para gerar um retorno no controller do laravel utilize da seguinte forma: */, (*9)

// PDF return response($boleto->renderPDF(), 200, [ 'Content-Type' => 'application/pdf', 'Content-Disposition' => 'inline; boleto.pdf', ]);, (*10)

// HTML return response($boleto->renderHTML());, (*11)


**Gerando boleto a partir da instância do render**


```php
// Gerar em PDF
$pdf = new Diegomoura\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 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 Diegomoura\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

$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 \Diegomoura\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

$retorno = \Diegomoura\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->getDados());
}

// Ou também podemos:
$detalheCollection = $retorno->getDetalhes();
foreach($detalheCollection as $detalhe) {
    var_dump($detalhe->getDados());
}

// Ou até mesmo do jeito laravel
$detalheCollection->each(function ($detalhe, $index) {
    var_dump($detalhe->getDados())
});

Métodos disponíveis:, (*12)

$retorno->getDetalhes();

$retorno->getHeader();

$retorno->getTrailer();

The Versions

25/05 2017

dev-master

9999999-dev https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

25/05 2017

2.0

2.0.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

16/03 2017

1.8

1.8.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

16/03 2017

1.9

1.9.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

15/03 2017

1.6

1.6.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

15/03 2017

1.7

1.7.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

13/03 2017

1.5

1.5.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

13/03 2017

1.3

1.3.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

13/03 2017

1.4

1.4.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

13/03 2017

1.2

1.2.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca de boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

13/03 2017

1.1

1.1.0.0 https://github.com/diegomoura/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Diego de Moura Silva

laravel-boleto diegomoura

08/03 2017

1.0

1.0.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Eduardo Gusmão

laravel-boleto eduardokum

08/03 2017

dev-develop

dev-develop https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Eduardo Gusmão

laravel-boleto eduardokum

01/02 2017

0.5

0.5.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Eduardo Gusmão

laravel-boleto eduardokum

26/10 2016

0.4

0.4.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

by Eduardo Gusmão

laravel-boleto eduardokum

22/06 2016

0.3.1

0.3.1.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

by Eduardo Gusmão

laravel-boleto eduardokum

25/02 2016

0.3

0.3.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

by Eduardo Gusmão

laravel-boleto eduardokum

24/02 2016

0.2

0.2.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

by Eduardo Gusmão

laravel-boleto eduardokum

02/02 2016

0.1

0.1.0.0 https://github.com/eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

  Sources   Download

MIT

The Requires

 

by Eduardo Gusmão

laravel-boleto eduardokum