Índice
Índice
Assunto
Manual do processo de integração com o PPSo para bandeiras VW e Audi.
Abrangência
Todas as revendas que queiram utilizar o PPSo integrado ao Linx DMS Apollo/BRAVOS.
Aplicação
Antes de configurar a aplicação é necessário requisitar um certificado específico para o PPSo. Consulte o IT_MASS19_Solicitacao_Certificado PPSo no Portal da Rede VW, caminho "Assist. Técnica - Sist. e Info de Serviços – Sist. De Serviços" para as instruções de obtenção do certificado e a sua senha, junto a Volkswagen. Ou, se a bandeira for Audi, consulte a área de negócios de pós vendas, aos cuidados de Alline Ferreira através do e-mail [email protected].
Este certificado precisa ser salvo e estar disponível numa pasta compartilhada da sua estrutura de rede de dados. Para revendas que utilizam o Linx DMS Apollo/BRAVOS em 3 camadas, este certificado precisa estar disponível apenas no lado server. Para as demais revendas, o certificado precisa estar disponível para cada usuário que irá utilizar o PPSo.
No 3 camadas, os certificados precisam estar em uma pasta visível ao FabricaServerApp/FabricaVWServerApp e ao ApolloServerApp.exe. Não é necessário que nenhum DN (aplicativo client) tenha acesso direto ao certificado. Outro ponto é que os certificados não precisam ser instalados em nenhum local, apenas os arquivos dos certificados de todos os DNs devem estar visíveis para o servidor 3 camadas. Cada DN irá configurar os dados do seu certificado no Fábrica/FábricaVW.
Ainda no 3 camadas, o caminho do arquivo do certificado PPSo não tem porque ser compartilhado ou ser de rede, o recomendado é que esteja no próprio servidor 3 camadas, já que só o servidor 3 camadas precisa ter acesso a ele. Depois basta colocar todos os arquivos de certificado, de todos os DNs nesta pasta. Caso o FabricaServerApp/FabricaVWServerApp e o ApolloServerApp rodem em máquinas diferentes, basta criar a mesma estrutura de pasta (caminho dos certificados) nas duas máquinas e copiar os certificados para estas pastas, deixando os mesmos nas duas máquinas.
Após ter copiado o certificado do PPSo para uma pasta que atenda as especificações acima, é necessário parametrizar o PPSo. Para isso, acesse "Fábrica> Audi> Parâmetros", aba "PPSo". Ou acesse "Fábrica VW> Parâmetros", aba "PPS".
Importante: O nome do arquivo do certificado precisa ser exatamente igual ao <User login> fornecido pela Volkswagen/Audi, respeitando inclusive maiúsculas e minúsculas. Exemplo: Se o <User login> é SBR00001DM2, o nome do arquivo precisa ser SBR00001DM2.p12. Neste exemplo, caso o nome do arquivo estiver como sbr00001dm2.p12, a consulta ao PPSo não vai funcionar.
Para utilizar a integração com o PPSo, é necessário habilitar o "TLS 1.2". Para isso, é necessário entrar nas propriedades da internet:
Figura 1: Pesquisar > Propriedades de Internet
Acesse a aba "Avançadas" e marque "Usar TLS 1.2".
Figura 2: Propriedades de Internet
Clique em "OK" para confirmar a configuração.
Para habilitar o uso, é necessário acessar o menu "Fábrica> Audi> Parâmetros" e, na aba "PPSo", clicar no botão OFF:
Figura 3: Manutenção de Parâmetros Audi
Ou acessar o menu "Fábrica VW> Parâmetros" e, na aba "PPS", clicar no botão OFF:
Figura 4: Manutenção de Parâmetros VW
Após isso, a tela ficará conforme abaixo, onde será necessário preencher as informações:
Figura 5: Manutenção de Parâmetros Audi
Figura 6: Manutenção de Parâmetros VW
No campo "Webservice PPS" deve ser informado https://esb01.skoda-auto.com/ppso/ppsoservice. Os dados de certificado e senha são os mesmos obtidos no início deste processo de configuração. Os demais parâmetros são utilizados no processo de cadastro de serviços/mão-de-obra do PPSo (caso algum serviço retornado pelo PPSo não estiver cadastrado no sistema, ele será cadastrado automaticamente utilizando estes parâmetros).
Obs.: Caso a máquina esteja utilizando firewall, é necessário liberar os endereços abaixo nas suas regras:
https://esb01.skoda-auto.com/ppso/ppsoservice
http://dms-appvwleads01.eastus.cloudapp.azure.com:8080/LinxPPSo/LinxISAPIPPSo.dll/soap/LinxPPSo
Não é necessário instalar o certificado, basta apenas ter o arquivo e informar os dados corretamente nos parâmetros do Fábrica.
Após realizar estas parametrizações, é necessário registrar a dll capicom.dll (Esta dll normalmente está dentro da pasta do Linx DMS Apollo/BRAVOS. Caso a revenda não tenha este arquivo, basta solicitá-lo junto a Linx). Para isso, execute o prompt do DOS como administrador e rode o comando abaixo, alterando se necessário o caminho onde está a dll.
Regsvr32 c:\apollo\capicom.dll
Figura 7: Administrador: Prompt de Comando
Para revendas que utilizam o Linx DMS Apollo/BRAVOS em 3 camadas, o registro desta dll precisa ser feito apenas no lado server. Para as demais revendas, deve ser feito na máquina de cada usuário que irá utilizar o PPSo.
Além de registrar a capicom, também é necessário copiar para o servidor 3 camadas o arquivo LinxPPSo.bpl (caso a revenda utilize 3 camadas) e para a pasta do Linx DMS Apollo/BRAVOS o arquivo LInxPPSo.dll (caso a revenda não utilize 3 camadas).
Neste ponto, é importante realizar o teste de comunicação com o PPSo. Para isso, basta clicar no botão <Teste>, na tela de parâmetros do Fábrica/FábricaVW.
Figura 8: Manutenção de Parâmetros VW – Botão Teste
Neste momento será realizado um teste de comunicação. Ao final do teste, será exibido o retorno em uma nova tela.
Abaixo segue a tela de retorno OK. Repare como vem um padrão xml definido e alinhado.
Figura 9: Teste de Comunicação PPSo – Retorno OK
Abaixo exemplo de tela de retorno de erro do certificado. Repare como a informação não vem alinhada e chega ser difícil a identificação do problema. Isso ocorre porque o PPSo, em caso de erro de acesso negado ao certificado, retorna um erro em html e não em xml.
Figura 10: Teste de Comunicação PPSo – Retorno com erro
Como afirmado acima, este retorno pode vir em um formato diferente de xml, normalmente quando ocorre algum erro, o PPSo devolve a resposta em html.
Quando estes passos são feitos, o Fábrica/FábricaVW automaticamente grava o retorno em um arquivo, diretamente na pasta onde está o Fabrica.exe/FabricaVW.exe. Este arquivo segue o padrão de nomenclatura <TempHHMMSS.*>, onde HH é a hora, MM o minuto e SS o segundo em que o teste foi realizado. A extensão pode variar de acordo com o retorno, segue a regra para a gravação da extensão:
Arquivo.xml - O Fábrica/FábricaVW sempre tenta primeiro salvar em xml, se não conseguir, aí passa para a segunda opção (nos casos do formato retornado não ser um xml, o Fábrica/FábricaVW não conseguirá salvar em xml).
Arquivo.txt – Caso o Fábrica/FábricaVW não consiga salvar em xml, salvará em txt.
Por via de regra, sempre que gravar este arquivo com extensão txt, este arquivo deve ser enviado para o suporte responsável. Este arquivo é a evidência de que o acesso ao PPSo não está funcionando. Nele consta o retorno de erro do PPSo, permitindo a análise da causa pelo suporte.
Abaixo será apresentado o parâmetro Usar Preço Site Volkswagen, para utilizar é necessário acessar a tela de parâmetros do Fábrica/FábricaVW.
Figura 11: Integração PPS x BRAVOS
A Opção Usar Preço Site Volkswagen foi criada para possibilitar que as concessionárias trabalhem com o preço das Peças e Serviços conforme o preço de Site da Montadora. Ao marcar essa opção nos parâmetros, não será possível modificar o tipo de consulta durante a operação. Se não for marcada a opção, será possível a modificação do tipo de Preço durante consulta.
É necessário realizar a configuração de um novo campo criado na Política de Preço da oficina, onde será a referência para o preço de Serviço utilizado pela montadora. Acesse o menu Oficina / Cadastro / Política de Preço.
Figura 12: Integração PPS x BRAVOS
Na Política de Preço da Oficina foi criado o Parâmetro <Preço Site Volkswagen PPSO>, para que seja possível a concessionara definir o preço praticado pela montadora.
Uma vez que o teste do PPSo tenha retornado o xml de OK, já é possível acessar o PPSo pelo sistema. Para isso, basta clicar no botão "PPS", disponível nas telas "Requisição de Itens para Ordem de Serviço", "Manutenção da Agenda da Oficina" e "Atendimento Oficina".
Ao clicar no botão "PPS", será automaticamente realizada uma consulta ao chassi do Atendimento/OS atual. Porém, também é possível ir para a aba "Filtro" e realizar uma busca por outro chassi ou até por parâmetros (Modelo de Serviços, Modelo de Veículos, Motor, Combustível, Câmbio, Data Fabricação, Econômico, Categoria, Ano Fabricação e Ano Modelo). Segue abaixo a tela de filtros disponíveis no PPSo.
Figura 13: Integração PPS x BRAVOS
Esta tela está dividida em duas buscas principais:
- Busca por Chassi: É a busca principal, que é realizada automaticamente ao clicar no botão "PPS", buscando os pacotes do PPSo disponíveis para o chassi do Atendimento/OS;
Obs.: Caso o chassi consultado não esteja cadastrado na ficha de seguimento e for do modelo Amarok, é necessário marcar a opção <Amarok> para realizar a busca dos dados do PPSo.
- Busca por Parâmetros: É a busca realizada por características do veículo, como modelo, motor e combustível.
Por fim, ao marcar a opção "Grava Log", toda a busca de dados, sendo do banco de dados ou do webservice do PPSo, irá gravar um arquivo xml no formato LogPPS????????????????????.xml. Este arquivo será gravado na pasta configurada no campo "Diretório Arquivos", disponível em "Configuração > Cadastros > Empresas e Revendas", aba "Arquivos".
Segue um descritivo dos botões disponíveis nesta tela:
- Consultar: Realiza a busca dos pacotes PPSo. Essa busca segue uma regra específica, onde os dados só serão solicitados ao webservice do PPSo caso o mesmo chassi não tenha sido consultado em menos de 24 horas. Após a consulta o sistema irá gravar este retorno na base de dados da revenda. Caso o chassi já tenha sido consultado nas últimas 24 horas, os dados do PPSo serão buscados na base de dados da revenda;
- Limpar: Limpa todos os filtros da tela;
- Combustíveis: Cadastro De>Para de combustíveis. Este relacionamento deve ser feito manualmente pela revenda, após a carga de catálogos realizada pelo botão "Atualiza Catálogos":
Figura 14: De -> Para PPS
- Óleos: Cadastro De>Para de óleos. Este relacionamento deve ser feito manualmente pela revenda, após a carga de catálogos realizada pelo botão "Atualiza Catálogos":
Figura 15: De -> Para PPS
- Info. Sistema: Retorna os dados de informação do sistema PPSo;
- Atualiza Catálogos: Realiza a carga inicial e atualização dos catálogos do PPSo. Esse botão é mais utilizado para realizar a carga inicial durante a implantação desta funcionalidade, já que as demais atualizações, quando disponíveis, são feitas automaticamente ao realizar qualquer busca de pacotes ao PPSo;
- Fechar: Fecha a tela do PPSo.
A seguir está a tela de resultado da busca dos pacotes do PPSo:
Figura 16: Integração PPS x BRAVOS
Nesta tela é possível ver que todas as informações retornadas são agrupadas por pacote. Segue um descritivo das situações possíveis em cada item retornado pelo pacote:
- Os itens exibidos em preto são os itens que tem cadastro no sistema e tem estoque;
- Os itens em vermelho indicam que esta peça ou o óleo não estão previamente cadastrados na base do sistema. Informe o responsável por Peças para fazer o acerto da base. Os demais serviços serão cadastrados automaticamente na base.
- Observação: os novos códigos de serviços utilizados nos pacotes sempre serão atualizados automaticamente na base do sistema.
- Os itens em verde são peças que foram substituídas por outras peças (esta situação também só irá ocorrer para peças e óleos);
- Quando a peça não tiver estoque suficiente para atender a quantidade listada no pacote do PPS, é listado um asterisco
no final da descrição da peça;
- Também quando a peça não tiver estoque suficiente para atender a quantidade listada no pacote do PPS e ela possuir alguma peça alternativa vinculada que tenha o estoque necessário, é exibido o valor da peça alternativa na coluna "Peça Alternativa" e habilitado o CheckBox "Alt". Caso o usuário clique no CheckBox "Alt", o sistema irá copiar o valor da coluna "Peça Alternativa" para a coluna "Valor Unitário" e automaticamente recalcular o campo "Valor Total". Caso o usuário volte a clicar no CheckBox "Alt" desmarcando este CheckBox, o sistema irá fazer o processo inverso, voltando os valores que estavam anteriormente.
Os itens em negrito estão destacados, pois possuem a maior quantidade de peça em estoque.
Dessa forma, quando houver um item em negrito, significa que ele é o apropriado para ser incluso na pré-O.S. ou O.S..
Alguns pacotes repetem-se com o mesmo nome e conteúdo, pois as peças diferem-se por fornecedor. Veja que, no título do pacote, é apresentado o nome da peça que se repete.
Segue abaixo um exemplo de um destes casos:
Figura 17: Integração PPS x BRAVOS
Para a categoria de <Revisão>, serão exibidos somente os pacotes referente a solicitação incluída no atendimento/OS, conforme demonstrado na tela que segue:
Solicitação de revisão. Aqui irá aparecer somente os pacotes da solicitação de revisão.
Figura 18: Integração PPS x BRAVOS
Para a categoria de <Serviços complementares>, serão exibidos somente os pacotes que atendam uma determinada regra, definida pela VW/Audi, com base no modelo (model code), KM e tempo (o que ocorrer primeiro), de acordo com o plano de serviço. Conforme demonstrado na tela que segue:
Estes pacotes são exibidos conforme o modelo, KM e meses de uso do veículo.
Figura 19: Integração PPS x BRAVOS
Note que é fundamental a inserção manual da KM atual do veículo (Conforme figura 13), para que o sistema indique corretamente os pacotes que devem ser utilizados no serviço complementar. Ou seja, aparecerão todos os itens que devem ser obrigatoriamente incluídos no serviço.
Caso a categoria "Serviço Complementar" não apareça, significa que não há pacotes de serviço complementar para serem incluídos neste determinado serviço. As lógicas citadas só ocorrem para as categorias de Revisão (plano 10.000km/6 meses ou 10.000km/12meses) e Serviço Complementar.
Além de visualizar os dados dos pacotes PPSo, também é possível incluir um ou mais pacotes no Atendimento/OS. Segue abaixo a explicação desse processo.
A partir das solicitações inseridas na O.S. (item 1 - primeira revisão e item 2 - componentes da revisão), antes de clicar no botão "PPSo", selecione a linha dos componentes da revisão, e logo após clique no botão "PPSo".
Informe neste campo a Km Atual do veículo, para que os serviços complementares sejam exibidos corretamente. Na tela em que aparecer todos os pacotes do PPSo, é necessário associar a M.O. a classificação do item solicitado (ex: primeira revisão). Não é necessário associar as peças, conforme a tela e a explicação abaixo.
Figura 20: Manutenção da Agenda
No PPSo, é preciso expandir a composição do pacote no botão "+". Posicione o botão do mouse sobre a linha do serviço e clique com o botão direito do mouse para abrir o menu de solicitações. Feito isso, selecione a solicitação onde deseja incluir o serviço. Nas telas abaixo, alteramos a solicitação do serviço de 2 para 1. Repare que todos as peças/serviços já vieram associados a solicitação 2 (Componentes da Revisão), pois foi essa a solicitação que selecionamos antes de clicar no botão PPS. Então, só é necessário alterar as solicitações dos itens que devam ser incluídos em outra solicitação, que não é a selecionada antes de clicar no botão PPS.
Figura 21: Integração PPS x BRAVOS
Figura 22: Integração PPS x BRAVOS
Em seguida, clique com o botão direto do mouse na descrição do pacote e clique em "Inclui pacote no atendimento/OS".
Figura 23: Integração PPS x BRAVOS
Após clicar na opção "Inclui pacote no atendimento/OS", todos os itens deste pacote serão selecionados para inclusão e serão habilitados os botões "Confirmar" e "Cancelar", conforme imagem abaixo.
Após selecionar todos os pacotes necessários para cada solicitação, clicar no botão "Confirmar". Ao fazer isso, a tela do PPS será fechada e todos os itens de pacotes selecionados através da opção "Inclui pacote no atendimento/OS" e serão incluídos no atendimento/OS. Se o usuário clicar no botão "Cancelar", a tela do PPS será fechada e nenhum item será incluído no atendimento/OS:
Figura 24: Botões de confirmação da inclusão do pacote no atendimento/O.S.
Também é possível utilizar o botão Utilizar Preço Site VW, para que seja possível selecionar o preço site quando a revenda não utilizar o parâmetro já demonstrado. Assim quando o cliente solicitar o preço do site da Montadora e a revenda não utilizar o parâmetro, ainda terá como utilizar o processo sem a necessidade de acessar o menu de Configurações de Fábrica e realizar a configuração. Quando a revenda possuir o parâmetro marcado, o botão ficará desabilitado.
Figura 25: Manutenção da Agenda
Revisões e Serviços Complementares – Informações Adicionais
Para todos os grupos do PPSo, os pacotes retornados são baseados no modelo/chassi consultado. Porém, dois grupos do PPSo possuem filtros adicionais para o retorno dos pacotes. A seguir está a explicação de cada um destes grupos e dos filtros aplicados para os pacotes exibidos:
Revisão: Exibe todos os pacotes específicos da revisão lançada na solicitação da ordem de serviço/atendimento oficina.
Figura 24: Solicitações da ordem de serviço
Na figura 22, foi lançada a solicitação QUINTA REVISAO. Então, no PPSo, serão exibidos, no grupo <Revisão>, apenas os pacotes de revisão referentes a quinta revisão.
Figura 26: Pacotes de revisão
Serviços complementares: Exibe todos os pacotes de serviços complementares baseado em dados específicos do veículo, como data de venda, quilometragem e ano do modelo.
Figura 27: Pacotes de serviços complementares
Além das regras anteriormente citadas, ainda existe o filtro de <Condição adversa> válido para revisões e serviços complementares. Quando o veículo estiver marcado como <Condição Adversa> na ficha de seguinte, pacotes adicionais poderão ser exibidos no PPSo.
Figura 28: Condição adversa