e-DNE Correios

O e-DNE é um banco de dados que contém todos os CEPs do Brasil.

No entanto, essa base é disponibilizada apenas para download. Então criamos uma ferramenta para importar essa base para nosso banco de dados. Você pode baixar o código no Github ou seguir os passos pra instalação.

Instalação

Baixe o projeto usando Git:

git clone git@github.com:elo7/edne-correios.git

Baixe as dependências do projeto:

bundle install

Preparando o banco de dados

Primeiramente vamos importar as informações dos Correios em um banco de dados temporário.

Atualmente a ferramenta dá suporte para MySQL, SQLite e PostgreSQL. A configuração agora foi transferida para um arquivo externo localizado em config/database.yml. Caso queira usar o modo antigo com as configurações misturadas com código ficou comentado as linhas dentro do o arquivo config/database.rb com exemplos para SQLite e PostgreSQL:

DataMapper.setup(:default,  "sqlite3:db/database.sqlite3")

ou

DataMapper.setup(:default, 'adapter://username:password@hostname/database')

Execute o comando abaixo para criar a estrutura básica das tabelas:

bundle exec rake db:migrate

Baixando os arquivos dos Correios

Depois de comprar a base no site dos Correios, você terá acesso aos arquivos na área de Meus Downloads.

Os Correios disponibilizam dois tipos de arquivos:

e-DNE Básico - Atualizado até dd/mm/yyyy	Atualização do e-DNE Básico - Até dd/mm/yyyy
Esse arquivo possui todos os dados do Brasil, atualizados até a data indicada.	Durante o ano, os Correios disponibilizam atualizações em relação àquela base, mas eles fazem isso nesse outro formato.

Baixe apenas o arquivo base e o último de atualização.

Preparando os arquivos

Coloque os arquivos dentro das pastas designadas no projeto edne-correios.

mv eDNE_Basico_ddmm/Delimitado/LOG* edne-correios/data/log/
mv eDNE_Delta_Basico_ddmm/Delimitado/DELTA* edne-correios/data/delta/

Importação

Importe a base e o delta:

bundle exec rake import:base
bundle exec rake import:delta

Pronto! Agora você tem todas as informações no banco de dados.

Recomendamos exportar uma versão consolidada dos CEPs para consultas mais rápidas. Utilizamos o seguinte modelo:

CREATE TABLE `ceps` (
  `cep` varchar(8) NOT NULL,
  `endereco` varchar(255) NOT NULL,
  `bairro` varchar(255) NOT NULL,
  `cidade` varchar(255) NOT NULL,
  `estado` varchar(2) NOT NULL,
  `nome_estado` varchar(255) NOT NULL,
  PRIMARY KEY (`cep`)
);

O comando abaixo irá exportar todos os CEPs para esse formato.

bundle exec rake import:join