TOTVS Moda

Páginas filhas
  • DT Novo parâmetro para consulta de CEP


01. DADOS GERAIS

Linha de Produto:Virtual Age
Segmento:Moda
Módulo:Pessoa
Função:Novo parâmetro para consulta de CEP
Requisito/Story/Issue (informe o requisito relacionado) :DVACOM-1476


02. SITUAÇÃO/REQUISITO

         Para os componentes de manutenção de pessoa, foi criada uma API para pesquisa de CEP diretamente nas bases do Correio que realiza a importação dos dados de CEP quando ainda não está cadastrado na base local. 

         A utilização da nova API será implementada gradativamente nos clientes.

03. SOLUÇÃO 

Para que a nova API de pesquisa de CEP seja implantada gradativamente nos clientes, foi criado o parâmetro DS_URL_API_CONSULTA_CEP.

Neste parâmetro será indicada a URL de consulta de CEP  que será usada pela API.

A URL usada neste momento é http://192.168.190.103:8290/api/v1/cep/consulta. Esta URL pode ser modificada futuramente e ao implantar o novo processo em um cliente é necessário verificar a URL em vigência.

A princípio, a configuração do parâmetro será feita exclusivamente por usuários especiais. Sendo assim, o cliente que desejar migrar para o novo processo deve solicitar junto à equipe de Suporte a configuração do parâmetro.

Futuramente, com a estabilização do processo, a configuração do parâmetro será liberada para ao usuário administrador do próprio cliente que deseja usar o novo processo.



1- Consulta de CEP inexistente com parâmetro configurado (pela nova API)

As imagens abaixo mostram a consulta feita pela API de um CEP ainda não cadastrado na base local:

 

Imagem 1 - ADMFM014 - parâmetro "DS_URL_API_CONSULTA_CEP" configurado com a URL para consulta pela API.


Imagem 2 - GLBFM057 - indicando que o código de CEP 18767-038 ainda não está cadastrado na base local.


Imagem 3 - PESFM010 - aqui foi digitado o código de CEP 18767-038. Com o parâmetro configurado, a pesquisa foi feita nas bases do Correio e os dados do CEP estão demonstrados no frame "Endereço".


Imagem 4 - GLBFM057 - os dados do CEP 18767-038 foram importados para a base local após a consulta pela API.


2- Consulta de CEP inexistente com parâmetro em branco (consulta somente a base local)

As imagens abaixo mostram a consulta de um CEP ainda não cadastrado na base local quando o parâmetro não está configurado:


Imagem 5 - ADMFM014 - parâmetro "DS_URL_API_CONSULTA_CEP"  não configurado.


Imagem 6 - GLBFM057 - o código de CEP 18762-094 ainda não está cadastrado na base local.


Imagem 7 - PESFM010 - ao entrar com o CEP 19876-094 a consulta é feita somente na base local, dando uma mensagem de CEP não cadastrado.


Os componentes abaixo também foram alterados para tratar o novo parâmetro de CEP e se comportam da mesma forma indicada acima no PESFM010:

-PDVFM023 - manutenção de endereço de pessoa;
-PDVFM025 - manutenção de cliente pessoa física no PDV a partir do PDVFM001;
-PDVFM059 - manutenção de cliente PDV chamado pelo menu;
-PESFM010  - manutenção de pessoa (completa);
-PESFM116  - cadastro simplificado de pessoa;
-PESFM200  - manutenção de pessoa