umbrella/retorno-boleto

Biblioteca em PHP para leitura de arquivos de retorno de títulos de cobrança de bancos brasileiros.

Installs: 1 762

Dependents: 1

Stars: 9

Watchers: 7

Forks: 4

Open Issues: 2

Language: PHP

1.3.3 2015-08-20 14:40 UTC

README

Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Downloads

SensioLabsInsight

O que é?

Biblioteca em PHP para leitura de arquivos de retorno de títulos de cobrança de bancos brasileiros.

Arquivos suportados:

Banco CNAB Implementado Testado Banco do Brasil 150, 240,400 Sim Sim Bradesco 400 - personalizado Não Não Caixa Economica 150, 240 Sim Sim HSBC 150, 240,400 Sim Sim Itau 150, 240,400 Sim Sim Santander 150, 240,400 Sim Sim

Instalação

# Install Composer
curl -sS https://getcomposer.org/installer | php

# Adicionando YA Retorno Boleto como dependencia
php composer.phar require umbrella/retorno-boleto:~1.2

Após a instalação, é necessário carregar o autoloader do composer:

require 'vendor/autoload.php';

Uso

Para lermos um arquivo de retorno, utilizamos uma factory que nos dirao tipo correto do arquivo e passaremos ele para um processador que irá lhe retornar o objeto do arquivo de retorno.

use Umbrella\Ya\RetornoBoleto\ProcessFactory;
use Umbrella\Ya\RetornoBoleto\ProcessHandler;

// Utilizamos a factory para construir o objeto correto para um determinado arquivo de retorno
$cnab = ProcessFactory::getRetorno('arquivo-retorno.ret');

// Passamos o objeto contruido para o handler
$processor = new ProcessHandler($cnab);

// Processamos o arquivo. Isso retornará um objeto parseado com todas as propriedades do arquvio.
$retorno = $processor->processar();

Eventos

O retorno-boleto tem suporte a eventos utilizando o componente EventDispatcher do symfony.

use Umbrella\Ya\RetornoBoleto\Event\OnDetailRegisterEvent;
use Umbrella\Ya\RetornoBoleto\ProcessFactory;
use Umbrella\Ya\RetornoBoleto\ProcessHandler;
use Umbrella\Ya\RetornoBoleto\RetornoEvents;

// Passamos o objeto contruido para o handler
$processor = new ProcessHandler($cnab);

$processor->getDispatcher()->addListener(RetornoEvents::ON_DETAIL_REGISTER,
                                         function(OnDetailRegisterEvent $event) use($self, &$count) {
    echo $event->getLineNumber() . PHP_EOL;
});

Atualmente temos os seguintes eventos:

Evento Event Class Descrição ON_DETAIL_REGISTER OnDetailRegisterEvent Lançado sempre que um registro é iterado

Demo

A aplicação de demonstração está no repositório Ya Boleto Demo

Documentação

Mais informações podem ser encontradas na documentação on-line em http://ya-retorno-boleto.readthedocs.org/pt_BR/latest/.