DT Buscar informações de endereço na rotina Clientes - DEA0001 pelo CEP com uso de API

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Na aplicação de manutenção de Clientes - DEA0001, 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 de Clientes - DEA0001, 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:

Imagem 1 - Alteração de Layout na Clientes - DEA0001

• 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.
• 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 2 - 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 3 - 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 4 -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 5 - 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 6 - Informação 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 7 - URL não configurada

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

Imagem 8 - Mensagem sobre a faixa de CEPs

04. DEMAIS INFORMAÇÕES

Se você estiver na versão 24.01, atualize o sistema para o service pack 24.07.001 ou superior.

05. ASSUNTOS RELACIONADOS

        Clique aqui para mais informações sobre Clientes - DEA0001.