CEP

CEP

Webservices de CEP

Endpoints

Produção: http://www.soawebservices.com.br/webservices/producao/cep/cep.asmx

Test-Drive: http://www.soawebservices.com.br/webservices/test-drive/cep/cep.asmx

Método: ConsultaCEP

Descrição: Consulta a base de CEP:

Headers:

POST /webservices/producao/cep/cep.asmx HTTP/1.1
Host: www.soawebservices.com.br
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "SOAWebServices/ConsultaCEP"

Requisição SOAP/XML:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultaCEP xmlns="SOAWebServices">
<Credenciais>
<Email>string</Email>
<Senha>string</Senha>
</Credenciais>
<CEP>string</CEP>
</ConsultaCEP>
</soap:Body>
</soap:Envelope>

Resposta SOAP/XML:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultaCEPResponse xmlns="SOAWebServices">
<ConsultaCEPResult>
<CEP>string</CEP>
<TipoLogradouro>string</TipoLogradouro>
<Logradouro>string</Logradouro>
<Bairro>string</Bairro>
<GeoLocalizacaoLogradouro>
<Latitude>decimal</Latitude>
<Longitude>decimal</Longitude>
</GeoLocalizacaoLogradouro>
<UF>string</UF>
<Estado>string</Estado>
<Cidade>string</Cidade>
<CodigoIBGE>string</CodigoIBGE>
<GeoLocalizacaoCidade>
<Latitude>decimal</Latitude>
<Longitude>decimal</Longitude>
</GeoLocalizacaoCidade>
<Mensagem>string</Mensagem>
<Status>boolean</Status>
<Transacao>
<Status>boolean</Status>
<CodigoStatus>string</CodigoStatus>
<CodigoStatusDescricao>string</CodigoStatusDescricao>
</Transacao>
</ConsultaCEPResult>
</ConsultaCEPResponse>
</soap:Body>
</soap:Envelope>

Modelo de Dados:

Item

Tipo

Nome

Descrição

1

varchar(8)

CEP

CEP

2

varchar(30)

TipoLogradouro

Tipo de Logradouro. Ex: RUA, AV

3

varchar(100)

Logradouro

Logradouro

4

varchar(100)

Bairro

Bairro

5

XML Node

GeoLocalizacaoLogradouro

GeoLocalizacao

5

Decimal

Latitude

Latitude

5

Decimal

Longitude

Longitude

6

varchar(2)

UF

Unidade Federativa

7

varchar(2)

Estado

Estado

8

varchar(2)

Cidade

Cidade

9

varchar(2)

CodigoIBGE

Codigo IBGE do Municipio

10

XML Node

GeoLocalizacaoCidade

GeoLocalizacao da Cidade

10

Decimal

Latitude

Latitude

10

Decimal

Longitude

Longitude

11

varchar(2)

Mensagem

Mensagem da transação(*)

12

boolean

Status

Status da transação(*)

13

XML Node

Transacao

Node contendo mensagem padronizada sobre a transação.

13

varchar(2)

Status

Status da Transação

13

varchar(2)

CodigoStatus

Código de Status

13

varchar(2)

CodigoStatusDescricao

Descrição do Codigo de Status

Método: ConsultaCEPEstendida

Descrição: Consulta a base de CEP com Desmembramento de informações:

Existem algumas situaçãoes onde os correios retornam o bairro ou um distrito com informações extras como por exemplo: Bairro: JARDIM DAS FLORES - PQ INDUSTRIAL.

Neste caso separamos as informacoes em campos complementares.

Headers:

POST /webservices/producao/cep/cep.asmx HTTP/1.1
Host: www.soawebservices.com.br
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "SOAWebServices/ConsultaCEPEstendida"

Requisição SOAP/XML:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultaCEPEstendida xmlns="SOAWebServices">
<Credenciais>
<Email>string</Email>
<Senha>string</Senha>
</Credenciais>
<CEP>string</CEP>
</ConsultaCEPEstendida>
</soap:Body>
</soap:Envelope>

Resposta SOAP/XML:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultaCEPEstendidaResponse xmlns="SOAWebServices">
<ConsultaCEPEstendidaResult>
<CEP>string</CEP>
<TipoLogradouro>string</TipoLogradouro>
<Logradouro>string</Logradouro>
<LogradouroComplemento>string</LogradouroComplemento>
<Bairro>string</Bairro>
<BairroComplemento>string</BairroComplemento>
<GeoLocalizacaoLogradouro>
<Latitude>decimal</Latitude>
<Longitude>decimal</Longitude>
</GeoLocalizacaoLogradouro>
<UF>string</UF>
<Estado>string</Estado>
<Cidade>string</Cidade>
<CodigoIBGE>string</CodigoIBGE>
<GeoLocalizacaoCidade>
<Latitude>decimal</Latitude>
<Longitude>decimal</Longitude>
</GeoLocalizacaoCidade>
<Mensagem>string</Mensagem>
<Status>boolean</Status>
<Transacao>
<Status>boolean</Status>
<CodigoStatus>string</CodigoStatus>
<CodigoStatusDescricao>string</CodigoStatusDescricao>
</Transacao>
</ConsultaCEPEstendidaResult>
</ConsultaCEPEstendidaResponse>
</soap:Body>
</soap:Envelope>

Modelo de Dados:

Item

Tipo

Nome

Descrição

1

varchar(8)

CEP

CEP

2

varchar(30)

TipoLogradouro

Tipo de Logradouro. Ex: RUA, AV

3

varchar(100)

Logradouro

Logradouro

4

varchar(100)

LogradouroComplemento

Logradouro Complemento

5

varchar(100)

Bairro

Bairro

6

varchar(100)

BairroComplemento

Bairro Complemento

7

XML Node

GeoLocalizacaoLogradouro

GeoLocalizacao

7

Decimal

Latitude

Latitude

7

Decimal

Longitude

Longitude

8

varchar(2)

UF

Unidade Federativa

9

varchar(2)

Estado

Estado

10

varchar(2)

Cidade

Cidade

11

varchar(2)

CodigoIBGE

Codigo IBGE do Municipio

12

XML Node

GeoLocalizacaoCidade

GeoLocalizacao da Cidade

12

Decimal

Latitude

Latitude

12

Decimal

Longitude

Longitude

13

varchar(2)

Mensagem

Mensagem da transação(*)

14

boolean

Status

Status da transação(*)

15

XML Node

Transacao

Node contendo mensagem padronizada sobre a transação.

15

varchar(2)

Status

Status da Transação

15

varchar(2)

CodigoStatus

Código de Status

15

varchar(2)

CodigoStatusDescricao

Descrição do Codigo de Status

Atenção(*):

Todas as transações estão vindo agora com o Node XML <Transacao>, este node tem como finalidade padronizar as respostas de status e descrições. Quando estiver integrando suas aplicações nao utilizar as tags <Status> e <Descricao> porque elas serão descontinuadas em breve.

As mensagens de status novas estão documentadas no link abaixo: http://www.soawebservices.com.br/integracao/manuais/mensagens.aspx