Importação de CEPs - e-DNE

A partir do arquivo sapiens_origem.tbs, crie as tabelas customizadas na sua base de dados:

Nome	Descrição
USU_T008BAI	CEP - LOG_BAIRRO
USU_T008CPC	CEP - LOG_CPC
USU_T008GUS	CEP - LOG_GRANDE_USUARIO
USU_T008LOC	CEP - LOG_LOCALIDADE
USU_T008LOG	CEP - LOG_LOGRADOURO
USU_T008OPE	CEP - LOG_UNID_OPER
USU_T008RLO	RAI - LOG_LOCALIDADE

1. Acesse o diretório de instalação ou ambiente Cloud do sistema;
2. Localize a aplicação CBDS. Abra uma aplicação para acesso ao arquivo sapiens_origem.tbs e outra para acesso ao sapiens.tbs (que será o TBS destino), que está conectado à sua base de dados;
3. No CBDS que está com o arquivo sapiens_origem.tbs aberto, em Tabelas, localize (uma por vez) a tabela que deverá ser criada no TBS destino;
4. Selecione a tabela, acesse Editar > Copiar;
5. Acesse o outro CBDS aberto (com o arquivo sapiens.tbs) e em Tabelas, vá em Editar > Colar;
6. Faça este processo (copiar e colar) para todas as tabelas customizadas indicadas;
7. Por fim, após adicionar todas as tabelas customizadas (do sapiens_origem.tbs) para a sua base de dados (arquivo sapiens.tbs), faça a personalização da base de dados para que essas tabelas constem efetivamente na base de dados.

Importe os web services customizados, com.senior.fsw.cad.cep e com.senior.fsw.cad.rais, responsáveis por cadastrar os CEPs e cidades, conforme os arquivos disponibilizados, nas tabelas nativas (Tabelas - Cep (E008CEP) e Tabelas - Cidades para RAIS - SIG (E008RAI)). Esses web services verificam a operação a ser efetuada (inserção ou atualização) e fazem a chamada nas regras de processamento, além de contar com o cadastro centralizado para todas as regras.

Esses web services customizados são executados em modo síncrono (através do Middleware Senior). Portanto, em sua regra, o seu modo de execução está definido com o valor "2 - Modo Síncrono".

Para realizar esse procedimento, acesse Recursos > Implementações > Web services > Editar e faça a importação dos arquivos com.senior.fsw.cad.cep.ssf e com.senior.fsw.cad.rais.ssf.

Adicione os modelos de importação, responsáveis por buscar os arquivos e alimentar as tabelas customizadas, no seu diretório de instalação: \<Diretório de instalação>\Sapiens\ImpExp:

• SAIM01008
• SAIM01009
• SAIM01010
• SAIM01011
• SAIM01012
• SAIM01013
• SAIM01014

Adicione as regras, responsáveis por processar as tabelas customizadas, registros pendentes e gravar o log de processamento, no seu diretório de instalação: \<Diretório de instalação>\Sapiens\Regras:

• SARG180.LSP
• SARG181.LSP
• SARG182.LSP
• SARG183.LSP
• SARG184.LSP
• SARG185.LSP

Todas as regras estão preparadas para o modo de execução "2 - Execução".

Cadastre os processos automáticos para cada modelo de importação:

1. Acesse Recursos > Processos Automáticos > Cadastro (F000AGE);
2. Na guia Importação, indique um novo código do processo automático e sua descrição. Utilize o nome do modelo de importação para relacionar com o processo automático. Por exemplo, processo automático "53 - LOG_BAIRRO", que é referente ao modelo SAIM01011 - Importação de CEP - Arquivo origem LOG_BAIRRO;
3. Em Tipo do Processo, selecione "2 - Importação";
4. Mantenha as sugestões padrões do sistema nos campos:
   • Horário Validade: 00:00 - 23:59
   • Somente Dias Úteis: "N - Não"
5. Indique o código da empresa e filial em que o processo será executado. E o usuário e senha do usuário responsável pela execução do processo automático;
6. Selecione o arquivo do modelo de importação correspondente ao processo criado:
   • SAIM01008 - Importação de Cidades - Arquivo LOG_LOCALIDADE
   • SAIM01009 - Importação de CEP - Arquivo origem LOG_LOCALIDADE
   • SAIM01010 - Importação de CEP - Arquivo origem LOG_LOGRADOURO
   • SAIM01011 - Importação de CEP - Arquivo origem LOG_BAIRRO
   • SAIM01012 - Importação de CEP - Arquivo origem LOG_GRANDE_USUARIO
   • SAIM01013 - Importação de CEP - LOG_CPC
   • SAIM01014 - Importação de CEP - LOG_UNID_OPER
7. Em Arquivo de Entrada, busque pelo arquivo de importação dos Correios, de acordo com o processo criado: \<Diretório de instalação>\Sapiens\ProcessaCep\<Pasta>\<Nome do arquivo dos Correios>.txt. Por exemplo, C:\Sapiens\Sapiens\ProcessaCep\LOG_BAIRRO\LOG_BAIRRO.txt;
8. Em Ação Sobre Arquivo determine a ação que será tomada sobre o arquivo de entrada, caso não exista ocorrências no processo. Neste caso, "4 - Mover", para mover o arquivo .txt para a pasta informada em Caminho mover arquivo, com o nome original do arquivo;
9. Informe o diretório para qual será movido o arquivo de entrada no campo Caminho mover arquivo. Sugestão, possuir a pasta Processados em \<Diretório de instalação>\Sapiens\ProcessaCep\;
10. Em Ação sobre arquivo ao ocorrer erros determine a ação que será tomada sobre o arquivo de entrada, caso apresente algum erro. Neste caso, "3 - Manter", para que o arquivo permaneça no local com o mesmo nome;
11. Clique em Inserir e acesse a guia Regra para criar um processo automático para cada regra importada;
12. Utilize o nome da regra para relacionar com o processo automático. Por exemplo, processo automático "54 - Localidade", que é referente a regra SARG180.LSP - Importação CEP CORREIOS - Localidade;
13. Em Tipo do Processo, selecione "9 - Regra";
14. Determine a periodicidade de execução da regra conforme a sua necessidade;
15. Indique o código da empresa e filial em que o processo será executado. E o usuário e senha do usuário responsável pela execução do processo automático;
16. Indique o código da regra:
    • SARG180.LSP - Importação CEP CORREIOS - Localidade
    • SARG181.LSP - Importação CEP Correios - Logradouro
    • SARG182.LSP - Importação CEP CORREIOS - Grande Usuário
    • SARG183.LSP - Importação CEP CORREIOS - Cidade
    • SARG184.LSP - Importação CEP CORREIOS - LOG_UNID_OPER
    • SARG185.LSP - Importação CEP CORREIOS - LOG_CPC
17. Clique em Inserir para finalizar o cadastro do processo automático.

Após adquirir os arquivos dos Correios, crie a pasta ProcessaCep no diretório de instalação do sistema: \<Diretório de instalação>\Sapiens\ProcessaCep, para que sejam importados automaticamente os arquivos.

Nessa pasta, ProcessaCep, crie as pastas correspondentes para cada arquivo importado:

Pasta	Arquivo dos Correios	Composição do arquivo
LOG_BAIRRO	LOG_BAIRRO.txt	Bairro
LOG_CPC	LOG_CPC.txt	Caixa Postal Comunitária (CPC) são áreas rurais e/ou urbanas periféricas não atendidas pela distribuição domiciliária.
LOG_GRANDE_USUARIO	LOG_GRANDE_USUARIO.txt	Clientes com grande volume postal (empresas, universidades, bancos, órgãos públicos, entre outros).
LOG_LOCALIDADE	LOG_LOCALIDADE.txt	Municípios, distritos e povoados do Brasil. Os CEPs neste arquivo valem para todos os logradouros da cidade, não necessitando consulta nos demais arquivos.
LOG_LOCALIDADE_CID	LOG_LOCALIDADE.txt
LOG_LOGRADOURO_XX	LOG_LOGRADOURO_XX.txt. Sendo o "XX, o estado correspondente. Por exemplo, LOG_LOGRADOURO_SC	Contém os registros das localidades codificadas por logradouro.
LOG_UNID_OPER	LOG_UNID_OPER.txt	Unidade Operacional dos Correios. São agências próprias ou terceirizadas, centros de distribuição, entre outros.

Leiaute dos arquivos

Não. Esse processo de importação de CEPs, não atualiza os CEPs que já estão em cadastros existentes, como o de cliente, fornecedor, etc. A inserção/atualização só irá ocorrer nas tabelas Tabelas - Cep (E008CEP) e Tabelas - Cidades para RAIS - SIG (E008RAI).

Não. Os CEPs excluídos não são indicados pelos Correios. Os arquivos contém apenas novas faixas e atualizações de CEPs.

O Diretório Nacional de Endereços (e-DNE) é um banco de dados, disponibilizado pelos Correios, que comporta mais de 900 mil CEPs brasileiros.

Não. A rotina não faz este tratamento. Para isso, é recomendável realizar a sua própria personalização.