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 | |
Área | P&D |
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://eapi-samip-dms-autoservice.us-e2.cloudhub.io/v1/
- Client ID e Client Secret : Preencher com as informações fornecidas pela Montadora, para cada DN.
- 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).
- Data/Hora Último Envio : Usado para calcular o intervalo da integração. Serão enviadas as informações a partir desta data/hora até da data atual. Será atualizada automaticamente a cada envio.
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 > Montadora > 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.