Histórico da Página

Implementação do novo processo de envio dos dados do Autoservice para a Montadora através de uma API.

O projeto consiste na implementação do processo de comunicação do Autoservice através de uma API cuja transmissão será realizada automaticamente.

Este programa destina-se a todas as concessionárias das marcas VW.

É necessário atualizar o LinxDMS Web com a última versão disponível no DVI.

 1. Fonte Pagadora 

Acesse o Menu FabricaVW > Cadastros > Fonte Pagadora  Autoservice

É necessário revisar os códigos cadastrados e atualiza-los de acordo com a planilha disponibilizada pela Montadora com os novos códigos para uso no API do Autoservice Plus.

Figura 1: FabricaVW > Cadastros > Fonte Pagadora  Autoservice 

Figura 1.1 : Fonte Pagadora  Autoservice 

2. Tipos de Serviço

Acesse o Menu Apollo Linx DMS > Oficina > Cadastros > Tipo de Serviço

Criamos um novo campo 'Fonte Pagadora' que deverá ser vinculado ao Tipo de Serviço.

Ao abrir uma Ordem de Serviço será verificado a Fonte Pagadora vinculada ao tipo de serviço, sendo automática a sua seleção.

                                     Figura 2: Apollo Linx DMS > Oficina > Cadastros > Tipo de Serviço

                            Figura 3: Apollo Linx DMS > Oficina > Cadastros > Tipo de Serviço > Fonte Pagadora

2.1. De Para das atuais fontes pagadoras disponíveis no LinxDMS para as novas fontes pagadoras criadas para o uso na API do AutoService. (Disponibilizado pela Montadora).

OBS:  Revisar os códigos de fonte pagadora em cada revenda.

Figura 3.1 : Planilha de Novas Fontes Pagadoras Disponibilizada pela VW ( Versão1.0.0 - Data 01/02/2023)

3. Categoria de Cliente

Acesse Apollo Linx DMS > Faturamento >  Cadastros > Categoria de Cliente 

O campo " Categoria do Cliente no AutoService"  deverá ser informado de acordo com a tabela de fonte pagadora disponibilizada pela VW.

Ao realizar um venda balcão,  verificamos no cadastro do cliente qual a fonte pagadora que deverá ser utilizada.

Figura 4: Apollo Linx DMS > Faturamento >  Cadastros > Categoria de Cliente no AutoService

Figura 5: Apollo Linx DMS > Faturamento >  Cadastros > Categoria de Cliente > Fonte Pagadora

4. Seleção de Itens Para Promoção

Acesse Apollo Linx DMS > Peças >  Gerenciamento de Estoque  > Promoção > Seleção de itens para promoção  

Será necessário preencher o campo "Código do Fabricante" com o " Código Promoção VW" disponibilizado pela Montadora a cada nova promoção que for lançada.

Figura 6: Apollo Linx DMS > Peças >  Gerenciamento de Estoque  > Promoção > Seleção de itens para promoção 

5. Desativação do Autoservice Automático 

Após a ativação do processo de comunicação automática com o Autoservice +  através do menu FabricaVW > Parâmetros > Autoservice+ > Aba Integrações, 

o processo utilizado pelo menu Fabrica VW > Processos > Rede-Fabrica - Montagem do Arquivo p/Transmissão será desativado. 
Desse modo os registros não poderão mais ser criados e enviados pelo RVS/SIA.

Figura 7:  Fabrica VW > Processos > Rede-Fabrica - Montagem do Arquivo p/Transmissão 

5.1.Autoservice + desativado

Através do Menu FabricaVW > Parâmetros > Autoservice+ > Aba Integrações ( Figura 8) , se o parâmetro " Habilita Integração Autoservice + " não estiver marcado , o processo automático está desativado, possibilitando o envio através do processo antigo  através do Menu Fabrica VW > Processos > Rede-Fabrica - Montagem do Arquivo p/Transmissão ( Figura 9).

Figura 8:  Desativação Autoservice

Figura 9:  Montagem arquivo para transmissão como Autoservice Desativado 

5.2. Autoservice + ativado

Através do Menu FabricaVW > Parâmetros > Autoservice+ > Aba Integrações, se o parâmetro " Habilita Integração Autoservice + " estiver marcado ( Figura 10) , o processo antigo utilizado através do Menu Fabrica VW > Processos > Rede-Fabrica - Montagem do Arquivo p/Transmissão ( Figura 11) estará inativo, não sendo mais visualizado.

Figura 10:  Ativação Autoservice

Figura 11:  Montagem arquivo para transmissão como Autoservice Ativado

6. Comunicação da API com Montadora

Antes de ativar a comunicação pelo novo sistema Autoservice+ observem as seguintes premissas e pontos de atenção:

• Quando o novo Autoservice+ for ativado, automaticamente o sistema antigo será desativado. Deste modo os registros não poderão mais ser criados e enviados pelo RVS/SIA.
• O mês corrente a partir da ativação já será processado com os dados do novo sistema e os indicadores do Portal Autoservice serão atualizados automaticamente a partir desta nova fonte.
• Para que o movimento completo do mês atual onde a implantação do novo sistema Autoservice+ está sendo feita seja enviado para a VW é necessário definir a data/hora retroativa da carga dos dados para o dia “1” do mês anterior.
  Assim garantimos que o fechamento do mês irá considerar todos os dados do período.
• A ativação deve ser disparada num horário em que as movimentações do concessionário não estejam sendo feitas (abertura de OS’s, faturamentos, cancelamentos, etc.) como por exemplo após o horário de expediente.
  Isto é recomendado pois haverá a carga histórica dos dados desde o 1º dia do mês e as novas movimentações da base podem causar algum erro.
• Após a ativação estar completa o concessionário não precisa mais monitorar o indicador “Frequência diária de envio” no Portal Autoservice. As transmissões serão feitas de forma totalmente automática e em janelas regulares a cada 2 horas após a última transmissão.
• Também não será mais necessário monitorar os erros de envio do Autoservice+ no RVS/SIA pois as devolutivas de erro ocorrem automaticamente no mesmo momento da transmissão e são tratadas em um novo menu exclusivo de monitoramento, explicado mais adiante.
• As etapas a seguir deverão ser repetidas para cada revenda do seu grupo.

6.1 Acesse FabricaVW > Parâmetros > Autoservice+

Para liberar a comunicação automática da API inicialmente é necessário marcar a opção "Habilita Integração Autoservice +".

Figura 12: FabricaVW > Parâmetros > Autoservice+ > Aba Integrações

Clique na Aba Integrações.

Figura 13: FabricaVW > Parâmetros > Autoservice+ > Aba Integrações

O campo "Usuário para Notificações" se repete para todos os tipos de envio (layouts) e é utilizado para determinar um ou mais usuários do DMS que receberão um correio interno com as notificações de erro referentes aos seus respectivos registros conforme exemplo abaixo.

Figura 14: Usuário Notificado > Correio Interno

O campo "Data e Hora do Último Envio" se repete para todos os tipos de envio (layouts) e é utilizado para controlar a data/ hora do último envio realizado pela API.

Exclusivamente no momento da implantação este campo será utilizado para definir a partir de qual data/hora serão selecionados os registros para comunicação da carga histórica, podendo ser editada para gerar um envio com data/hora retroativa.

ATENÇÃO: no layout ck5 existe uma regra diferente para a data, conforme explicado abaixo.

Os demais campos tem as seguintes funções:

• Envia ck3 - Notas Fiscais de Peças no Balcão : Ativa o envio do tipo de registro ck3, que contém as Notas Fiscais de vendas de peças no Varejo (Venda Balcão)
• Envia ck4 - Cancelamento da NF ou OSC : Ativa o envio do tipo de registro ck4, que contém as Notas Fiscais e as Ordens de Serviços já transmitidas e que foram canceladas.
• Envia ck5 - Estrutura Física do DN : Ativa o envio do tipo de registro ck5, que contém as informações sobre a capacidade instalada, estrutura física e do Pessoal (colaboradores) do concessionário.
  ATENÇÃO: No layout ck5 não é preciso colocar uma data para carga histórica. Informe a data em que cada concessionário costuma enviar o seu registro ck5, pois estes dados são transmitidos uma única vez ao mês. Esta data é definida pelo DN conforme sua conveniência em relação às movimentações de pessoal no time da Oficina.
• Envia ck6 - Ordens de Serviços de Peças e Serviços na Oficina : Ativa o envio do tipo de registro ck6, que contém as Ordens de Serviço ou Orçamentos gerados na Oficina a pedido do Cliente.
• Envia ck7 - Notas Fiscais de Peças e Serviços na Oficina : Ativa o envio do tipo de registro ck7, que contém as Notas Fiscais geradas através das Ordens de Serviço aprovadas pelo cliente no Registro ck7.
• Envia NFe - Espelhos das Notas Fiscais : Ativa o envio do tipo de registro NFe, que permite enviar o cancelamento de uma peça específica de uma Nota Fiscal ou Ordem de Serviço já transmitidas.

É mandatório ativar todos os layouts e preencher todos os campos "Data e Hora do Último Envio" para que as cargas históricas sejam feitas igualmente em todos os layouts, mas ainda NÃO CLIQUE em “Aplicar” ou “OK” pois existem mais parâmetros para configurar na outra aba deste menu.

6.2. Aba Parâmetros:

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.