Tempo aproximado para leitura: 00:05:00 min

Ocorrência
Como realizar o processo de importação de cep?

Ambiente
Framework - Linha RM - Frame - A partir da versão 11.82

Solução

A importação de CEP é uma operação de inserção na base de dados do DNE (Diretório Nacional de Endereços), que é um banco de informações disponibilizado pelos Correios em arquivos. 

Os Correios disponibilizam uma versão de demonstração do DNE que contém uma faixa limitada de CEP’s. Uma vez instalada esta versão, você poderá importar os CEP’s para o sistema, a fim de avaliar o funcionamento do recurso de localização de CEP’s. Para obter um arquivo completo com todos os CEP's entre em contato com os Correios.

O processo de importação de CEP's no RM  é utilizado para facilitar a pesquisa de CEP's nos cadastros de endereços do sistema, como endereço de funcionário, por exemplo, efetuando a pesquisa de forma mais rápida.

Caso o cliente não deseje adquirir um arquivo completo dos Correios (arquivo pago), poderá importar o arquivo de demonstração e efetuar os cadastros dos endereços manualmente no sistema.

Ao efetuar a pesquisa de um CEP que não está disponível na base de CEP's, o sistema emite a mensagem abaixo:

Basta o cliente cadastrar todas as informações de endereço manualmente e salvar o registro:



Uma alternativa a importação de CEP no RM sem utilizar os arquivos dos Correios (gratuito ou pago) é a configuração de TAS (TOTVS API Services), conforme segue no artigo abaixo:

Framework - Linha RM - Frame - TAS - Como configurar o TAS para uso de CEP

Para realizar a importação de cep, siga os passos abaixo:

1 - Clique aqui para acessar a página dos correios e baixar a versão de demonstração:



2 - Acesse o menu de importação, no caminho Serviços Globais, Serviços, Utilitários, Importação de CEP:



3 - Para realizar a importação na opção Sobrepõe o Registro da base de dados com as informações do novo registro, basta localizar os arquivos no disco e selecionar:



4- Orientações importantes

  No site dos Correios, localize na aba Arquivos os itens para download para realizar testes, conforme exemplificado na imagem abaixo:



Ao realizar o download dos arquivos para atualização no site dos Correios, os mesmos apresentarão a informação DELTA no nome do documento .txt:



Para realizar o teste neste formato, deverá acessar a opção de Importação: Atualização através de arquivos DELTA:

Para realizar o teste/importação na opção Sobrepõe o registro da base de dados com informações do novo registro, deve-se remover a palavra DELTA do nome dos arquivos, conforme mostrado a seguir:

 
5 -  Ao final do processo será exibido um log informando o que ocorreu na importação e se houve algum empecilho.

Importante
Para que o processo seja executado sem apresentar erros, os arquivos deverão ser disponibilizados em um diretório compartilhado com acesso a todos.

Por se tratar de um recurso que utiliza informações fornecidas por terceiros (Correios), qualquer alteração na importação de CEP's deve ser analisada por todos os produtos, antes de qualquer alteração na estrutura de tabelas utilizada atualmente, tratando essas alterações como sugestão de melhoria. 

Saiba mais

Para mais informações sobre o processo de importação de cep, consulte o link Importação de CEP's