wrparra / Correios.NET

API .NET para consumo de serviços dos correios.

Correios.NET

Biblioteca .NET para integração com os serviços dos Correios. Serviços disponíveis até o momento.

• Consulta de CEPs
• Consulta de Encomendas

Como usar

Para instalar o Correios .NET por linha de comando:

Usando Nuget no Package Manager Console

PM> Install-Package Correios.NET

Usando CLI do .NET Core

> dotnet add package Correios.NET

Rastreamento de encomendas/pacotes

Exemplo utilizando Console App com método sync

class Program
{
    static void Main(string[] args)
    {
        var result = new Correios.NET.CorreiosService().GetPackageTracking("SW000000000BR");

        foreach (var track in result.TrackingHistory)
            Console.WriteLine("{0:dd/MM/yyyy HH:mm} - ({1} -> {2}) - {3}", track.Date, track.Source, track.Destination, track.Status);

        Console.ReadLine();
    }
}

Exemplo utilizando ASP.NET MVC com método async

public class HomeController : AsyncController
{
    public async Task<ActionResult> Index()
    {
        var package = await new Correios.NET.CorreiosService().GetPackageTrackingAsync("SW000000000BR");            
        ViewBag.TrackingCode = package.Code;
        return View();
    }
}

Consulta de Endereços por CEP

A consulta é feita informando um CEP com 8 dígitos, e neste caso somente um endereço é retornado. Ao informar um CEP com menos de 8 dígitos a busca é feita retornando todos os CEPs de acordo com o intervalo informado.

Exemplo utilizando Console App com método sync

class Program
{
    static void Main(string[] args)
    {
        var addresses = new Correios.NET.CorreiosService().GetAddresses("15000000");

        foreach(var address in addresses)
            Console.WriteLine("{0} - {1} - {2} - {3}/{4}", address.ZipCode, address.Street, address.District, address.City, address.State);

        Console.ReadLine();
    }
}

Exemplo utilizando ASP.NET MVC com método async

public class HomeController : AsyncController
{
    public async Task<ActionResult> Index()
    {
        var addresses = await new Correios.NET.CorreiosService().GetAddressesAsync("15000000");
        return View();
    }
}

Roadmap

Próximas implementações

1. Cálculo de Frete
2. Busca CEP por Logradouro
3. e outros...

---

Copyright © 2013-2022 Wellington R. Parra, released under the MIT license