Skip to content

BoletoSimples/boletosimples-csharp

Repository files navigation

Boleto Simples Logo

BoletoSimples C# Client

Client de acesso escrito em C# para api rest do www.boletosimples.com.br

Build Nuget Coverage %
Build status NuGet version Coverage Status

Instalação

No visual Studio > Abrir o Package Manager Console e digitar o comando abaixo:

> Install-Package BoletoSimples-Client

Opções de Configuração

  1. Configuração por arquivo de configuração - Em seu arquivo de configuração (.config), é necessário adicionar o seu Token de Acesso e as outras informações da API de acesso do BoletoSimples, encontrado no seu painel administrativo do BoletoSimples nesse link ou em seu painel vá ao menu Integrações > Aba Tokens de Acesso.
<appSettings>
    <!--BoletoSimples informações básicas de acesso -->
    <add key="boletosimple-api-version" value="v1" />
    <!-- Poderia ser o ambiente de sandbox https://sandbox.boletosimples.com.br/api -->
    <add key="boletosimple-api-url" value="https://boletosimples.com.br/api" />
    <add key="boletosimple-useragent" value="Meu e-Commerce ([email protected])" />

    <!--BoletoSimples token de acesso (http://api.boletosimples.com.br/authentication/token/) -->
    <add key="boletosimple-api-token" value="Seu Token de acessos" />

    <!--BoletoSimples dados de acesso para Oauth2 (http://api.boletosimples.com.br/authentication/oauth2/)
        Não suportado na versão atual do client -->
    <add key="boletosimple-api-return-url" value="" />
    <add key="boletosimple-api-client-id" value="" />
    <add key="boletosimple-api-client-secret" value=""/>
 </appSettings>
  1. Configuração ByCode - Essa configuração permite que seus dados venham de uma fonte diferente do seu arquivo de configuração da sua escolha, para maior segurança dos dados por exemplo.
public void AnyMethod
{
    var myConnection = new ClientConnection("boletosimple-api-url",
                                            "boletosimple-api-version",
                                            "boletosimple-api-token",
                                            "boletosimple-useragent",
                                            "boletosimple-api-return-url",
                                            "boletosimple-api-client-id",
                                            "boletosimple-api-client-secret");

    var client = new BoletoSimplesClient(myConnection);
}

Exemplos de Utilização

public class AnyClass
{
    // Obter as carteiras de cobrança
    public async Task GetAllBankBilletAccounts()
    {
        using(var client = new BoletoSimplesClient())
        {
           // pagedResponse contém a resposta de erro e o conteudo no caso de sucesso
           var pagedResponse = await client.BankBilletAccounts.GetAsync(0, 250).ConfigureAwait(false);

           // Aqui é apenas a resposta de sucesso sem as informações adicionais da resposta anterior
           var pagedContent = await pagedResponse.GetSuccessResponseAsync().ConfigureAwait(false);
        }
    }

    // Obter as informação do usuário
    public async Task GetUserInfo()
    {
        var client = new BoletoSimplesClient();
        var response = await client.Auth.GetUserInfoAsync().ConfigureAwait(false);
        var successResponse = await response.GetSuccessResponseAsync().ConfigureAwait(false);
        client.Dispose();
    }

    // Criar uma carteira de cobrança
    public async Task CreateBankBilletAccount()
    {
        using (var client = new BoletoSimplesClient())
        {
            var response = await client.BankBilletAccounts.PostAsync(new BankBilletAccount()).ConfigureAwait(false);
            var successResponse = await response.GetSuccessResponseAsync().ConfigureAwait(false);
        }
    }

     // Criar um boleto
    public async Task CreateBankBilletAccount()
    {
        using (var client = new BoletoSimplesClient())
        {
            var response = await client.BankBillets.PostAsync(new BankBillet()).ConfigureAwait(false);
            var successResponse = await response.GetSuccessResponseAsync().ConfigureAwait(false);
        }
    }
}

Apis Suportadas até o momento

  • Informações do Usuário
  • Carteiras de Clientes
  • Boletos
  • Arquivo CNAB - Remessa
  • Arquivo CNAB - Retorno
  • Carnês
  • Assinaturas
  • Clientes
  • Eventos

Outras Informações

Bugs, Dúvidas, Issues, Agradecimentos, etc

Através do issue tracker do GitHub

Autor

Rodrigo Couto trabalhando na Plataforma Edux

PRs são muito bem-vindas! :)