Configuração da Comunicação da API com o Autoservice+ VW.

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 

2. Tipos de Serviço

Acesse o Menu Apollo > 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 > Oficina > Cadastros > Tipo de Serviço

                            Figura 3: Apollo > 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 > 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 > Faturamento >  Cadastros > Categoria de Cliente no AutoService

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

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

Acesse Apollo > 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" a cada nova promoção cadastrada, com o código disponibilizado pela Montadora.

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

5. Comunicação da API com Montadora

Acesse FabricaVW > Parâmetros > Autoservice+ 

Para iniciar a comunicação automática da API é necessário marcar a opção "Habilita Integração AutoService +" por revenda.

5.1. Clique na Aba Integrações.

Os campos " Usuário para Notificações" e "Data e Hora do Último Envio"  se repetem para todos os tipos de envio , são especificamente para:

• Usuário para notificações :  Determinar um ou mais usuários que receberão correio interno com as notificações de erro referentes a seus respectivos registros. 
• Data/hora ultimo envio : Exibe a data/ hora do último envio realizado pela API e a partir de qual data/hora serão selecionados os registros para comunicação, podendo ser editada para gerar um envio com data/hora  retroativa.

Figura 7:  Usuário Notificado > Correio Interno

• 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.

• Dia do Mês para Envio:  Informe a data em que o registro ck5 deverá ser enviado para o AutoService, deverá ser transmitido uma única vez ao mês.

• 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.

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

5.2 . Aba Parâmetros:

• URL API : URL que será usada para envio das informações : http://hml-eapi-samip-autoservice.us-e2.cloudhub.io/v1/

• URL Token  : URL que será usada obter o token : https://idp-qa.vw.com.br/realms/kums-mfa/protocol/openid-connect/token

• Intervalo de Integração : Determina o intervalo de tempo em minutos em que será ativado o envio automático. (mínimo de 2 e máximo de 120 minutos)

Figura 9: FabricaVW > Parâmetros > Autoservice+ > Aba Paramêtros 

5.3 Envio das informações.

A API será ativada automaticamente conforme o tempo determinado em FabricaVW > Parametros aba Autoservice+, campo Intervalo de integração:

Figura 10: FabricaVW > Parâmetros > Autoservice+ > Aba Paramêtros > Intervalo de Integração

ck3 - Notas Fiscais de Peças no Balcão

Sempre que uma nota fiscal for emitida para um departamento cuja identificação seja igual a balcão será enviada para API o registro ck3 - Notas Fiscais de Peças no Balcão .

A fonte pagadora será preenchida conforme a categoria do cliente.

Figura 11: FabricaVW > Parâmetros > Autoservice+ > Aba Paramêtros > Identificação

ck4 - Cancelamento da NF ou OS

As informações de notas canceladas serão enviadas sempre que uma nota for cancelada através do menu => Apollo > Faturamento > Consultas > Operações Fiscais.

ck5 - Estrutura Física do DN

Os dados para envio devem ser registrados manualmente através do menu FabricaVW > Cadastros > Manutenção Estrutura DN Autoservice (CK5)

Figura 12: FabricaVW > Cadastros > Manutenção Estrutura DN Autoservice (CK5)

As informações serão enviadas no dia informado nos parâmetros da API no menu : FabricaVW > Parametros aba Autoservice+ .

Caso este parâmetro esteja igual a zero, será enviado no ultimo dia de cada mês. 

ck6 - Ordens de Serviços de Peças e Serviços na Oficina

Toda vez que uma ordem de serviço for gerada a fonte pagadora será preenchida automaticamente conforme a categoria de cliente e tipo de serviço informado.

As informações referente as O.S. serão enviadas para API, sempre que houver alguma alteração no seu conteúdo, desde a sua emissão até o encerramento.

ck7 - Notas Fiscais de Peças e Serviços na Oficina

As notas serão enviadas após sua emissão no frente de caixa.

NFe - Espelhos das Notas Fiscais

O XML será enviado após sua emissão no frente de caixa.

Todas as transmissões serão registadas em um log e será enviado um correio interno para o usuário determinado nos parâmetros.

6. Cadastro de Clientes - Autorização de contato e pesquisa.

Sempre que for aberto um atendimento (balcão ou oficina) será necessário atualizar os dados de autorização de contato e pesquisa do cliente.

Acessar o Cadastro do cliente > Alteração através da opção "Cadastro do Cliente".

Figura 13: Atendimento Balcão de Peças

Na Manutenção dos Clientes , acesse a Aba Autoservice VW e  informar as preferencias de contato do cliente.

Figura 14: Manutenção de Clientes > Comunicação AutoServce VW

7. Retransmitir as Informações para a API.

Através do  menu FabricaVW > Consulta Log Transmissão AutoService, é possível acompanhar todas as transmissões realizadas e seus status.

Em caso de erro no envio, é possível marcar o registro para retransmissão através da Opção " Retransmitir" .

Após selecionar o registro clique em "Salvar".

O Registro ficará com o Status de "Envio Pendente" e será transmitido no próxima comunicação conforme tempo parametrizado nas configurações do Autoservice.

Figura 15: FabricaVW > Montadora > Consulta Log Transmissão Autoservice

7.1. Consulta Log Integração.

Através do  menu LinxDMS Web > Configurações > Consulta > Consulta Log Web é possível acompanhar todas as transmissões realizadas e seus status.

Preencha o campo 'Processos" com "Integração Autoservice VW", pode ser informado os demais filtros e clique em  "Pesquisar".

Figura 16: LinxDMS Web > Configurações > Consulta > Consulta Log Web

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.