Integração HPE Play – interface Dados de Clientes

Interface de Exportação de dados de Clientes e o processo de recebimento dos dados de cliente gerados a partir do site HPE Play através do serviço “Linx DMS Clientes HPE Play”.

Esta atualização destina-se a todas as concessionárias das marcas Mitsubishi e Suzuki.

Integração do LINX DMS e HPEPLAY da Montadora HPE. Os processos integrantes deste projeto são: Importação de Pedidos de Venda de Veículos Novos, Exportação de Ordens de Serviço, Exportação de Notas Fiscais de venda/cancelamento de Veículos Novos, Peças e Serviços.
Nesta Implementação foram incluídas a Interface de Exportação de dados de Clientes e o processo de recebimento dos dados de cliente gerados a partir do site HPE Play através do serviço "Linx DMS Clientes HPE Play".
Processos:

1. 1. Exportação de Clientes: Transmissão dos dados de clientes existentes na base dos concessionários;
   2. Recebimento de dados de clientes: Integração dos dados de clientes que são criados no site HPE Play;

Configuração dos parâmetros para concessionárias Mitsubishi

1. 1. Abra o programa Fabrica.exe, acesse o Menu (44590): "Fábrica > Mitsubishi > Parâmetros". Entre na aba HPE > HPE Play e informe os campos a seguir:

Figura 1 - Configuração de Parâmetros Mitsubishi

• • URL do webservice de profissões: Esta URL é utilizada para realizar a comunicação com o webservice da HPE e obter os códigos de profissões para a realização do De-Para com os códigos de Profissões do Linx DMS.
  • Neste campo Informe http://hpeplaydev.sinergis-aws.com/rest/v10/SNG/Utils/listJobs.

Observação: A URL acima foi fornecida pela HPE e poderá ser modificada pela montadora.

• • Token: Para gerar o Token, clique no botão "Gerar Token".
  • Marcar cadastro de clientes como já enviado: Ao confirmar a execução do processo de atualização dos clientes (ao clicar no botão executar), todos os clientes com origem na empresa e revenda serão marcados como já enviados, fazendo com que os mesmos sejam enviados posteriormente apenas se sofrerem alguma alteração.

Configuração dos parâmetros para concessionárias Suzuki

1. 1. Abra o programa Fabrica.exe, acesse o Menu (44590): "Fábrica > Suzuki > Parâmetros. Entre na aba HPE > HPE Play e informe os campos a seguir:

Figura 2 – Configuração Parâmetros Suzuki

• • URL do webservice de profissões: Esta URL é utilizada para realizar a comunicação com o webservice da HPE e obter os códigos de profissões para a realização do De-Para com os códigos de Profissões do Linx DMS.
  • Neste Informe http://hpeplaydev.sinergis-aws.com/rest/v10/SNG/Utils/listJobs

Observação: A URL acima foi fornecida pela HPE e poderá ser modificada pela montadora.

• • Token: Para gerar o Token, clique no botão "Gerar Token".
  • Marcar cadastro de clientes como já enviado: Ao confirmar a execução do processo de atualização dos clientes, todos os clientes com origem na empresa e revenda serão marcados como já enviados (ao clicar no botão executar), fazendo com que os mesmos sejam enviados posteriormente apenas se sofrerem alguma alteração.

Configuração do cadastro de profissões no Linx DMS

1. 1. Abra o programa "Apollo.exe" e acesse o menu: "Faturamento > Manutenção Clientes > Tabela de Profissões.

Figura 3 - Cadastro de Profissões Linx DMS

1. 1. Caso não tenha preenchido nenhuma Profissão, deverá incluir as profissões para que seja realizado o De-Para.

1. 1. Ao inclui um registro, clique no campo "Código HPE" para buscar a lista de profissões utilizadas na HPE. A Lista de Profissões HPEPlay, somente será exibida se os dados referentes a esta integração estiverem preenchidos nos parâmetros do fábrica no campo HPE Play, conforme detalhado neste manual em tópico acima.

Figura 4 - Lista de Profissões HPE
Caso os parâmetros do Fábrica não estiverem preenchidos, será exibida a seguinte mensagem:

Figura 5 - Aviso

1. 1. Selecione a profissão da lista da HPE correspondente à profissão do Linx DMS e clique no botão em Salvar.

Figura 6 - Manutenção de Profissões Linx DMS

Configuração do Linx DMS Integrador

Para atender a esta atualização, realizar os seguintes passos:

1. 1. Parar o serviço do integrador

• • Localize o gerenciador de serviços do Windows;
  • Clique sobre o serviço "Linx DMS Integrador";
  • Clique em "Parar o serviço";
  • Após este procedimento, o status do serviço deve ficar como "Parado".

Figura 7: Tela do serviço

1. 1. Copiar o arquivo "LinxDMSIntegrador.exe" para a pasta (c:\LinxDMSIntegrador) e executá-lo.

Configuração da Conexão das Interfaces no Linx DMS Integrador

1. 1. Execute o programa "LDIConfig.exe", existente na pasta principal do Linx DMS Integrador e acesse o menu "Configuração >HPEPLAY HPE".

1. 1. Na tela "Exportação de Clientes, clique no botão "Incluir" e informe os campos a seguir:

Figura 8: Configurações Exportação de Clientes HPEPLAY

• • URL: Informe {+}https://hpeplaydev.sugarondemand.com/rest/v10/Accounts/5555+
  • Observação: URL fornecida pela HPE.
  • Nome: Informe o nome da configuração. O nome a ser informado é de livre escolha da concessionária. Ex.: ExpCli_emp1rev1, identificando o processo e a revenda que está configurando.
  • Descrição: Informe a descrição da configuração. Ex.: Exportação de clientes da empresa 1 revenda 1.
  • Log Detalhado: Marque esta opção para gravar o log detalhado do processamento da integração.
  • Log de XML: Marque esta opção para gravar o arquivo XML processado na integração.
  • Log de SQL: Marque esta opção para gravar o log de comandos SQL executados no processo da integração.
  • Número Concessionário: Informe o Dealer Number da concessionária.
  • Username: Usuário utilizado para obter o Token de validação.
  • Password: Senha utilizada para obter o Token de validação.
  • URL Token: Url utilizada para obter o Token de validação.

Observação: URL, Username e Password são fornecidos pela HPE.

• • Intervalo: Informe o intervalo para efetuar o envio dos clientes.

1. 1. Na tela de conclusão, clique no botão "Finish" para concluir e salvar a configuração. Feito isso a tela será fechada e a configuração estará pronta para ser executada.

Figura 9: Configuração Integração HPEPLAY Mitsubishi


Após realizar a configuração, o serviço do Linx DMS Integrador pode ser reiniciado.

1. 1. Reinicie o serviço do integrador

• • Localize o gerenciador de serviços do Windows;
  • Clique sobre o serviço "Linx DMS Integrador";
  • Clique em "Reiniciar o serviço";
  • Após este procedimento, o status do serviço deve continuar como "Em Execução".

Figura 10: Tela do serviço


Recebimento de dados de clientes HPE Play

O Linx DMS Clientes HPE Play é um WebService que faz a integração do site HPE Play com o Linx DMS. Ele faz o recebimento das informações dos dados de clientes enviadas pelo site HPE Play.
Considerando o seguinte fluxo:
Dados de clientes que são enviados pelo Linx DMS podem ser complementados no site e estes dados retornam para o Linx DMS;
Novos cadastros de clientes podem ser realizados no HPE Play e estes dados retornam para o Linx DMS;

Pré-requisitos para instalação

O serviço do Linx Clientes HPEPlay roda dentro do Internet Information Services (IIS), da Microsoft ou no APACHE.
A estação servidora precisa atender os seguintes requisitos, para execução do serviço:

• • IIS 6.1 ou superior (Quando for utilizar o IIS)
  • Microsoft .NET Framework 4.0 ou superior
  • Certificado com finalidade de autenticação de cliente e servidor, para possibilitar a comunicação segura via HTTPS.
    
    

    Testes do serviço

    
    Para verificar se a camada de conexão com o banco de dados está em funcionamento, abra o navegador, e informe a seguinte url:
    1. Linx Clientes HPE Play: http://localhost:81/Services/HPEPlayHPE.dll
    Exemplo:
    
    Figura 11: Tela de Teste do Serviço
    Se todas as configurações estiverem corretas, a tela acima será apresentada.
    Uma vez que a camada de conexão com o banco estiver ativa, o Linx Clientes HPE Play estará pronto para uso.
    
    
    Conteúdo do pacote

    #	Nome do arquivo	Comentário
    1	Linx DMS Integrador – Integração HPE PLAY – Dados de clientes.pdf	Este documento.
    2	Apollo.exe	Executável do Linx DMS.
    3	InstaladorLinxDMSIntegrador.exe	Instalador do Linx DMS Integrador.
    4	Fabrica.exe	Executável do Fábrica.

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.