ÍNDICE



Assunto



Implementação do projeto de integração do Linx DMS com o portal Xentry Pro


Abrangência



Esta atualização destina-se a todas as concessionárias da bandeira Mercedes Benz que utilizam o XENTRY PORTAL PRO.

Importante:

Se o serviço "WLSWinService.exe / Serviço de atualização WebService Linx DMS" estiver instalado e executando, ele deverá ser atualizado. A não observação desse alerta poderá acarretar em mal funcionamento da integração. Antes de efetuar a instalação do LinxDMSIntegrador, execute o item Atualização do WLSWinService.exe.

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



O Portal Xentry Pro trata-se de um novo processo de integração entre as concessionárias e a montadora MBB.
Tal integração permite a transferência para o portal dos Atendimentos, Orçamentos e Ordem de serviços iniciadas no Linx DMS, possibilitando ao usuário utilizar os recursos fornecidos pelo portal para catálogo de peças e serviços, acrescentado tais informações ao atendimento, orçamento ou ordem de serviço, retornando ao Linx DMS para continuidade do processo.
A integração dos atendimentos efetuados na oficina (Atendimento, Orçamento e Ordem de Serviço), gerados através do Linx DMS, é realizada pelo Serviço de Integração LINX DMS x XENTRY e pelo Monitor XENTRY, utilizando 6 processos de comunicação, que são:


  • INIT_JOB - Envio inicial ao Portal XENTRY: O Linx DMS envia o atendimento ao Portal XENTRY, levando os dados do cliente, do veículo, das solicitações, das peças e dos serviços.
  • GET_PRICES – Busca de preços no Linx DMS: Ao incluir peças ou serviços no Portal XENTRY, este irá efetuar uma comunicação para buscar os preços.
  • TRANSFERJOB_TODMS - Enviar ao Linx DMS: O usuário com acesso ao Portal XENTRY pode alterar informações do atendimento, como as solicitações do cliente, as peças, os serviços, e enviar o atendimento de volta ao Linx DMS.
  • TRANSFERJOB_TOASM - Enviar ao Portal XENTRY: O usuário pode enviar o atendimento novamente ao Portal XENTRY.
  • FINISH_ORDER – Finalização da Ordem de Serviço: Esta comunicação é disparada no momento em que a Nota Fiscal referente a Ordem de Serviço é emitida.
  • GET_DMSSETTINGS – Importação do Identificador de Fatura: Esta comunicação é disparada no momento em que a Importação do Identificador de Fatura é realizada, tratado no tópico "Importação do identificador de fatura".


O Serviço de Integração LINX DMS x XENTRY é responsável por atualizar os Atendimentos, Ordens de Serviço e Orçamentos com os dados enviados do portal através do MonitorXentry, ou seja, efetua todo o processamento referente ao DMS. É ele também que extrai as informações do DMS e envia ao MonitorXentry, que posteriormente envia ao portal.
Por sua vez, o MonitorXentry é responsável pela comunicação entre o Portal XENTRY e o Serviço de Integração Linx DMS x XENTRY, ou seja, ele recebe informações do portal e envia para o serviço, assim como o contrário, do serviço ao portal.
Monitor XENTRYServiço de Integração Linx DMS x XENTRYXENTRY Portal Pro


Figura 1: Diagrama de comunicação


Importante:

O treinamento referente a utilização do XENTRY Portal Pro será realizado pela Montadora.


Configuração parâmetros no programa Fábrica MBB


Abra o programa FabricaMBB.exe e acesse o menu "Fábrica MBB > Parâmetros"


Figura 2: Tela Parâmetros Fabrica MBB


  • Utiliza XENTRY: Marcar este campo, sinalizando que utiliza a integração com o Portal XENTRY.
  • Tempo verificação (segundos): Informar o valor "1" neste campo, para o tempo de verificação das comunicações.
  • Tipo de Serviço padrão para novos itens: Informe neste campo o Tipo de Serviço padrão para novas solicitações incluídas através do portal, quando não houverem Identificadores de Fatura selecionados.
  • Tipo de Serviço padrão para Service Measures: Informe neste campo o Tipo de Serviço padrão, para as Medidas de Serviço (Service Measures) (Recal) incluídas automaticamente pelo portal.
  • Classificação padrão para novos itens enviados ao Portal: Selecione neste campo a Classificação padrão, para novas solicitações incluídas através do Linx DMS que não tiverem classificação selecionada.
  • Envia preços ao Portal XENTRY?: Marcar este parâmetro para enviar os preços ao Portal XENTRY no momento da integração.
  • Envia dados de cliente ao Portal XENTRY?: Marcar este parâmetro para enviar os dados do cliente ao Portal XENTRY no momento da integração.
  • URL XENTRY Portal Pro: Informar o Link para abertura do Portal XENTRY ("https://xentryportal.i.daimler.com/wps/mypoc?uri=retacc:ASM-Open-Job=") ao clicar no botão "Portal XENTRY", disponível na aba "Integração XENTRY". Mais detalhes no tópico "Utilização do processo".
  • Carrega dados iniciais: Possibilita a importação de Identificação da Fatura através do Portal XENTRY Pro. Mais detalhes no tópico "Importação do Identificador de Fatura";
  • Altera Controle: Possibilita alterar o controle do atendimento entre o Portal XENTRY e o Linx DMS.


Configuração do Serviço de Integração Linx DMS x XENTRY


Abrir o programa WLSConfig.exe como administrador para que seja feita a configuração do serviço WLSLinxXENTRY.exe.


Figura 3: Tela de Configuração do WLSConfig


  • Nos campos de Banco de dados, informar os dados de acesso ao banco de dados do Linx DMS.
  • Para verificar se ficou correto os dados da base de dados, é possível efetuar um teste de conexão.
  • No campo DMS, informar Linx DMS.
  • Clicar em Aplicar.
  • Encerrar o programa.Efetuar a instalação do serviço WLSLinxXENTRY.exe.
  • Abrir o Prompt do DOS como ADMINISTRADOR;
  • Posicionar no mesmo local onde foi instalado o Linx DMS Integrador;
  • Digitar o comando WLSLinxXENTRY.exe /install e teclar ENTER

Figura 4: Tela Prompt DOS 


Figura 5: Tela Prompt DOS


  • Será exibida uma mensagem informando que o serviço foi instalado com sucesso.

Figura 6: Tela Mensagem de Sucesso na instalação do serviço


  • Após isso, o serviço estará instalado.
  • Após efetuar as configurações, devemos iniciar o serviço instalado anteriormente.
  • Acessar a tela de serviços do Windows (WIN+R -> services.msc). Procurar pelo serviço Serviço de Integração Linx DMS x XENTRY e iniciar ou reiniciar o serviço.


Figura 7: Tela Serviço do Windows


  • Se tudo ocorrer com êxito, irá criar uma pasta com o nome "LogXENTRY" no diretório do LinxDMSIntegrador.


Atualização do WLSWinService.exe


Este passo deve ser efetuado antes da instalação ou atualização do Linx DMS Integrador, apenas se o "Serviço de atualização WebService Linx DMS" estiver em uso.

  • Para atualizar o "WLSWinService.exe", acessar a tela de serviços do Windows (WIN+R -> services.msc). Procurar pelo "Serviço de atualização WebService Linx DMS" e clicar em "Parar".
  • Efetue normalmente a instalação do Linx DMS Integrador, seguindo os procedimentos descritos no Manual de Instalação do Linx DMS Integrador.
  • Acesse novamente a tela de serviços do Windows (WIN+R -> services.msc). Procure pelo "Serviço de atualização WebService Linx DMS" e clicar em "Iniciar".

Executado estes passos, o serviço estará atualizado.


Configuração do Monitor XENTRY


Importante:

A configuração do Monitor XENTRY deve ser realizada individualmente para cada revenda. Deverão ser criadas pastas para cada uma, contendo os arquivos "MonitorXentry.exe" e "xentry2.dll", configurando cada MonitorXentry com as credenciais da revenda.
Abra o programa "Monitor XENTRY.exe" e acesse o menu "Arquivo > Propriedades".


Figura 8: Tela Propriedades


Quadro "Banco de Dados":


  • Tipo: Informar o tipo do banco de dados;
  • Host: Informar o endereço do host do banco de dados;
  • Banco: Informar o SID do banco de dados;
  • Usuário: Informar o usuário do banco de dados;
  • Senha: Informar a senha do banco de dados;
  • Clicar em "Testar Conexão";


Quadro "XENTRY"


  • Usuário XENTRY: Informar o usuário de integração, fornecido pela MBB;
  • Senha XENTRY: Informar a senha do usuário de integração, fornecido pela MBB;
  • Usuário DMS: Informar "cnp";
  • URL Web Service: URL de comunicação. Manter a URL que traz automaticamente.
  • URL Persistente: URL da linha persistente. Manter a URL que traz automaticamente.
  • GSSN: Informar o código GSSN da concessionária, fornecido pela MBB.
  • Empresa: Informar o número da empresa que irá efetuar a integração através deste Monitor.
  • Filial: Informar o número da revenda que irá efetuar a integração através deste Monitor.
  • Service Type: Manter a informação trazida automaticamente;
  • Homologação em Produção: Manter desmarcado.


Em seguida, clicar em "Confirma". O Monitor irá efetuar a conexão, conforme a imagem a seguir:


Figura 9: Exemplo de conexão com sucesso


Importante:

Para o correto funcionamento do monitor, ele deve ser instalado em uma estação que fique ativa, ou seja, este executável precisa estar sempre ativo para a integração ocorrer com sucesso.


Observação:

Se o sistema apresentar a mensagem "O servidor remoto retornou um erro: (401) Não Autorizado", efetue o procedimento a baixo:


Figura 10: O servidor remoto retornou um erro: (401) Não Autorizado


Verifique se a opção "Ativar recurso de Segurança" no menu "Arquivo > Propriedades" está marcado. Marque e clique no botão "Confirma".


Figura 11: Arquivo > Propriedade


Figura 12: Propriedades > Banco de Dados


O MonitorXentry irá fechar para carregar as novas configurações. Em seguida, verifique se as url's estão corretas.
Se após marcar "Ativar recuso de segurança" o erro "401" persistir, acesse o menu "Arquivo > Propriedades" e clique no botão "EnforceCheck".
O MonitorXentry irá fechar para carregar as novas configurações.


Importação do Identificador de Fatura


Este processo deve ser efetuado assim que a comunicação for estabelecida, ou seja, requer que o Serviço de Integração Linx DMS x XENTRY e o MonitorXentry estejam ativos e configurados corretamente. Além disso, requer permissão para realizar as configurações no Portal XENTRY, portanto, verifique o processo a seguir e garanta que as telas estejam acessíveis no Portal XENTRY antes de executar.


Importante:

O passo a passo a seguir deverá ser executado completamente para cada revenda antes do início das integrações.
Acessar o menu "Fábrica MBB > Parâmetros".


Figura 13: Tela Parâmetros Fabrica MBB


Informar o campo "Classificação padrão para novos itens enviados ao Portal" e clicar no botão "Carrega dados iniciais";

Acessar o Portal XENTRY e efetuar o Login;

Acessar o menu "Funções > Administração";


Figura 14: Tela de menus do Portal XENTRY Pro


Acessar a aba "Configs. De Operação";


Figura 15: Tela de configuração do Portal XENTRY Pro


Utilizando a barra de rolagem, acesse o painel "Administração do sistema de contrato", sub-painel Identificação da nota. Clique no botão "Importar o identificador da fatura".


Figura 16: Tela do painel de controle do Portal XENTRY Pro


Se o processo ocorrer com sucesso, no campo "Identificação da nota padrão", será possível selecionar os Tipos de Serviço disponíveis no Linx DMS, bem como nos campos de Identificador de Fatura nos processos do portal. 

Alteração do Controle


Para casos em que haja a necessidade de alterar o controle do processo manualmente por falha na comunicação ou indisponibilidade na integração, efetue o seguinte processo:
Importante: Este processo deve ser efetuado somente de forma paliativa e apenas quando necessário.

Acessar o menu "Fábrica MBB > Parâmetros". Acessar a aba "XENTRY" e clicar no botão "Altera Controle";


Figura 17: Tela de parâmetros do Fábrica MBB


Abrirá a tela "Altera controle de processo":


Figura 18: Tela de Alteração de controle do processo


  • Tipo Job: Informar o tipo do processo, de acordo com o atendimento integrado (Pré-OS ou Atendimento Oficina/Orçamento/O.S.);
  • Número Processo: Informar o número do processo de acordo com o atendimento integrado (Contato/Orçamento/O.S)


Ao realizar o processo corretamente, irá apresentar a mensagem:


Figura 19: Mensagem de sucesso ao alterar o controle.


Irá também gerar um registro no processo na aba "Integração XENTRY', informando a alteração do controle:


Figura 18: Tela de registro de alteração de controle manual


Importante: Ao realizar esse processo, é necessário que o Portal XENTRY tenha o controle "sincronizado" manualmente.


Para alterar o controle no portal, devem ser seguidos os passos 3, 4 e 5 do tópico "Importação do Identificador de fatura"

Em seguida, acessar o painel "Administração de processo/pesquisa", localizar o processo desejado e clicar em "Ativar o sistema de contrato".


Figura 20: Tela da Administração do Portal XENTRY Pro


Uso do Linx DMS


Após toda a configuração do Linx DMS, Linx DMS Integrador e do Monitor XENTRY, a integração poderá ser realizada.

Nos processos que podem ser integrados (Atendimento Oficina, Orçamento e Ordem de Serviço), será habilitada a aba "Integração XENTRY", com as informações das operações realizadas e o status da última operação.

Para as Ordens de serviço de veículos na marca Mercedes Benz/ Smart, será obrigatório selecionar o tipo da classificação da Solicitação XENTRY, com os seguintes valores:


Figura 21: Tela de seleção de Classificação XENTRY

Ordem de serviço


Figura 22: Tela Manutenção da Ordem de Serviço


  • Envia: Realiza a operação de envio ao portal (INIT_JOB e TRANSFER_JOBTOASM), enviando o controle para o portal e desabilitando a manutenção do processo pelo DMS, permitindo ao usuário realizar a manutenção do processo apenas através do Portal.
  • Reenvia: Será habilitado em caso de falha na operação de envio, permitindo ao usuário efetuar o reenvio do último processo realizado.
  • Portal XENTRY: Abrirá o processo enviado para o portal automaticamente no navegador padrão através da URL parametrizada.
  • Atualiza Grade: Atualiza a grade com as informações de integração. Quando o portal devolver o processo para o DMS (TRANSFERJOB_TODMS), será necessário atualizar as informações para desbloquear o controle. Ao receber o processo do Portal, o sistema irá atualizar as informações e o controle será transferido para o DMS, permitindo que o usuário realize a manutenção do processo apenas através do DMS.
  • Ao realizar a emissão da nota fiscal ou o cancelamento da O.S., será enviado ao portal a operação FINISH_JOB, sinalizando que o processo foi finalizado.


Atendimento


Figura 23: Tela Atendimento Oficina 


Orçamento


Figura 24: Tela Orçamento


Para envio do orçamento é necessário gera-lo primeiro na opção, para depois integrar no portal XENTRY.

Considerações sobre o processo


Códigos de serviços atribuídos nas solicitações via portal XENTRY e que ainda não tenham cadastro no Linx DMS, serão automaticamente cadastrados para o modelo do veículo da solicitação;
-Códigos de peças atribuídos nas solicitações via Portal XENTRY e que ainda não tenham cadastro no Linx DMS, não são cadastrados automaticamente. O portal apresentará uma mensagem informando o código da peça e a falta de cadastro no DMS.


Figura 25: Tela de Erro Peça não cadastrada 


Enquanto não for realizado o cadastramento manual da peça no Linx DMS, não será possível integrar o procedimento.


Figura 26: Tela de Bloqueio de Exclusão de Itens


Kit de itens atribuídos nas solicitações via Portal XENTRY e que ainda não tenham cadastro no Linx DMS, serão cadastrados automaticamente, porém, a verificação do cadastro do item será realizada. Se houver um item do Kit que não tenha cadastro no Linx DMS, a mesma mensagem acima será apresentada e, enquanto o item não for cadastrado manualmente, não será possível integrar o procedimento. Uma vez estando todos os itens cadastrados, o Linx DMS cadastra o Kit na opção Peças> Cadastro -> Kit de Itens, atribuindo a numeração automática do processo, mas identificando o código Original do Kit no campo "Código da Fábrica".
Figura 26: Tela de Cadastro de Kit de Itens

  • Códigos de peças e serviços não poderão ser excluídos de uma solicitação, se eles já estiverem requisitados em uma Ordem de serviço. O Sistema informará o usuário mostrando um cadeado ao lado da peça ou serviço dentro da solicitação. 

Figura 27: Tela de Bloqueio de exclusão de itens 


  • Códigos de peças e serviços que forem incluídos via Portal Xentry, deverão respeitar o Identificador de fatura registrado na Origem, portanto, precisam ser alterados sempre que necessário para o mesmo identificador da solicitação. Caso a inclusão do item não seja identificada corretamente, o portal apresentará uma mensagem informando que a solicitação possui mais de um identificador de fatura. 

Figura 28: Tela de Erro no identificador da Fatura


Enquanto não for realizado a alteração do identificador, não será possível integrar o procedimento. Se o usuário deseja ter solicitações com Identificadores de faturas diferentes, deverá ser criada uma solicitação para cada tipo de fatura.

  • Ordens de serviço Internas que não geram Nota Fiscal, não serão gerados o registro FINISH_JOB, uma vez que esse processo é disparado quando há emissão de Nota, portanto, essas ordens não são enviadas para o Arquivo.



  • Sem rótulos