Páginas filhas
  • DT Buscar Dados do Cliente - Inteligência Geográfica.


BUSCAR DADOS DO CLIENTE - INTELIGÊNCIA GEOGRÁFICA 

Informações Gerais

 

Linha de Produto:

PC Sistemas

Segmento Executor:D&L

Módulo:

3 - Venda

Rotina:


Rotina

Nome Técnico

302

Cadastrar Cliente

Rotina(s) envolvida(s)

Nome Técnico

560

Atualizar Banco de Dados

132

Parâmetros da Presidência

Chamado/Ticket:

HIS.04421.2017

Requisito/Story/Issue:

INTERE-7

Tabelas:

560

- Tabela de parâmetros por filial - 132 (PCPARAMFILIAL)

- Tabela de Clientes (PCCLIENT)

- Dicionário de Dados - Criar Novo Dicionário de Dados


132

4062 - Chave de autenticação do cliente PC na integração com Inteligência Geográfica

4063 - Buscar Dados de Cliente da Inteligência Geográfica

4064 - Empresa WinThor para Integração IG

2849 - Número da Porta

2850 - Contexto do Servidor

2851 - IP do Servidor

País:

( X ) Brasil  (  ) Argentina  (  ) México  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colômbia   (  ) Outro _____________.

Versão/Release:

Rotina 560 - V. 28.06

Rotina 302 - V. 28.06

Objetivo

 Criar parâmetros da presidência na funcionalidade de novo cadastro de cliente, irá receber dados básicos do cliente através do serviço da Inteligencia geográfica - IG.


Rotina

Tipo de Operação

Opção de Menu

302 - Cadastrar Cliente

Alteração

Menu do WinThor -> 302

132 - Parâmetros da Presidência

Envolvida

Menu do WinThor -> 132

 

Rotina 132 - Parâmetros da Presidência:

1. Criar parâmetro geral: Buscar dados de cliente da Inteligencia Geográfica. (S/N) (Default deverá ser N);

2. Criar parâmetro geral: Empresa Winthor para integração IG (exibir como opção de escolha, código e razão social das filiais existentes);

3. Criar parâmetro geral: Caminho Serviço Inteligencia Geográfica;

4. Caso  parâmetro Buscar dados de cliente da Inteligencia Geográfica, estiver igual a Sim, os parâmetros: Empresa Winthor para integração IG e Caminho Serviço Inteligencia Geográfica, deverão ter seu preenchimento obrigatório.


Rotina 302 - Cadastrar Cliente:

1. Caso parâmetro  do item 1 (rotina 132) estiver igual a Sim e estiver preenchido o caminho, a rotina 302 deverá chamar o serviço de integração da inteligência geográfica, ao entrar na rotina. (Neste momento o serviço irá enviar o CNPJ, razão Social da empresa, dados do responsável (nome, e-mail e telefone), da empresa parametrizado na rotina 132 como empresa Winthor para integração com o IG , para verificar necessidade de cadastro de conta na IG);

1.1 Se estiver preenchido Sim no parâmetro Buscar dados de cliente da Inteligencia Geográfica, e não tiver informado o caminho do serviço do IG, e também a Empresa Winthor para integração IG, deverá exibir a seguinte mensagem: Na rotina 132, parâmetro da presidência, você informou que deseja usar o serviço de integração da Inteligência Geográfica, porém não informou a Empresa Winthor para integração com IG, e/ou Caminho Serviço Inteligência Geográfica;

1.1.1 Após a mensagem, o cliente poderá dar continuidade no cadastro, mesmo sem preencher, é apenas para Aviso/Informativo;

1.1.2 Caso o serviço esteja fora do ar, (parametrizado na rotina 132 descrito no critério 3), deverá exibir mensagem para o usuário apenas para alerta: Não será possível apresentar os dados básicos da consulta IG, pois o serviço está fora do ar, procure o responsável pelo TI.

2. Se Sim, ao digitar o CNPJ deverá chamar o serviço da integração. (Neste momento o serviço irá retornar, Razão Social, Nome Fantasia, se existir, Logradouro, número, bairro, cod. cidade IBGE, nome da cidade, Estado, CEP, telefones, CNAE Primário, código e descrição), deverá mostrar em tela separada todos os dados encontrados, quando usuário escolher qual deseja, a rotina deverá gravar nos campos específicos de cada informação;

- Logradouro= ENDERENT 
- Numero = NUMEROENT 
- BAIRRO = BAIRROENT 
- COD CIDADE IBGE = CODMUNICIPIO (através deste deverá verificar se existe cadastro da cidade na rotina 577, para preenchimento dos proximos campos CODCIDADE, MUNICENT e ESTENT, se não existir deverá fazer inserção no cadastro.) 
- CIDADE = CODCIDADE (codigo interno de cadastro de cidade) 
- Descrição da cidade = MUNICENT 
- Estado = ESTENT 
- CEP = CEPENT

3.  A rotina 302 deverá verificar o código de CNAE que retornou, se não existir no cadastro da rotina 508 deverá ser feito a inserção do cadastro;

4. Através do código da cidade do IBGE retornado, deverá verificar se já existe cadastro na rotina 577, se já existir deverá prevalecer o nome descrito no cadastro. Neste caso não irá atualizar o cadastro da cidade. Apenas se não houver o cadastro que será cadastrado com o nome retornado. Da mesma forma será para o código de CNAE retornado.

1. Acesse a rotina 560 na versão 28.06 ou versão superior e atualize as tabelas:


  • Tabela de Clientes (PCCLIENT);




  • Tabela de parâmetros por filial - 132 (PCPARAMFILIAL);





  • Dicionário de Dados - Criar Novo Dicionário de Dados:





2. Acesse a rotina 132 - Parâmetros da Presidência e marque conforme necessidade os parâmetros:


  • 4062 - Chave de autenticação do cliente PC na integração com Inteligência Geográfica:

    Observação: este parâmetro se trata da KEYINTEGRACAOCLIENTEIG, é a autenticação do Cliente PC na plataforma IG, que ao ser acionado via URL do WinThor AnyWhere interage com o IG para autenticar e salvar a Key de autenticação de uso.

    Este parâmetro permanecerá desabilitado para edição, o mesmo é automaticamente preenchido pelo serviço de Integração com a Inteligência Geográfica - IG.




  • 4063 - Buscar Dados de Cliente da Inteligência Geográfica:

  • 4064 - Empresa WinThor para Integração IG:



Parâmetros para Configuração do WinThor AnyWhere:


  • 2849 - Número da Porta:



  • 2850 - Contexto do Servidor:



  • 2851 - IP do Servidor.



4. Atualize a rotina 302 para versão 28.06 ou versão superior.


Observações:

  • Para este passo-a-passo estamos realizando um Novo cadastro, porém, as validações abaixo  contemplam a edição de um cadastro já existente na rotina 302;
  • O processo de Inteligência Geográfica valida apenas as informações de Pessoa Jurídica (CNPJ);
  • Para validação do processo abaixo é Obrigatório que o WinThor Anywhere esteja instalado;

    - Ou seja, o serviço de integração que utiliza a plataforma WinThor Anywhere (WTA) como meio de comunicação que será configurado através do campo URL;
    - A construção desta URL deve ser realizada conforme o exemplo abaixo:

    http://” + IPMOBILE + “:” + PORTAMOBILE + “/” + CONTEXTOMOBILE + “integracao/ig/v1/pessoa/dados/enriquecer

    Definições:
    IPMOBILE - IP da Máquina
    PORTAMOBILE - Porta de Instalação do WTA
    CONTEXTOMOBILE - Contexto de Instalação do WTA

    - As informações acima devem ser verificadas com seu Administrador de Rede.

  • O parâmetro 4062 trata-se da KEYINTEGRACAOCLIENTEIG, é a autenticação do Cliente PC na plataforma IG, que ao ser acionado via URL do WinThor AnyWhere interage com o IG para autenticar e salvar a Key de autenticação de uso.
    Este parâmetro permanecerá desabilitado para edição, o mesmo é automaticamente preenchido pelo serviço de Integração com a Inteligência Geográfica - IG.



1. Acesse a rotina 302 na versão indicada acima ou versão superior;

2. Clique o botão Novo Registro;

3. Selecione/informe o campo CNPJ/CPF***;

3.1 Clique novamente sobre o campo de pesquisa ;



4. Clique Sim na mensagem: Deseja consultar dados do cliente via Inteligência de Geolocalização?



Observações:


  • Caso Não seja informado/preenchido o parâmetro 4064 - Empresa WinThor para Integração IG, é exibida mensagem de Atenção conforme imagem abaixo:




  • Também, caso não exista informações para o CNPJ informado é exibida mensagem de Atenção conforme imagem abaixo:



5. Na tela Consulta Dados IG, selecione o registro que deseja importar e clique o botão Confirmar;



6. Os seguintes campos terão suas informações preenchidas automaticamente: CNAE, Telefone Comercial, Endereço Comercial, Bairro, Cidade IBGE, Código da Cidade IBGE, Município, Estado e CEP, os demais não serão preenchidos de forma automática nesta integração ;




Observações:

  • Endereços, Telefones de Cobrança e de Entrega também poderão ter a opção chamar o serviço de pesquisa do IG, sendo necessário apenas selecionar a opção desejada. Porém, para o acesso a estes dados é necessária configuração dos mesmos no Dicionário de Dados da rotina 302. Conforme imagem abaixo:



7. Realizados os demais registros necessários, clique o botão Salvar.