edineivaldameri/payments

Pacote para gerar a Folha de Pagamento, remessas e leitura de retorno.

2.0.0 2026-03-29 16:39 UTC

Requires

• php: >=8.3
• illuminate/contracts: ^10.0||^11.0||^12.0||^13.0
• illuminate/support: ^10.0||^11.0||^12.0||^13.0
• laravel/framework: ^11.0||^12.0||^13.0

Requires (Dev)

• bnf/phpstan-psr-container: ^1.0
• deptrac/deptrac: ^4.0
• infection/infection: ^0.32
• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• mockery/mockery: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpmd/phpmd: ^2.14
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-mockery: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• rector/rector: ^2.0

MIT

• Edinei Alberton

• payments
• laravel
• LaravelPagamento

README

Biblioteca PHP para geração e manipulação de pagamentos, com suporte a layouts bancários (como CNAB240), voltada para integração com instituições financeiras.

📦 Sobre o projeto

Este projeto tem como objetivo facilitar a criação, processamento e integração de arquivos de remessa e retorno bancário, abstraindo regras específicas de cada banco e padronizando o uso dentro da aplicação.

Atualmente, inclui suporte para:

• Geração de arquivos CNAB240
• Integração com bancos (ex: Bradesco)
• Estrutura extensível para novos bancos
• Organização modular para facilitar manutenção

🚀 Instalação

Clone o repositório:

git clone https://github.com/edineivaldameri/payments.git
cd payments

Instale as dependências:

composer install

⚙️ Requisitos

• PHP 8.x
• Composer

📁 Estrutura do projeto

src/
 └── Shipping/
     └── Cnab240/
         └── Bank/
             └── Bradesco.php

• Shipping/Cnab240: Implementação do layout CNAB240
• Bank: Classes específicas por banco

🧪 Testes

Para executar os testes:

vendor/bin/phpunit

🧹 Qualidade de código

O projeto utiliza ferramentas de análise estática e qualidade:

PHPMD

vendor/bin/phpmd src ansi phpmd.xml

PHPStan

vendor/bin/phpstan analyse

📌 Exemplo de uso

use Payments\Shipping\Cnab240\Bank\Bradesco;

$bradesco = new Bradesco();

// Exemplo fictício
$arquivo = $bradesco->gerarRemessa($dados);

echo $arquivo;

⚠️ Ajuste conforme a implementação real dos métodos.

🔧 Personalização

Para adicionar suporte a novos bancos:

1. Crie uma nova classe em:

   src/Shipping/Cnab240/Bank/
   

2. Implemente as regras específicas

3. Siga o padrão das classes existentes

🤝 Contribuição

Contribuições são bem-vindas!

1. Fork o projeto

2. Crie uma branch:

   git checkout -b minha-feature

3. Commit suas alterações:

   git commit -m "Minha contribuição"

4. Push:

   git push origin minha-feature

5. Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT.

👨‍💻 Autor

Desenvolvido por Edinei Alberton

• GitHub: https://github.com/edineivaldameri

💡 Observações

Este projeto pode evoluir para suportar:

• CNAB400
• Múltiplos bancos
• Leitura de arquivos de retorno
• Validação de remessas