Linx DMS Integrador
Manual de Configuração Sugar Mitsubishi
Data: 14/11/2016
Autor: Distribuição Linx DMS
[email protected]
Área: P&D DMS Porto Alegre
Assunto
Este documento descreve a configuração e o funcionamento dos processos de integração do DMS com o Sugar da Mitsubishi.
Abrangência
Esta atualização destina-se a todas as concessionárias da marca Mitsubishi.
Aplicação
Configurando o Integrador para as integrações com o Sugar da Mitsubishi
- Abra o programa "LDIConfig.exe" que fica em c:\LinxDMSIntegrador;
Acesse o menu "Configuração > Integração Sugar Mitsubishi". Após cada passo relacionado a seguir, clique no botão Next. - Na tela "Configurações", informe os campos referentes ao banco de dados que serão acessados para buscar as informações;
Figura 1: Configuração Integração Sugar Mitsubishi
No caso do Banco de Dados "Informix", no campo "Host", informe o nome da instância de produção. Exemplo: ol_standard;
- Após informar todos os dados, clique no botão "Testar conexão" para verificar se o sistema irá conseguir se conectar com o bando de dados;
Figura 2: Configuração Integração Sugar Mitsubishi
- Na tela "Importação de Pedidos de Venda", informe os dados para cadastrar a configuração desejada:
Figura 3: Configuração Integração Sugar Mitsubishi
Campos:
- URL: Informe o endereço url do serviço para importação de Pedidos de Venda;
- Nome: Informe o nome da configuração. O nome a ser informado é de livre escolha da concessionária. Ex: PedVend_emp1rev1;
- Descrição: Informe a descrição da configuração. Ex: Importação dos Pedidos de Venda da empresa 1 revenda 1;
- Permissão de acesso: Deve ser informado o "Login", "Senha" e "Número Concessionário" (Número Concessionário deve ser o mesmo valor definido nos parâmetros do Fábrica Mitsubishi);
- Intervalo: Selecionar o intervalo de tempo entre cada integração;
- Na tela "Exportação de OS", informe os dados para cadastrar a configuração desejada:
Figura 4: Configuração Integração Sugar Mitsubishi
Campos:
- URL: Informe o endereço url do serviço para Exportação de Ordens de Serviço;
- Nome: Informe o nome da configuração. O nome a ser informado é de livre escolha da concessionária. Ex: ExpOS_emp1rev1;
- Descrição: Informe a descrição da configuração. Ex: Exportação de Ordens de Serviço da empresa 1 revenda 1;
- Data base (inicial) para envio das Ordens de Serviço: Somente ordens de serviço com data igual ou superior a essa data serão enviadas;
- Permissão de acesso: Deve ser informado o "Login", "Senha" e "Número Concessionário" (Número Concessionário deve ser o mesmo valor definido nos parâmetros do Fábrica Mitsubishi);
- Intervalo: Selecionar o intervalo de tempo entre cada integração;
- Na tela "Exportação de Notas Fiscais", informe os dados para cadastrar a configuração desejada:
Figura 5: Configuração Integração Sugar Mitsubishi
Campos:
- URL: Informe o endereço url do serviço para Exportação de notas fiscais;
- Nome: Informe o nome da configuração. O nome a ser informado é de livre escolha da concessionária. Ex: ExpNF_emp1rev1;
- Descrição: Informe a descrição da configuração. Ex: Exportação de Notas Fiscais da empresa 1 revenda 1;
- Permissão de acesso: Deve ser informado o "Login", "Senha" e "Número Concessionário" (Número Concessionário deve ser o mesmo valor definido nos parâmetros do Fábrica Mitsubishi);
- Intervalo: Selecionar o intervalo de tempo entre cada integração.
- Na tela de conclusão, clique no botão "Finish" para concluir e salvar a configuração. O sistema deve fechar a tela.
Figura 6: Configuração Integração Sugar Mitsubishi
- Acesse na barra de ferramentas do Windows, menu "Iniciar > Painel de Controle > Ferramentas Administrativas > Serviços". Localize e clique sobre o serviço instalado "Linx DMS Integrador";
Figura 7: Serviços (local)
- Clique na opção "Reiniciar" e aguarde concluir o processo;
- A partir deste momento o sistema irá executar as integrações cadastradas: Importação de Pedidos de Vendas, Exportação de OS e Exportação de Notas Fiscais;
Configurando o Fábrica para as integrações com o Sugar da Mitsubishi
- Abra o programa Fábrica.exe;
Acesse o Menu (44590): "Fábrica > Mitsubishi > Parâmetros". Nesta tela deve ser informado o "Número da Concessionária" e marcada a opção "Utiliza Integração com o Sugar".
Figura 8: Manutenção de Parâmetros da Mitsubishi
Configurando o Linx DMS Apollo para as integrações com o Sugar da Mitsubishi
- Abra o programa Apollo.exe;
Acesse o menu (58454): "Faturamento > Cadastros > Vendedores > Cadastro Vendedores". Na aba "Detalhes Adicionais" foi incluído o campo "E-mail do Vendedor". Neste campo deve ser preenchido com E-mail do Usuário no CMR do Sugar. Este campo deve ser corretamente preenchido para que o usuário do CRM possa ser associado corretamente ao vendedor do Linx DMS Apollo.
Figura 9: Manutenção de Vendedores
Após a realização das configurações citadas anteriormente o sistema estará pronto e realizará o envio automático de Dados de Ordens de Serviços e de Notas Fiscais de veículos, peças e serviços, tanto os dados referentes à emissão quanto cancelamento e devolução, bem como a importação de pedido de vendas através do WebService definido nos parâmetros.
Processo de Importação de Pedidos de Vendas
Após criada a configuração para Importação de Pedidos dentro do LDiConfig.exe o LinxDMSIntegrador irá buscar os pedidos no webservice da Mitsubishi e gravá-los em uma área temporária onde os pedidos ficam aguardando processamento.
É necessário associar a cada pedido importado do Sugar o chassi correspondente aquela proposta de veículo.
Para isso, deve-se acessar o Menu (44584): "Fábrica > Mitsubishi > Veículos > Importação de Pedido de Veículos – Sugar".
Figura 10: Importação de Pedido de Veículos - Sugar
Nesta tela temos as opções de filtro:
- Data do pedido (na Mitsubishi);
- Número Pedido Mitsubishi;
- Vendedores;
- Cliente;
- Tipo de Pedidos (Pedidos pendentes, com proposta ou ambos).
Figura 11: Importação de Pedido de Veículos - Sugar
Na aba "Resultado", será exibido o resultado do filtro. Clicando duas vezes sobre um registro ou clicando na aba manutenção, serão exibidos os detalhes do registro.
Figura 12: Importação de Pedido de Veículos - Sugar
Nesta tela, deve-se selecionar o chassi correspondente ao pedido importado do Sugar, clicando no botão de seleção ao lado do campo Chassi.
Figura 13: Importação de Pedido de Veículos - Sugar
Após associados o(s) chassi(s) o botão "Importar Pedidos para o Apollo" será habilitado. Ao clicar nele, será gerada a proposta no Linx DMS Apollo.
Acompanhando o status do processo de integração (Envio/retorno da troca de informações com a Mitsubishi
- Abra o programa LDIConfig.exe que fica em c:\LinxDMSIntegrador;
Acesse o menu "Configuração > Monitor do Log de Execução";
Figura 14: Linx DMS Integrador
- No programa "Monitor Log de Execução", clique no botão Configurar Conexão para abrir a janela "Configuração de Conexão";
Na janela aberta, preencha os campos com os dados de acesso da base que deseja monitorar;
Clique em "Testar Conexão" para verificar se a comunicação com a base de dados está ok.
Figura 15: Monitor do Log de Execução do Linx DMS Integrador
- Ainda na tela do monitor é possível realizar filtros utilizando os campos presentes no menu superior, conforme explicado abaixo:
Campos para Filtros:
- Exibir Log: Informe se o log será exibido de forma resumida (status geral do processo, se concluiu com sucesso ou se apresentou erro) ou de forma completa (mostra todos os registros de envio e de retorno das informações);
- Módulo - dll: Selecione o módulo LDISugarMitsubishi.dll;
- Processos: Informe o processo de integração que deseja visualizar:
- Importação de Pedidos de Vendas;
- Exportação de Ordens de Serviço;
- Exportação de Notas Fiscais;
- Configuração: Informe a configuração que deseja visualizar (Ex: ExpOS_emp1rev1);
- Restrição do Log:
- Selecione o intervalo de minutos que deseja visualizar na exibição do log (Ex: 60min);
- Selecione a quantidade de registros que serão exibidos;
- Marque a opção "Exibir Log Detalhado" caso deseje verificar as informações detalhadas dos registros processados;
Após a seleção dos filtros, o usuário deverá clicar no botão "Atualizar Log" para que os filtros possam ser aplicados à consulta.
Figura 16: Monitor do Log de Execução do Linx DMS Integrador
Com base nos filtros informados pelo usuário, o Monitor do Log de execução irá retornar as seguintes informações:
- Data/Hora: Data e hora da execução do processo;
- Módulo: Nome do módulo que deu origem ao envio das informações;
- Configuração: Descrição da configuração utilizada neste processo;
- Descrição do Processo: Descrição padrão do processo de envio de XML para a Renault;
- Mensagem Log: Mensagem indicativa do resultado da execução do processo. Por exemplo, as mensagens retornadas pela Renault para cada envio de arquivo XML;
- Tipo: Poderá ser Normal, SQL ou XML. Normal - é apenas uma mensagem informativa do evento que está sendo executado. SQL ou XML se referem à mensagem informativa e permitem que o usuário possa aplicar um duplo clique sobre o registro para visualizar o SQL de execução ou o XML descrito na mensagem.
Figura 17: Visualizador XML/SQL
Dúvidas
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Linx DMS Apollo através do telefone +55 (51) 2101-9933 ou através do site help.linx.com.br.