/CnabPHP

Projeto para criar arquivos de remessas e processar arquivos de retorno no formato CNAB, utilizado nos bancos geralmente para boleto bancário.

Primary LanguagePHPMIT LicenseMIT

CnabPHP

Join the chat at https://gitter.im/andersondanilo/CnabPHP

Build Status Latest Stable Version Latest Unstable Version Code Climate Test Coverage

Projeto para criar arquivos de remessas e processar arquivos de retorno no formato CNAB, utilizado nos bancos geralmente para boleto bancário.

Funcionalidades

  • Leitura e geração de arquivos de retorno e remessa nos formatos CNAB 240 e 400
Banco Versão da Remessa Versão do Retorno
Banco do Brasil 240 (Beta) 240 e 400
Bradesco 240
Caixa 240 240 e 400
Itaú 400 400
Santander 240

Instalação

Composer

Se você já conhece o Composer, adicione a dependência abaixo à diretiva "require" no seu composer.json:

"andersondanilo/cnab_php": "1.3.*"

Como Usar

Lendo um arquivo de Retorno

$cnabFactory = new Cnab\Factory();
$arquivo = $cnabFactory->createRetorno('AQUI VAI O CAMINHO DO ARQUIVO DE RETORNO, EX: RET1010.RET');
$detalhes = $arquivo->listDetalhes();
foreach($detalhes as $detalhe) {
    if($detalhe->getValorRecebido() > 0) {
        $nossoNumero   = $detalhe->getNossoNumero();
        $valorRecebido = $detalhe->getValorRecebido();
        $dataPagamento = $detalhe->getDataOcorrencia();
        $carteira      = $detalhe->getCarteira();
        // você já tem as informações, pode dar baixa no boleto aqui
    }
}

Criando um arquivo de remessa

Consulte na wiki: https://github.com/andersondanilo/CnabPHP/wiki/Criando-um-arquivo-de-remessa

Como Contribuir

Você pode contribuir com testes (unitários ou manuais), ou adaptando o formato para outro banco através do projeto cnab_yaml (https://github.com/andersondanilo/cnab_yaml) (que é utilizado pelo cnab_php). Leia a wiki

O projeto está usando o Waffle para gerenciar o status da impleentação de novas remessas e retornos:

Stories in Ready

Licença

Este projeto esta sobre a licença MIT