Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Implementação do novo processo de envio dos dados do Autoservice para a Montadora através de uma API. |
Produto | Fábrica VW |
---|---|
Menu | FabricaVW > Parâmetros > Autoservice+ |
Data | 26122023 |
Área | P&D |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
O projeto consiste na implementação do processo de comunicação do Autoservice através de uma API cuja transmissão será realizada automaticamente. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Este programa destina-se a todas as concessionárias das marcas VW. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
É necessário atualizar o LinxDMS Web com a última versão disponível no DVI. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
1. Fonte PagadoraAcesse 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çoAcesse 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 ClienteAcesse 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çãoAcesse 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" disponibilizado pela Montadora a cada nova promoção cadastrada, com o código disponibilizado pela Montadora. que for lançada. Figura 6: Apollo > Peças > Gerenciamento de Estoque > Promoção > Seleção de itens para promoção 5. Desativação do Autoservice AutomáticoFigura 7: Fabrica VW > Processos > Rede-Fabrica - Montagem do Arquivo p/Transmissão 5.1.Autoservice + desativadoFigura 8: Desativação Autoservice Figura 9: Montagem arquivo para transmissão como Autoservice Desativado 5.2. Autoservice + ativadoFigura 10: Ativação Autoservice Figura 11: Montagem arquivo para transmissão como Autoservice Ativado 6. Comunicação da API com MontadoraAntes de ativar a comunicação pelo novo sistema Autoservice+ observem as seguintes vpremissas e êpontos de atenção:
6.1 Acesse FabricaVW > Parâmetros > Autoservice+ Para iniciar liberar a comunicação automática da API inicialmente é necessário marcar a opção "Habilita Integração AutoService Autoservice +"por revenda.5.1. . Figura 12: FabricaVW > Parâmetros > Autoservice+ > Aba Integrações Clique na Aba Integrações.Os campos Figura 13: FabricaVW > Parâmetros > Autoservice+ > Aba Integrações O campo "Usuário para Notificações" e "Data e Hora do Último Envio" se repetem se repete para todos os tipos de envio , são especificamente para: Usuário para notificações : Determinar(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 aaos seus respectivos registros . Data/hora ultimo envio : Exibeconforme 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 e. 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/ horahora retroativa. Figura 7: Usuário Notificado > Correio InternoATENÇÃO: no layout ck5 existe uma regra diferente para a data, conforme explicado abaixo. Os demais campos tem as seguintes funções:
É 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:
Figura 815: FabricaVW > Parâmetros > Autoservice+ > Aba Integrações 5.2 . Aba Parâmetros:Parâmetros
URL API : URL que será usada para envio das informações : http://hml-eapi-samip-autoservice.us-e2. cloudhub.io/v1/URL TokenToken : URL que será usada obter o token : https://idp-qa.vw.com.br/realms/kums-mfa/protocol/openid-connect/tokende conexão. Estes dois campos não são editáveis pelo usuário. 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êtros5.3 Envioque serão feitos os envios dos dados que tiveram alguma modificação desde a última transmissão. No momento da implantação pode ser deixado entre 2 e 5 minutos. Após a carga histórica deve ser configurado para 120 minutos (2 horas) de forma que os envios não consumam desnecessariamente os recursos de comunicação.
6.3. Fluxos dos 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çãoa cada 2 horas conforme foi determinado no parâmetro “Intervalo de Integração” fazendo a leitura da base de dados e transmitindo todas as informações que tiveram alguma alteração em relação à última transmissão efetuada. Os registros que tiverem algum tipo de erro não são enviados e vão automaticamente para o Log de monitoramento de erros e geram o aviso para o responsável no correio interno. A cada novo ciclo de transmissão os erros que tiverem sido corrigidos serão automaticamente transmitidos, pois estarão gravados na base de dados com uma data/hora diferente da original.
Os layouts transmitidos obedecem aos mesmos padrões do sistema antigo e portanto não exigem nenhuma alteração no fluxo dos processos de oficina e venda de peças balcão:
16: FabricaVW > Parâmetros > Autoservice+ > Aba ParamêtrosParâmetros > Identificação
Figura 12: FabricaVW > Cadastros > Manutenção Estrutura DN Autoservice (CK5)
Figura 17: FabricaVW > Cadastros > Manutenção Estrutura DN Autoservice (CK5)
7. Cadastro de Clientes - Autorização de contato e pesquisa.SempreEm função das exigências da LGPD, 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. Estes dados do DMS agora são transmitidos para a Volkswagen e serão consumidos pelas áreas e atividades que envolvam contato com os clientes, incluindo-se as pesquisas de satisfação. Acessar o Cadastro do cliente > Alteração através da opção "Cadastro do Cliente". Figura 1318: Atendimento Balcão de Peças Na Manutenção dos Clientes , acesse a Aba Autoservice VW e informar e informe as preferencias preferências de contato do cliente.
8. Retransmitir as Informações para a API.Através do do menu FabricaVW > Consulta Log Transmissão AutoService, é possível Autoservice os usuários das áreas de negócios poderão acompanhar todas as transmissões realizadas e seus status. Em caso de erro no envio , é possível marcar o identificar o registro que precisa ser corrigido, fazer a correção e depois marcar este registro para retransmissão através da Opção " Retransmitir". Após selecionar o registro clique em "Salvar". O Registro ficará registro ficará com o Status de "Envio Pendente" e será transmitido no automaticamente na próxima comunicação conforme tempo parametrizado nas configurações do Autoservicejanela de comunicação. Figura 1520: FabricaVW > Montadora > Consulta Log Transmissão Autoservice 7.19. Consulta Log Integração.Através do do menu LinxDMS Web > Configurações > Consulta > Consulta Log Web é possível os usuário de TI do concessionário podem acompanhar todas as transmissões realizadas e seus status em relação às questões de comunicação e funcionalidade do sistema. Preencha o Selecione no campo 'Processos" com a opção "Integração Autoservice VW" , pode ser informado e, se desejado, defina os demais filtros e clique em em "Pesquisar".
Figura 16:21 LinxDMS Web > Configurações > Consulta > Consulta Log Web 7.2. Reenvio de nota fiscal.Através do menu Bravos > Faturamento > Nota Fiscal > Reemissão de Notas Fiscais ao reemitir a nota fiscal será apresentada a pergunta se deseja retransmitir ao autoservice + Figura 17: Tela com a pergunta para retransmitirObservação : a pergunta será apresentada apenas para usuários que estejam na relação de usuários para notificações de cada CK e se a nota não estiver gravada no log detalhadoDÚVIDAS 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. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
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. |