DT Cidade - Checar informação do código IBGE 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 Código IBGE, através da nova API Conector Dados Globais, com base nos dados do IBGE.

03. SOLUÇÃO

Foram implementadas na aplicação de manutenção Cidades - GEPES0003 e na dialog Pesquisa Código IBGE recurso para buscar informações do Código IBGE, através da nova API Conector Dados Globais.

Observação: Para usar o recurso de busca de código IBGE, com base na API dos Correios, não é necessário nenhuma aquisição ou contrato adicional, apenas instalar a API de dependência e realizar a configuração da URL de instalação, na rotina de Parâmetros Gerais.

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

• Cidades - GEPES0003, foi acrescentado o botão Código IBGE para que o usuário acessar a dialog Pesquisa Código IBGE:

Imagem 1 - Alteração de layout com a inclusão do botão Código IBGE - Cidades - GEPES0003

• Pesquisa Código IBGE

Imagem 2 - Alteração de layout com a inclusão do botão Consulta IBGE e coluna Cód.IBGE UF

• Foi criada a coluna INDCONSIBGEAPI na tabela que armazena os dados da Pessoa, esta coluna é o Indicador que demonstra se o Código IBGE foi validado em consulta via API de Dados Globais;
• A partir de agora, quando o usuário executar a rotina Cidades - GEPES0003 e pesquisar algum cidade já existente ou inserir uma nova Cidade no ERP, a rotina irá realizar a busca do Código IBGE através utilizando endpoint específico da nova API Conector Dados Globais.

Imagem 3 - Realizando a busca de uma Cidade já inserida no ERP.

Imagem 4 - Realizando a inserção de uma nova cidade.

• Na dialog Pesquisa Código IBGE, o usuário poderá selecionar uma determinada Cidade e então clicar no botão Consultar IBGE, e então será feita a pesquisa e caso o Código do IBGE informado no ERP esteja diferente do que a API retornar, os registros serão atualizados, caso contrário será retornada mensagem de que os dados estão corretos.

Imagem 5 - Realizando pesquisa e retorno com o Código IBGE da API diferente do que está gravado no ERP.

• Se o usuário pesquisar uma Cidade na API Conector Dados Globais, e esta não existir, será exibida a mensagem de Cidade não encontrada.

Imagem 6 - Retorno de Cidade não encontrada.

Imagem 6 - Retorno de Cidade não encontrada.

04. DEMAIS INFORMAÇÕES

Se estiver na versão 24.07, atualize para o service pack 24.07.001 ou superior.

05. ASSUNTOS RELACIONADOS

       Clique aqui para mais informações sobre Cidades - GEPES0003.