Gerando boletos com a biblioteca Boletos.net

A cada dia novas tecnologias, funcionalidades e possibilidades surgem para melhorar ou permitir a inserção de novos e interessantes recursos aos softwares. Contudo algumas “velhas” necessidades não deixam de existir, muito pelo contrário: elas se tornam cada vez mais importantes, requerendo que os desenvolvedores de software se aprofundem nos requisitos e regras impostas pela legislação bancária e tributária do país.

Trabalharemos a seguir com o desenvolvimento de uma aplicação que fará uso dos recursos oferecidos pela biblioteca Boleto.Net, permitindo assim criar de forma fácil e ágil boletos bancários que atendem às regras impostas pelo governo, bem como as recomendações e especificações de diversos bancos.

Considere a seguinte situação: é solicitado à equipe de desenvolvimento de uma grande corporação que sejam criados módulos de geração de boletos bancários para seu e-commerce. É informado também que existe a expectativa de que diariamente entre 5 e 7 mil pessoas realizem compras pelo site utilizando o boleto bancário como forma de pagamento, onde o valor médio de cada boleto é de aproximadamente R$ 35,00. Essas informações podem parecer um pouco insignificantes à primeira vista, mas continuaremos com o cenário hipotético. Entre o momento em que o sistema é liberado para uso e o momento em que uma pequena falha que impede que os clientes consigam fazer o devido pagamento é descoberta, passaram 5 dias. Dessa forma o prejuízo calculado para a empresa foi de aproximadamente R$ 1.050.000,00. Com esse exemplo, creio que a importância do assunto esteja um pouco mais clara. Certamente, um problema semelhante seria enfrentado se o tempo de desenvolvimento desse módulo se estendesse por mais do que o planejado.

Felizmente, para os amantes do Desenvolvimento Baseado em Componentes (DBC), existem algumas ótimas opções para resolver o problema em questão. Neste artigo trabalharemos com a biblioteca Boleto.Net, que, apesar de não disponibilizar seu código no modelo Open Source, é gratuita, pode ser utilizada com as tecnologias C# e ASP.NET, permite a emissão e impressão de boletos bancários e está adaptada para geração de arquivos nos padrões CNAB 240 e 400, bem como para leitura dos arquivos.

Os primeiros passos

Antes que se possa iniciar qualquer atividade de desenvolvimento do pequeno modelo de aplicação que fará uso da biblioteca Boleto.Net, é preciso preparar o ambiente e adquirir a referida biblioteca. Assim sendo, siga as instruções a seguir para a correta configuração do ambiente a fim de permitir o acompanhamento deste artigo sem qualquer contratempo.

1. Inicie um novo projeto selecionando a opção Visual C# > Web > Visual Studio 2012 > ASP.NET MVC 4 Web Application como pode ser observado na Figura 1. É importante citar que o projeto desenvolvido neste artigo poderá ser adaptado para aplicações em C#, entretanto o mesmo será desenvolvido em ASP.NET MVC 4;

2. Ao escolher o tipo de aplicação que será desenvolvida, será necessário definir o nome da aplicação (campo Name) e o nome da solução (Solution name). Para o artigo em questão foram escolhidos os seguintes nomes, respectivamente: boletoDevMedia e boletoDev;
3. Na tela que será apresentada, escolha a opção Basic, assim como demonstrado na Figura 2. Caso deseje, você pode selecionar outra opção, contudo a opção sugerida é suficiente para criar uma página simples com o objetivo de demonstrar o uso da biblioteca;

4. Entre no endereço disponibilizado na seção Links e faça o download da biblioteca;
5. No Solution Explorer, no projeto boletoDevMedia, clique com o botão direito sobre o pacote References e, em seguida, selecione a opção Add Reference... conforme o mostrado na Figura 3;

6. Na tela que irá abrir, clique em Browse, encontre o arquivo Boleto.Net.dll, e clique em OK (veja a Figura 4).

Para que o leitor, além de entender, possa reproduzir a utilização da biblioteca Boleto.Net em suas aplicações, é necessário conhecimento dos conceitos básicos que permeiam a arquitetura MVC.

Entendendo a estrutura MVC

Com o projeto criado e a biblioteca Boleto.Net corretamente adicionada ao mesmo, pode-se então iniciar o desenvolvimento da aplicação que realizará a geração de boletos bancários. Como para a aplicação em questão se optou por utilizar o modelo arquitetural MVC, deve-se considerar o fato de que esse modelo mantém um arquivo de rotas ...