Usando o servi�o BuscaCEP dos Correios com C#

Boa parte dos desenvolvedores de software um dia j� precisou desenvolver um cadastro de clientes, com nome, telefone, endereço, etc. Ou quem sabe um cadastro de fornecedores, de empresas, enfim, na maioria destes cadastros � preciso armazenar o endereço da pessoa, firma, ou qualquer outra entidade.

E quando se desenvolve um cadastro de endereço, uma das necessidades mais comuns � a de poder informar apenas o CEP (C�digo de Endereçamento Postal) e o pr�prio sistema apresentar as demais informaç�es (logradouro, bairro, cidade e estado).

Para suprir essa necessidade, geralmente se recorre a um dos seguintes m�todos:

Manter um banco de dados local com as informaç�es de "todos" os CEPs do pa�s e usar esse banco para consulta (geralmente � uma tabela no pr�prio banco da aplicaç�o).
Realizar a consulta atrav�s da web, consumindo um web service que ofereça esse serviço.

As duas formas, como em tudo na vida, tem seus �pr�s e contras�, por exemplo:

Em um banco de dados local, dependendo da configuraç�o das m�quinas, rede, etc, a consulta pode ser mais r�pida, uma vez que n�o depende de internet. Por�m, esse banco de dados com todos os CEPs do Brasil n�o � distribu�do gratuitamente por um �rg�o de confiança. Al�m disso, pode surgir novos CEPs e essas informaç�es teriam de ser atualizadas na base de dados com frequ�ncia.
Acessar um web service nos poupa de manter um banco de dados local e da responsabilidade de ter de atualiz�-lo sempre que surgir um novo CEP. Mas para consumir um web service, obrigatoriamente � necess�ria uma conex�o com a internet. E al�m disso � preciso ter um web service seguro, est�vel e, dependendo do projeto, gratuito.

Neste artigo, veremos uma soluç�o bastante pr�xima da segunda forma citada, mas estaremos consumindo um web service da forma tradicional. Na pr�tica, estaremos utilizando a p�gina de consulta de CEP do site dos correios. Enviaremos os dados da consulta atrav�s de uma requisiç�o POST (passando par�metro na URL) e obteremos como resultado o c�digo da p�gina de resultados. A partir dela, buscaremos apenas os elementos na estrutura HTML que apresentam o resultado em si.

Figura 1: P�gina dos Correios com resultado de pesquisa por CEP.

Como vemos na Figura 1 o resultado da consulta por CEP � apresentado em uma tabela HTML com cinco colunas. Ao receber a resposta da requisiç�o, localizaremos essa tabela na estrutura da p�gina e extrairemos apenas os valores das colunas.

Neste artigo ser� utilizado um projeto do tipo ASP.NET Web Forms, mas o mesmo c�digo poderia ser usado para Windows Forms, por exemplo, bastando adaptar a interface.

Ent�o comecemos criando um web site ASP.NET a partir do menu FILE > NEW > Web Site...e selecionando o template ASP.NET Web Forms Site.

Na p�gina principal (default.aspx) vamos inserir apenas um TextBox, um Button e um Literal para exibir o resultado com formataç�o HTML, mas este poderia ser exibido em TextBoxes, LabelsM, ou qualquer outro controle. Ent�o podemos substituir o conte�do do ContentPlaceHolder MainContent pelo conte�do da Listagem 1.

Listagem 1: Elementos da interface da p�gina principal utilizados para consulta.

<h1>Consultar CEP</h1>
<asp:TextBox ID="txtCEP" runat="server" MaxLength="8"/>
<asp:Button ID="btnConsultar" runat="server" Text="Consultar" OnClick="btnConsultar_Click"/>
<hr/>
<asp:Literal ID="litResultado" runat="server"/>

O pr�ximo passo � implementar o m�todo btnConsultar_Click para tratar o evento OnClick do bot�o. O �segredo� da consulta est� nesta parte, apresentada na Listagem 2.

Listagem 2: Consultado o CEP atrav�s de uma requisiç�o ao site dos Correios.


HttpWebRequest requisicao = (HttpWebRequest)WebRequest.Create(
"http://www.buscacep.correios.com.br/servicos/dnec/consultaLogradouroAction.do?
Metodo=listaLogradouro&CEP=" + txtCEP.Text + "&TipoConsulta=cep");
HttpWebResponse resposta = (HttpWebResponse)requisicao.GetResponse();

int cont;
byte[] buffer = new byte[1000];
StringBuilder sb = new StringBuilder();
string temp;

Stream stream = resposta.GetResponseStream();

do
{
    cont = stream.Read(buffer, 0, buffer.Length);
    temp = Encoding.Default.GetString(buffer, 0, cont).Trim();
    sb.Append(temp);

} while (cont > 0);

string pagina = sb.ToString();

if (pagina.IndexOf("<font color=\"black\">CEP NAO ENCONTRADO</font>") >= 0)
{
    litResultado.Text = "<b style=\"color:red\">CEP n�o localizado.</b>";
}
else
{
    string logradouro = Regex.Match(pagina,
"<td width=\"268\" style=\"padding: 2px\">(.*)</td>").Groups[1].Value;
    string bairro = Regex.Matches(pagina,
"<td width=\"140\" style=\"padding: 2px\">(.*)</td>")[0].Groups[1].Value;
    string cidade = Regex.Matches(pagina,
"<td width=\"140\" style=\"padding: 2px\">(.*)</td>")[1].Groups[1].Value;
    string estado = Regex.Match(pagina,
"<td width=\"25\" style=\"padding: 2px\">(.*)</td>").Groups[1].Value;
    string resultado = String.Format(
"Logradouro:  <br/> Bairro:  <br/> Cidade:  <br/> Estado: ",
logradouro, bairro, cidade, estado);
    litResultado.Text = resultado;
}

Primeiramente efetuamos a requisiç�o, recebemos uma resposta em formato stream e o transformamos em string. O conte�do da vari�vel p�gina � nada mais nada menos que o c�digo HTML da pagina apresentada na Figura 1. Utilizando essa vari�vel, n�s localizamos apenas trechos espec�ficos que indicam o resultado da consulta. Caso o CEP seja localizado, buscamos por uma tabela, como se v� na Figura 1, caso contr�rio, � apresentada a mensagem �CEP N�O ENCONTRADO� entre tags <font>. Se encontramos essa mensagem na p�gina, isso indica que o CEP procurado n�o foi localizado, ent�o informamos ao usu�rio apresentando uma mensagem equivalente no Literal.

Se o CEP for localizado, utilizamos a classe Regex para encontrar apenas as informaç�es que nos interessam, ou seja, o logradouro, o bairro, a cidade e o estado. O CEP tamb�m � exibido na tabela, mas como j� temos essa informaç�o, n�o precisamos obt�-la novamente a partir do resultado da consulta.

Na Figura 2 podemos ver a aplicaç�o em execuç�o, consultando um CEP existente.

Figura 2: Consultando CEP existente.

Para testar, podemos tamb�m digitar um CEP inv�lido e pressionar o bot�o Consultar. O resultado � apresentado na Figura 3.

Figura 3: CEP n�o localizado.

Aqui todo o c�digo foi posto no evento OnClick do bot�o, mas em uma aplicaç�o real poder�amos extrair um m�todo e reaproveitar este c�digo em v�rias partes do sistema. Tamb�m caberia criar uma classe para tratar essa consulta e retornar o resultado de forma que se pudesse acessar cada campo do endereço consultado.

Com algum conhecimento de C#, � poss�vel adequar este exemplo a v�rias situaç�es.

O c�digo fonte encontra-se dispon�vel para download no topo desta p�gina, em C# e VB.net.

Consultando endere�o por CEP em C#

Veja neste artigo como obter os dados de um endereço (logradouro, bairro, cidade e estado) a partir de uma consulta pelo CEP ao site dos Correios utilizando C#.

Artigos relacionados