ESTE MANUAL DESTINA-SE AO AUXÍLIO NA PARAMETRIZAÇÃO DA INTEGRAÇÃO DO LINX DMS
...
COM O XENTRY PORTAL PRO
Manual para parametrização do XENTRY portal PRO
Assunto
Integração do Linx DMS com o XENTRY PORTAL PRO
Abrangência
Este manual destina-se ao auxilio na parametrização da integração do Linx DMS com o XENTRY PORTAL PRO.
Aplicação
REQUISITOS TÉCNICOS
...
Painel | ||
---|---|---|
| ||
Requisitos técnicos
|
...
|
...
CONFIGURAÇÃO DE AMBIENTE
MONITOR
...
Configuração do ambiente
MONITOR
O MONITOR DE INTEGRAÇÃO
...
deverá ser instalado e configurado em um Servidor Windows com
...
o Client Informix
...
instalado. Este executável encontra-se no
...
pacote XENTRY.zip
...
na página de aplicativos. A imagem abaixo mostra a tela inicial do Monitor.
Para configurar os parâmetros de integração, acesse o menu superior:
Arquivo
...
Propriedades.
...
O quadro
...
"Banco de Dados
...
" deve receber os dados de conexão com o banco SISDIA do LinxDMS. Deve ser informado o tipo
...
"Informix". O Host deve ser o nome configurado no Client Informix (tela abaixo). O nome do Banco, Usuário e Senha já devem estar configurados em um ambiente onde o LinxDMS já está rodando normalmente. Estes dados são fornecidos pelo TI da empresa.
No quadro
...
"XENTRY
...
" devem ser informados os dados de conexão com o XENTRY Portal Pro. Todos os dados relativos à conexão com Web Service, Linha Persistente e Usuário de acesso ao portal são fornecidos pela Mercedes.
Neste quadro também deve ser informado para
...
qual Filial
...
o monitor irá trabalhar. Para operar com múltiplas filiais, deverão ser instalados monitores em diferentes
...
"Pastas" no servidor, refletindo a estrutura das filiais. Todos os Monitores deverão estar em funcionamento e cada um deles, configurado para uma filial distinta.
...
...
O Client Informix deve ser instalado e configurado para executar o MONITOR. Esta instalação poderá ser feita pelo setor de serviços da LINX.
CRONTAB
...
O programa XENT0000
...
deve ficar no diretório de programas que rodam via CRONTAB no servidor LINUX.
...
São 2 arquivos de Shell para disparo:
Run_XENT0000.sh
...
é o shell para instalação e execução do programa, que encontra-se no
...
pacote XENTRY.zip na página de aplicativos.
Run_XENT0000_restart.sh é o shell de restart da aplicação, que também encontra-se no pacote XENTRY.zip
...
na página de aplicativos.
...
PARÂMETROS DE INTEGRAÇÃO:
Exemplo de configuração do CRONTAB:
- 6-23 * * * /root/bin/Run_XENT0000_restart.sh >>/tmp/Run_XENT0000_restart.1.log 2>>/tmp/Run_XENT0000_restart.2.log
Observação: Somente o shell Run_XENT0000_restart.sh é configurado no CRONTAB.
Parâmetros de integração
CADA0900
Deve existir o registro
...
"Código Integração = XENTRY
...
" para as filiais que possuem os processos de oficina integrado com o XENTRY. A integração deve estar
...
"On Line".
Âncora | ||||
---|---|---|---|---|
|
Este programa fornece uma série de parâmetros úteis para a execução do XENTRY.
Os parâmetros são configurados por filial, e estão subordinados ao parâmetro de integração
...
no CADA0900, ou seja, cada filial que utiliza o XENTRY deverá ter sua própria configuração
...
no XENT1000. A imagem abaixo mostra a tela de parâmetros:
...
Tipo de Ordem Default (Invoice Code) para ITENS:
...
parâmetro utilizado quando o consultor cria um novo item (reclamação) no PORTAL. Ao ser importado para o DMS, esta reclamação será um novo item na Ordem de Serviço. Se o item for criado vazio (sem peças e serviços), então o Tipo de Ordem utilizado para classifica-lo será o deste parâmetro.
Tipo de Ordem Default para SERVICE MEASURE:
...
parâmetro utilizado para criar na Ordem de Serviço itens que serão abertos para tratar os
...
"Service Measures" (Medidas de Serviço) abertas automaticamente para o modelo do chassi especificado na O.S.
Envia preços ao Portal XENTRY?
...
Informa se o concessionário quer que os preços de peças e serviços sejam enviados ao PORTAL.
Envia dados de cliente ao Portal XENTRY?
...
Informa se o concessionário quer que os dados cadastrais do cliente sejam enviados ao PORTAL.
Classificação Padrão dos itens de Ordem de Serviço:
...
As ordens de serviços enviadas ao PORTAL devem ter uma das seguintes classificações:
- MAINTENANCE (Manutenção)
- COMPLAINT (Reclamação)
- CUSTOMER_REQUEST (Solicitação do Cliente)
Este parâmetro torna a classificação selecionada o padrão para todos os itens de O.S. abertos.
Exporta Tipos de OS das bandeiras:
...
Este parâmetro controla quais tipos de Ordem de Serviço serão exportados para o Invoice Code do XENTRY Portal. Serão aceitas as seguintes opções:
- MBB
- MBA
- DIV
- Outras
O usuário poderá marcar uma ou mais opções para exportação. Esta importação é ativada
...
pelo XENTRY Portal, através do botão
...
"Import invoice
...
markers", localizado em:
Functions
...
Administration
...
Operation settings
...
Order system administration.
Tempo de Sleep entre uma consulta e outra:
...
Este parâmetro controla o
...
"robô" de integração do XENTRY. Ele informa em quanto tempo o sistema irá ler as requisições do PORTAL. O valor default é 1 segundo para cada intervalo de leitura.
Hora de finalização
...
automática do processo CRON:
...
URL do Portal XENTRY Pro:
...
É a URL informada pela Mercedes para abrir automaticamente o XENTRY Portal Pro após o envio de uma ordem de serviço.
...
Correlação LINX-
...
DMS ←→ XENTRY
PROP1000
Todo produto original cadastrado deve estar relacionado com o XENTRY (PartNumber) através do
...
campo Lista Fábrica, ou seja, este campo deve conter a identificação da peça no portal XENTRY.
...
CADP0130
Todo serviço original deve estar cadastrado no campo Código serviço. Este código identificará o
...
"WorkItem" no Portal.
...
DIAG0200
Os pacotes de serviço originais devem estar relacionados ao Código de Defeito informado pela montadora.
Além disso, os pacotes de serviço originais devem ser cadastrados com o código do pacote informado pela fábrica no campo Sigla do Pacote.
...
Fluxo do processo
- ORDEM DE SERVIÇO
- OFIC1000:
...
- agente abre O.S. e envia ao Portal XENTRY através do
...
- serviço InitJob.
- XENTRY:
...
- O.S. é manipulada pelo agente, podendo incluir pacotes, peças e serviços.
- XENTRY:
...
- agente dispara requisição de consulta
...
- aos preços através do
...
- serviço GetPrice.
- XENT0000/MONITOR:
...
- DMS responde à requisição.
- XENTRY:
...
- envia a O.S. de volta ao DMS através do
...
- serviço TransferJobToDMS.
- OFIC1400:
...
- DMS requisita ou estorna peças, e reenvia ao Portal através do
...
- serviço TransferJobToASM.
- OFIC1570:
...
- DMS inclui novos serviços na O.S. e reenvia ao Portal através do
...
- serviço TransferJobToASM.
- XENTRY:
...
- envia a O.S. ao DMS para ser faturada através do
...
- serviço TransferJobToASM.
- OFIC3500:
...
- DMS fatura a O.S. e envia o status para o Portal via
...
- serviço FinishJob.
- PRÉ-O.S.
- OFIC0375:
...
- agente abre agendamento e Pré-O.S. e envia ao Portal XENTRY através do
...
- serviço InitJob.
- XENTRY:
...
- Pré-O.S. é manipulada pelo agente, podendo incluir peças e serviços.
- XENTRY:
...
- envia a Pré-O.S. ao DMS
...
- TransferJobToASM.
- OFIC1000:
...
- nova OS é aberta para o chassi da Pré-O.S. Esta Pré-O.S. é importada na OS
...
- InitJob
...
- ou TransferJobToASM
...
- para a nova O.S.
OBSERVAÇÂO:
...
O Job da Pré-O.S. deverá ser removido manualmente no PORTAL.
...
- ORÇAMENTO
- BALC2000:
...
- agente abre orçamento para o setor de Oficina (CADA0305 -> Produtivo =
...
- "SIM") e envia ao Portal XENTRY através do
...
- serviço InitJob.
- XENTRY:
...
- Orçamento é manipulado pelo agente, podendo incluir peças e serviços.
- XENTRY:
...
- envia a Orçamento ao DMS
...
- TransferJobToASM.
- OFIC2005:
...
- Orçamento é importado em
...
- O.S.InitJob ou TransferJobToASM para a nova O.S.
OBSERVAÇÂO:
...
O Job do orçamento deverá ser removido manualmente no PORTAL.
...
Detalhamento do processo
ORDEM DE SERVIÇO
OFIC1000
Ao incluir uma nova Ordem de Serviço o sistema a envia a Ordem para o XENTRY através do serviço InitJob. Neste momento o
...
"domínio" da O.S. será transferido para o Portal XENTRY, e como consequência o DMS não poderá fazer nenhuma modificação na mesma, como inclusão de peças, pacotes e serviços.
A transferência ocorre através do Integrador XENTRY. Após a conclusão do processo de inclusão da Ordem de Serviço no sistema, se a filial estiver integrada com o XENTRY (CADA0900), então o processo de integração será ativado automaticamente. A próxima imagem mostra o DMS enviando a ordem de serviço ao Portal:
...
A mensagem
...
"SEM RETORNO DO
...
XENTRY" quer dizer que a comunicação ainda não ocorreu. O sistema irá fazer 3 tentativas, o que se mostra suficiente para o Web Service enviar a Ordem de Serviço.
Caso ocorra algum problema de comunicação, como por exemplo: Integrador, ou o Portal XENTRY fora do ar, após as 3 tentativas, o sistema irá solicitar confirmação de outras 3 tentativas (imagem abaixo).
Se o usuário responder
...
"Não", o DMS seguirá o fluxo normal do sistema, mantendo a Ordem de Serviço no domínio do DMS e deixando a comunicação pendente para o Integrador XENTRY.
Após a integração, a tela de monitoramento da operação apresentará a mensagem
...
"ORDEM DE SERVIÇO INTEGRADA COM
...
SUCESSO", conforme imagem abaixo. Neste momento o domínio da O.S. passa para o XENTRY.
...
OFIC1400
Quando uma Ordem de Serviço está no domínio do DMS, devido à uma operação TransferJobToDMS, o usuário poderá incluir ou excluir peças na O.S.
Ao requisitar ou estornar a requisição de peças, o sistema irá solicitar ao usuário:
...
"Deseja enviar esta Ordem de Serviços ao Portal XETRY?
...
"
Caso afirmativo, a Ordem de Serviço será enviada para o XENTRY através da operação TransferJobToASM. Neste momento o
...
"domínio" da O.S. será transferido para o Portal XENTRY, e como consequência o DMS não poderá fazer nenhuma modificação na mesma, até recebe-la novamente através do TransferJobToDMS.
OFIC1570
Quando uma Ordem de Serviço está no domínio do DMS, o usuário poderá incluir ou excluir serviços na O.S.
Após terminar de incluir os serviços necessários na O.S., o sistema irá solicitar ao usuário:
...
"Deseja enviar esta Ordem de Serviços ao Portal XETRY?
...
"
Caso afirmativo, a Ordem de Serviço será enviada para o XENTRY através da operação TransferJobToASM. Neste momento o
...
"domínio" da O.S. será transferido para o Portal XENTRY, e como consequência o DMS não poderá fazer nenhuma modificação na mesma, até recebe-la novamente através do TransferJobToDMS.
OFIC3500
Para faturar a O.S. o DMS deverá recebe-la do Portal através da operação TransferJobToDMS. Após a transferência, a nota fiscal de venda desta O.S. poderá ser emitida, e após isso será enviado o serviço FinishJob, indicando ao Portal que os trabalhos relacionados à esta Ordem de Serviço foram finalizados.
...
Consultas
ORDEM DE SERVIÇO
OFIC1200
Se a filial estiver integrada com o XENTRY (CADA0900), este programa disponibilizará uma opção de menu chamada
...
"Portal XENTRY"
Esta opção abrirá uma tela simples para mostrar os dados da OS que são relevantes para o consultor saber a situação atual da OS:
...
Código Portal XENTRY:
...
é o número mundial único que a MBB atribui à um
...
"Job" de Ordem de Serviço enviada ao Portal XENTRY.
Localização Atual:
...
é onde está o domínio da OS após cada operação, sendo:
InitJob, GetPrices, TransferJobToAsm
...
e FinishOrder
...
a O.S. está no domínio do Portal. Neste estado será habilitado na tela o botão
...
"Portal", que irá abrir o XENTRY através do browser, acessando automaticamente a Ordem de Serviço.
TransferJobToDms
...
a O.S. está no domínio do DMS. Neste estado o botão
...
"Portal" não aparece.
Última Operação:
...
informa qual foi a última operação de comunicação (Web Service) feita com sucesso para essa OS.
...
Alteração de local do documento
ORDEM DE SERVIÇO / PRÉ-OS / ORÇAMENTO
XENT1000
Poderão ocorrer situações em que será necessário
...
"forçar" a mudança de status de um documento (O.S., PRÉ- O.S. ou Orçamento), mudando-o do Portal para o DMS SEM utilizar o
...
"Transfer Job to
...
DMS".
O Portal XENTRY já possui um recurso para mudar o status de uma O.S. que está no portal, para que a mesma fique sob o domínio do DMS. Para executar a mesma operação no DMS, utilize a função
...
"Local" do XENT1000, conforme figura abaixo:
...
Após informar a filial, o tipo e o número do documento, o sistema irá mostrar onde ele está.
...
Ao clicar em altera, o sistema exibirá a mensagem de confirmação:
...
Ao confirmar a transferência, o controle do documento passará para o DMS. O usuário poderá trabalhar normalmente com ela, efetuando as modificações necessárias para depois transferi-la novamente para o Portal XENTRY.