Status

Projeto boleto .NET Core

Esta é uma versão do Boleto2Net, adaptada para funcionar com .NET Core. Para evitar a quebra de compatibilidade com aplicações que utilizam versões do .NET inferiores à 4.6.1, optamos por criar um novo projeto.

O que é o projeto boleto .net core? R: Live sobre o entendimento do projeto

Carteiras Homologadas

| Banco | Código do banco | Carteira | | :-------- | :------- | :-----------| | Banrisul | 041 | 1 | | Bradesco | 237 | 09 | | Bradesco | 237 | 09 | | Brasil | 001 | 17 (Variações 019 027 035)| | Caixa Econômica Federal | 104 |SIG14| | Cecred/Ailos|085|1| |Itau|341|109, 112| |Inter|077|110| |Safra|422|1| |Santander|033|101| |Sicoob|756|1-01| |Sicredi|748|1-A| |Uniprime Norte PR|084|09|

Carteiras Implementadas (Não foi homologada. Falta teste unitário)

| Banco | Código do banco | Carteira | | :-------- | :------- | :-----------| |Banco do Brasil| 001 |11 (Variação 019)| |Banco CrediSIS|097|18| |Nordeste|004|1| |Nordeste|077|112|

Atenção: Para manter a ordem do projeto, qualquer solicitação de Pull Request de um novo banco ou carteira implementada, deverá seguir o formato dos bancos/carteiras já implementados e vir acompanhado de teste unitário da geração do boleto (PDF), arquivo remessa e geração de 9 boletos, com dígitos da linha digitável variando de 1 a 9, checando além do próprio dígito verificador, o cálculo do nosso número, linha digitável e código de barras.

Pre requisitos

• Visual Studio 2017 ou superior
• .NET Framework 4.6.1 ou superior

Como Contribuir

Leia o arquivo contributing.md

Este projeto está dividido em 3 partes:

BoletoNetCore (Projeto Principal)

Responsável por guardar toda a lógica de leitura de remessa e retorno de arquivos e regras e impressão do boleto em hipertexto. Por ser um projeto multitarget, todo o código será avaliado se puder rodar corretamente tanto em netstandard2 quanto em net40.

BoletoNetCore.Pdf

Responsável pelos serviços de impessão em PDF.

Obs.: Para geração de PDF em linux (ambientes baseados em Debian), é necessário a instalação das seguintes dependências:

apt-get install -y libfontconfig1 libxrender1 libxext6

Também é necessário garantir a permissão de execução para o binário responsável por gerar o PDF:

chmod +x "<Caminho do projeto>/BoletoNetCore.Testes/bin/Debug/net7.0/Rotativa/Linux/wkhtmltopdf"

BoletoNetCore.Testes

Validação e testes de toda a lógica dos boletos.

• Em linhas gerais, novas carteiras deverão passar por validações e apresentar comprovação de passe nos testes propostos, contendo validações conforme proposto acima.
• Procure comentar todo o código para facilitar o entendimento e motivação para outros colegas. Embora o código original não seja muito comentado, não é motivo para que se crie o hábito.
• Se houver a necessidade de incluir novas imagens ou recursos para impressão, abra uma issue primeiro, ou apenas use as pastas convencionadas no projeto para receber esses tipos de arquivo. /Images e /BoletoBancario
• Nomenclaturas e termos devem estar alinhados aos padrões definidos no CNAB: https://cmsportal.febraban.org.br/Arquivos/documentos/PDF/Layout%20padrao%20CNAB240%20%20V%2010%2005%20-%2005_11_18.pdf
• A Estrutura das classes dos Banco estão distribuídas em arquivos que representam partial classes
• Cada uma das partial classes implementa uma interface diferente que representa um formato, existem 3 formatos implementados: CNAB400, CNAB240 e OnlineRest (Procuramos Implementadores)

Migrando do Boleto2Net

Este projeto possui algumas diferenças relevantes em relação ao Boleto2Net que podem quebrar o seu código:

• Retorno de Arquivos CNAB geram CodMovimentoRetorno no Lugar de CodOcorrencia.
• Se você quer usar a impressão em PDF, use o BoletoNetCorePdfProxy e não BoletoNetCoreProxy.
• Para a impressão em PDF, também é necessário a instalação do pacote BoletoNetCore.Pdf.
• Este projeto não usa System.Web então, não existem componentes manipuláveis para WebForms para o Editor do VS.
• Cedente e Sacado foram substituidos em todo o projeto pelos termos atuais Beneficiario e Pagador