alves/laravel-boleto

Biblioteca para geração de boletos, remessas e leitura de retornos no Laravel

v2.0.0 2026-02-24 13:16 UTC

Requires

• php: ^8.2
• ext-intl: *
• ext-mbstring: *
• laravel/framework: ^12.0
• neitanod/forceutf8: ^2.0
• nesbot/carbon: ^2.72|^3.0
• setasign/fpdf: ^1.8

Requires (Dev)

• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.5

MIT

• Alves Gusmão

• laravel-boleto
• Alves

README

Biblioteca para gerar boletos, remessas CNAB e leitura de arquivos de retorno no ecossistema Laravel.

Requisitos

• PHP 8.2 ou superior
• Laravel 12
• Extensões PHP: intl e mbstring

Instalação

composer require alves/laravel-boleto

Uso rápido

<?php

use Alves\LaravelBoleto\Boleto\Banco\Bradesco;
use Alves\LaravelBoleto\Pessoa;

$beneficiario = new Pessoa([
    'nome'      => 'ACME LTDA',
    'documento' => '12.345.678/0001-90',
    'endereco'  => 'Rua 1',
    'bairro'    => 'Centro',
    'cep'       => '99999-999',
    'uf'        => 'SP',
    'cidade'    => 'São Paulo',
]);

$pagador = new Pessoa([
    'nome'      => 'Cliente Teste',
    'documento' => '123.456.789-09',
    'endereco'  => 'Rua 2',
    'bairro'    => 'Centro',
    'cep'       => '99999-999',
    'uf'        => 'SP',
    'cidade'    => 'São Paulo',
]);

$boleto = new Bradesco([
    'logo'            => realpath(__DIR__ . '/logos/237.png'),
    'dataVencimento'  => new DateTime(),
    'valor'           => 100.00,
    'multa'           => false,
    'juros'           => false,
    'numero'          => 1,
    'numeroDocumento' => 1,
    'pagador'         => $pagador,
    'beneficiario'    => $beneficiario,
    'agencia'         => 1111,
    'conta'           => 99999,
    'carteira'        => 9,
]);

Exemplos

Os exemplos completos estão na pasta exemplos/:

• Geração de boletos por banco
• Geração de remessas CNAB 240/400
• Leitura de arquivos de retorno

Bancos suportados

• Banco do Brasil
• Bancoob
• Banrisul
• Bradesco
• Caixa
• HSBC
• Itaú
• Santander
• Sicredi
• BNB
• Safra

Estrutura do projeto

• src/: núcleo da biblioteca
• exemplos/: scripts de referência
• logos/: logos utilizados nos boletos
• docker/: ambiente de apoio para desenvolvimento local

Autor e manutenção

Este fork/estrutura é mantido por Alves Gusmão.

Se quiser contribuir:

1. Abra uma issue descrevendo a melhoria ou problema.
2. Envie um PR com alteração objetiva e testável.
3. Inclua evidências de funcionamento (exemplo gerado, retorno processado ou teste).

Licença

Este projeto está licenciado sob a MIT.