DT Buscar informações de endereço pelo CEP com uso de API

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Na aplicação de manutenção de Pessoas - GEPES0010, implementar recurso para buscar informações de endereço, através da nova API Conector Dados Globais, com base nos dados da empresa Correios.

03. SOLUÇÃO

Foram implementadas na aplicação de manutenção Pessoas - GEPES0010 e Endereços - GEPES0019, recurso para buscar informações de endereço, através da nova API Conector Dados Globais., com base nos dados da empresa Correios.

• As rotinas tiveram seus layouts alterados, conforme demonstra a imagem abaixo:

• Pessoas - GEPES0010:

Imagem 1 - Alteração de Layout na Pessoas - GEPES0010

• Endereços - GEPES0019:

Imagem 2 - Alteração de Layout na Endereços - GEPES0019

• A partir de agora o usuário deverá informar primeiramente o CEP, para que a aplicação faça uma busca das informações, utilizando endpoint específico da nova API Conector Dados Globais.
  Obs.: Para habilitar o campo Cidade, agora, será necessário pressionar TAB quando o cursor estiver no campo CEP.
  
  
• Quando se tratar de um CEP por logradouro, a aplicação deve carregar as informações de cidade, UF, bairro e logradouro conforme a pesquisa realizada, ficando o cursor no campo Nº. As informações pesquisadas devem serão automaticamente atualizadas nas tabelas pertinentes ao Logradouro.

Imagem 3 - Busca de informações baseado no CEP

• Caso o usuário não saiba o CEP, ele poderá sair do campo CEP, automaticamente os campos Cidade, UF e Logradouro são habilitados para que ele possa informá-los, para que assim a rotina faça a busca pela API Conector Dados Globais do CEP e Bairro correspondente a aquelas informações.

Imagem 4 - Busca de informações do CEP através da Cidade, UF e Logradouro

• Quando os dados informados de Cidade, UF e Logradouro, possuírem mais de um CEP vinculado junto aos Correios, será exibida uma dialog com todos os resultados encontrados para que o usuário possa selecionar a informação correta.

Imagem 5 -Retorno de vários CEPs para uma mesma Cidade, UF e Logradouro

• Quando se tratar de um CEP único por localidade, a aplicação deve carregar as informações de cidade e UF, ficando o cursor no campo Logradouro, para definição pelo usuário.

Imagem 6 - CEP único por localidade

• Caso o CEP, ou os dados informados estejam incorretos, ao realizar a execução da API Conector Dados Globais, será retornada a mensgem de alerta sobre não existir o Logradouro procurado.

Imagem 7 - Informação não existente

Imagem 8 - Logradouro não existente

• Importante ressaltar, que as novas implementações só terão efeito se a API Conector Dados Globais estiver devidamente instalada no ambiente do cliente, caso contrário, será emitido mensagem de alerta sobre a configuração e o processo padrão anterior existente continuará sendo executado.

Imagem 9 - URL não configurada

• Continuará sendo observado, se a faixa de CEPs cadastradas para as cidades estão corretas.

Imagem 10 - Mensagem sobre a faixa de CEPs

04. DEMAIS INFORMAÇÕES

Disponível a partir da versão 24.07.001

05. ASSUNTOS RELACIONADOS

       Clique aqui para mais informações sobre Pessoas - GEPES0010.