Linx DMS Integrador | Manual Integração OPV
ÍNDICE
Assunto Abrangência Aplicação
Configuração cadastro de Tipos de Via no programa Apollo Configuração cadastro de vendedores no programa Apollo Configuração tabela de profissões no programa Apollo Configuração cadastro de clientes no programa Apollo Instalação/Atualização do Linx DMS Integrador Configuração do Linx DMS Integrador
Observação!
Acompanhado a integração do Linx DMS Integrador Uso do Linx DMS
Assunto
Integração do LINX DMS Apollo e o sistema OPV* das Montadoras Peugeot e Citroën. O processo integrante deste projeto é: Importação de Pedidos de Venda de Veículos Novos.
*OPV é um sistema das Montadoras Peugeot e Citroën que permite efetuar as negociações de venda de veículos novos.
Abrangência
Esta atualização destina-se a todas as concessionárias Peugeot e Citroën que utilizam o OPV.
Atenção:Antes de prosseguir com este manual, certifique-se de que você leu e executou os procedimentos descritos no Manual de Instalação do Linx DMS Integrador.
Aplicação
Processos
Integração dos Pedidos de Vendas de Veículos Novos gerados no sistema OPV com a inclusão automática da proposta de veículos no Linx DMS Apollo.
Comunicação
O processo de comunicação é pelo LINX DMS Integrador.
Configuração parâmetros no programa Fábrica
Abra o programa Fabrica.exe;
Acesse o menu "Fábrica > Peugeot > Parâmetros" ou "Fábrica > Citroën > Parâmetros", conforme a bandeira da concessionária.
Figura 1: Tela Parâmetros Fabrica
Marcar a opção "Utiliza OPV"
Na opção "Bloquear abertura de Propostas Veículos Novos?", informar "Sim". Desta forma não será permitido criar uma nova proposta de veículos diretamente no Linx DMS Apollo. Ao utilizar a integração com a OPV, as propostas devem ser geradas no sistema da OPV.
Configuração cadastro de Tipos de Via no programa Apollo
Abra o programa Apollo.exe
Acesse o menu "Configuração > Tipos de Via"
Figura 2: Tela Cadastro Tipo de Via
Para cada tipo de via cadastrado, deve ser informado o campo Código OPV. Este campo será usado para que ao efetuar o cadastro do cliente automaticamente, o Linx DMS Integrador saiba qual tipo de via informar no Linx DMS Apollo com a informação vinda do sistema OPV.
Abaixo tabela com os códigos de tipo de via do sistema da OPV que devem ser informados no campo Código OPV ne seu respectivo registro.
Código Descrição
Al Alameda
Av Avenida
Av Avenida Marginal
Bc Beco
Cam Caminho
Est Estrada
Est Estrada Estadual Est Estrada Municip
Est Estrada Velha
Ld Ladeira
Lrg Largo
Lot Loteamento
Mte Monte
Prq Parque
Prq Parque Municipal
Psg Passagem
Psg Passg. Pedestres
Pr Praia
Pç Praça
QD Quadra
Rod Rodovia
R Rua
R Rua Particular
Rot Rótula
Tv Travessa
V Via
VEx Via Expressa
VAc Via de Acesso
Vd Viaduto
Vla Viela
Figura 3: Tabela de Tipo de Via do sistema OPV
Configuração cadastro de vendedores no programa Apollo
Acessar o menu "Faturamento > Cadastro > Vendedores > Cadastro Vendedores"
Figura 4: Tela Cadastro de Vendedores
Para cada vendedor deve ser informado o campo Código OPV, com o código do vendedor usado no sistema da OPV.
Configuração condições de pagamento no programa Apollo
Acessar o menu "Faturamento > Cadastro > Condições de Pagamento"
Figura 5: Tela Cadastro Condições de Pagamento
No cadastro da condição de pagamento, acessar a aba Código OPV. Nesta aba deve ser informado em cada condição de pagamento o campo Código Condição Pagamento OPV respectivo. Esta informação será usada pelo Linx DMS Integrador ao importar a proposta gerada no sistema da OPV.
Configuração tabela de profissões no programa Apollo
Acessar o menu "Faturamento > Manutenção de Clientes > Tabela de Profissões"
Figura 6: Tela Cadastro de Profissões
Na tela de Manutenção de Profissões, deve ser informado o campo Código OPV com o código da OPV respectivo, para que ao cadastrar um novo cliente no Linx DMS Apollo, o sistema possa informar a profissão correspondente.
Abaixo tabela com os dados da OPV.
Código Descrição
1 Administrador
2 Advogado
3 Aeronauta
4 Arquivista / Técnico de Arquivo 5 Artista/Técnico em espetáculos 6 Assistente Social
7 Atleta de Futebol
8 Atleta Profissional de Futebol
9 Atuário
10 Bibliotecário
11 Biomédico
12 Biólogo
13 Bombeiro Civil 14 Contabilista 15 Corretor de Imóveis 16 Corretor de Seguros 17 Despachante Aduaneiro
18 Economista
19 Economista Doméstico 20 Educação Física 21 Empregado Doméstico
22 Enfermagem
23 Engenheiro/ Arquiteto/ Agrônomo 24 Engenharia de Segurança
25 Enólogo
26 Estatístico 27 Farmacêutico
28 Fisioterapeuta e Terapeuta ocupa 29 Fonoaudiólogo
30 Garimpeiro
31 Geógrafo
32 Geólogo
33 Guardador e Lavador de Veículos 34 Instrutor de Trânsito
35 Jornalista 36 Leiloeiro 37 Leiloeiro Rural
38 Massagista
39 Médico
40 Medicina Veterinária 41 Moto taxista e Motoboy
42 Museólogo
43 Músico
44 Nutricionista
45 Oceanógrafo
46 Odontologia
47 Orientador Educacional 48 Pescador Profissional 49 Peão de Rodeio 50 Psicologia
51 Publicitário/Agenciador Propa
52 Químico
53 Radialista
54 Relações Públicas 55 Repentista
56 Representantes Comerciais 57 Secretário - Secretário Exec.
58 Sociólogo
59 Técnico em Administração 60 Técnico em Radiologia 61 Técnico Prótese Dentária 63 Zootecnista
Figura 7: Tabela de cadastro de profissões da OPV
Configuração cadastro de clientes no programa Apollo
Acessar o menu "Faturamento > Manutenção de Clientes > Cadastro de Clientes."
Figura 8: Tela Cadastro de Clientes
1.
2.
3.
Na tela de Manutenção de Clientes, foi incluído o campo Código Cliente OPV, que irá identificar o cliente cadastrado no sistema da OPV com o Linx DMS Apollo.
Após efetuar os passos anteriores, o sistema Linx DMS Apollo já está configurado para a integração com o OPV.
Instalação/Atualização do Linx DMS Integrador
Atenção:Antes de prosseguir com este manual, certifique-se de que você leu e executou os procedimentos descritos no Manual de Instalação do Linx DMS Integrador.
Efetuar a instalação do serviço WLSWinService.exe. Este serviço irá alimentar o Linx DMS Apollo com as informações que o Linx DMS Integrador buscou do OPV.
Abrir o Prompt do DOS como ADMINISTRADOR;
Posicionar no mesmo local onde foi instalado o Linx DMS Integrador Digitar o comando WlSWinservice.exe /install e teclar ENTER
Figura 9: Tela Prompt DOS
Será exibido uma mensagem informando que o serviço foi instalado com sucesso.
Figura 10: Tela Mensagem de Sucesso na instalação do serviço
Após isso o serviço está instalado.
Configuração do Linx DMS Integrador
Acessar o diretório onde foi instalado o Linx DMS Integrador.
Executar o programa LDIConfig.exe.
Ir no menu "Configuração > Configura Geração de XML".
Clicar no botão "+ Incluir" para incluir a configuração para a integração via WebService. Esta configuração deve ser efetuada por filial.
Na tela de Identificação, informar o campo Nome e Descrição, no campo Módulo, deve selecionar "opvws".
Figura 11: Tela de Identificação Clicar em Next;
Na tela de Origem/Acesso, informar os dados de conexão com o banco de dados do Linx DMS.
Figura 12: Tela de Origem/Acesso
Para verificar se ficou correto os dados da base de dados, é possível efetuar um teste de conexão.
Após a conexão OK, clicar em Next.
Na tela Origem/Comando, deixar em branco e clicar em Next.
Na tela de Origem/Resultado, informar Tipo = Memória e clicar em Next.
Figura 13: Tela de Origem/Resultado
Na tela Destino, deve informar os dados de acesso ao WebService da OPV, estes dados são fornecidos pela própria OPV.
Figura 14: Tela de Destino
: Informar o endereço do WebService fornecido pela OPV.
Url
: Informar o usuário de acesso ao WebService.
Usuário
: Informar a senha de acesso ao WebService.
Senha
: Informar a senha do certificado digital que será usado para acesso ao WebService da OPV.
Senha Cert
: Informar o código da concessionária com a montadora, seguido da letra A. O mesmo informado nos parâmetros do Fábrica.
Dealer Code
: P para Peugeot e C para Citroën Marca (P/C)
Após informar os dados da tela de Destino, clicar em Next
Na tela de Agendamento, pode ser informado o tempo de intervalo entre as consultas ao WebService da OPV para verificar novas propostas. Após informar, clicar em Next.
Figura 15: Tela de Agendamento Por fim, clicar em Finish para concluir a gravação da configuração.
Observação!
O cerificado digital usado para acesso ao WebService da OPV deve ter o seu nome de arquivo igual ao usuário informado no campo Usuário da tela Destino do Linx DMS Integrador. Este certificado é fornecido pela OPV. O certificado deve ser colocado na pasta (C:\LinxDMSIntegrador\Pacotes) e ele não precisa ser instalado.
Na tela de Cadastro de Seleção, clicar novamente no botão "+ Incluir" para incluir a configuração para a integração via arquivo texto. Esta configuração é única e serve para todas as filiais.
Na tela de Identificação, informar o campo Nome e Descrição, no campo Módulo, deve selecionar "opvrecbat".
Figura 16: Tela de Identificação Clicar em Next.
Na tela de Origem/Acesso, informar os dados de conexão com o banco de dados do Linx DMS.
Figura 17: Tela de Origem/Acesso
Para verificar se ficou correto os dados da base de dados, é possível efetuar um teste de conexão;
Após a conexão OK, clicar em Next.
Na tela Origem/Comando, deixar em branco e clicar em Next. Na tela de Origem/Resultado, informar Tipo = Arquivo O campo Campo Origem deve ficar em branco.
No campo Path, informar o local onde estará os arquivos da OPV para processamento.
No campo NomeArquivo, informar o nome do arquivo com os dados da OPV, deve ser sempre o mesmo nome.
Figura 18: Tela de Origem/Resultado Clicar em Next.
Na tela Destino, clicar em Next.
Na tela de Agendamento, informar quais os dias da semana e o horário que deve ser feito o processamento.
Figura 19: Tela de Agendamento
Clicar em Next.
Por fim, clicar em Finish para concluir a gravação da configuração via arquivo txt.
Encerrar o programa LDIConfig.exe
Abrir o programa WLSConfig.exe para que seja feito a configuração do serviço que irá gerar as propostas, no Linx DMS, com base nos dados vindos da OPV.
Figura 20: Tela de Configuração do WLSConfig
Nos campos de Banco de dados, informar os dados de acesso ao banco de dados do Linx DMS Apollo.
Para verificar se ficou correto os dados da base de dados, é possível efetuar um teste de conexão.
No campo DMS, informar Apollo.
No campo Atualização de dados de clientes já importados, porém com alguma inconsistência, informar o tempo de intervalo entre uma atualização e outra.
Clicar em Aplicar. Encerrar o programa.
Após efetuar as três configurações, devemos iniciar/reiniciar os serviços criados anteriormente.
Acessar a tela de serviços do Windows;
Procurar pelo serviço Linx DMS Integrador e iniciar ou reiniciar o serviço.
Figura 21: Tela Serviço do Windows
Procurar pelo serviço Serviço de atualização WebService Linx DMS e iniciar/reiniciar o serviço.
Figura 22: Tela Serviço do Windows
Após iniciar/reiniciar os dois serviços, a comunicação irá ser realizada automaticamente, conforme as configurações feitas.
Acompanhado a integração do Linx DMS Integrador
Para verificar como está o andamento das integrações ou verificar o motivo de alguma proposta feita, no sistema da OPV, que não esteja integrando no Apollo, podemos seguir da seguinte forma.
Na pasta onde foi instalado o Linx DMS Integrador, abrir o programa LDIConfig.exe Acessar o menu "Configuração > Monitor Log de Execução".
Figura 22: Tela do Monitor Log
No campo Exibir Log, pode ser selecionada a opção Completa, para que mostre informações mais detalhadas ou Resumido, para que mostre menos informações.
No campo Modulo – dll, sempre informar WLSWinService.exe
No campo Processos, informar o processo que deseja acompanhar, neste caso é Atualização do Processo do OPV. No campo Configuração, sempre informar WLSWinService.exe
Desta forma podemos acompanhar o andamento do processo e verificar caso algo esteja ocorrendo algum erro.
Para pesquisar por logs mais antigos, deve ser acessado a tela Pesquisa em Logs através do botão Pesquisar em logs anteriores.
Figura 22: Tela do Monitor Log Histórico
Informar os dados de Módulo – dll Processos, e Configuração, conforme descrito anteriormente.
Informar no campo Data de Execução a data que deseja efetuar a busca dos logs.
Ao clicar no botão Pesquisar, será efetuada a busca dos logs, conforme o filtro.
Figura 23: Tela do Resultado do Monitor Log Histórico
Desta forma é possível localizar algum processo que ocorreu erro e efetuar a sua correção.
Uso do Linx DMS
Após toda a configuração do Linx DMS e do Linx DMS Integrador, a integração será realizada automaticamente.
Para verificar as propostas de veículos novos processadas, deve ser acessar o menu "Veículos > Consultas/Relatórios > Consulta Propostas".
Na tela de Consulta Propostas é possível efetuar a busca desejada para localizar a proposta.
Figura 24: Tela de consulta de proposta
A partir deste passo o uso do sistema é normal, como era feito anteriormente, sem a necessidade da inclusão das propostas, apenas se faz necessário às aprovações Gerencial e Financeira da proposta.