Manual do Online Shop - Honda

Implementação do Projeto Online Shop Honda

Este documento tem a finalidade de explicar o funcionamento do módulo Online Shop Honda

Estes procedimentos destinam-se a todas as concessionárias da marca Honda que devem utilizar o processo Online Shop para visualização automatizada dos principais KPIs de peças Honda

O Online Shop é um sistema informativo de estoque de peças alinhado com a montadora, na qual as concessionárias Honda terão acesso.

O processo baseia-se no envio de informações da posição de estoque de peças atual das concessionárias. O envio das informações entre o DMS e a Montadora irá funcionar por 2 fluxos, sendo eles descritos abaixo:

• Sincroniza Estoque :  Estado atual do estoque para peças que já tiveram ou não alguma movimentação.
• Posição de Estoque : Movimentação das alterações de quantidade disponível em estoque.

O envio de dados principal será efetuado  de forma on line via Linx DMS Integrador, toda movimentação dos itens, seja ela de alteração cadastral, entrada, reserva, saída, ajuste e qualquer outra ação que altere a quantidade do item no estoque, é enviado a montadora.

Deste modo, é fundamental que o processo fique ativo e seja observado constantemente para que, qualquer situação seja rapidamente sanada para que o processo seja restabelecido e os envios sigam ocorrendo.  Como processo de apoio, o envio manual da Carga de estoque ou envios de itens individuais, podem ser realizados via Fabrica.exe conforme detalhamento abaixo.

O processo do Online Shop passa a ser o programa de  uso  em substituição ao Bi Parts.

CONFIGURAÇÃO DO FÁBRICA

Manutenção dos parâmetros da Honda

Menu: Fabrica.exe > Honda > Parâmetros

Para utilização da integração Online Shop, o parâmetro "Integra Online Shop" deverá estar marcado, liberando assim os campos restantes que estão nos grupos para parametrização.

• • Dados de Acesso

Aba Online Shop

^{Figura 1: Manutenção dos Parâmetros da Honda}

Parâmetros

• URL Comunicação (URL para consumo das APIs): Disponibilizada pela montadora
• API Key (Chave de acesso da API): Disponibilizado pela montadora
• Client ID (Usuário de acesso da API): Disponibilizado pela montadora
• Client Secret (Senha de acesso da API): Disponibilizado pela montadora
• Usuário para notificação da Integração: Selecione um usuário para o envio das notificações das comunicações das APIs disponibilizadas entre DMS e Montadora, caso seja necessária uma notificação

CONFIGURAÇÃO DO LINX DMS INTEGRADOR

• Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
• Acesse o menu "Configuração > Online Shop Honda";
• Na aba "Configuração", preencha os dados de acesso ao Banco de Dados;

^{Figura 2: Tela de configuração do Banco de Dados}

O campo "Permanência do log no Banco" controla a forma de gravação das informações do log.

Valores possíveis:

• Clique em "Testar Conexão"

Prosseguir somente se for apresentada a mensagem "Conexão com o Banco de Dados realizada com sucesso!". Caso não ocorra, verifique se os parâmetros informados são os mesmos utilizados pelo Linx DMS

• Clique em "Next"
• Na tela Online Shop Honda, clique em "Incluir"

^{Figura 3: Tela de configuração da comunicação}

• Preencha os dados para o acesso ao serviço

Opções disponíveis:

1. Nome: Nome do arquivo externo da configuração. Essa informação fica a critério da concessionária. Utilizar um nome que facilite a identificação;
2. Descrição: Descrição da configuração;
3. Log Detalhado: Indicativo para gravação do log detalhado no Banco de Dados;
4. Log de XML: Indicativo para gravação dos XMLs de comunicação no Banco de Dados;
5. Log de SQL: Indicativo para gravação dos comandos executados no Banco de Dados;

Importante:

1. O botão "Executar Manualmente" efetua a comunicação com a Montadora sem a utilização do serviço do Linx DMS Integrador.
2. Deve ser criada uma única configuração. Os DN's para comunicação serão obtidos através do parâmetro "Integra Online Shop" do Fábrica.
3. IMPORTANTE: o intervalo para esse processo se limita a 10 minutos, o recomendado é que seja indicado o  intervalo de tempo entre 1 ou 5 minutos.

O envio dos dados ocorrerá por lotes ou individualmente, isso depende do volume de dados de cada concessionária. Toda e qualquer movimentação dos itens será enviado á montadora então, é importante que  a montadora os receba tão logo ocorram e dentro do mesmo dia de movimentação. Se existirem muitos processos sendo executados no Linx DMS Integrador, é recomendado que esse processo seja instalado em um servidor onde possa ser executado sozinho.

• Grave as informações, clicando em "Salvar";
• Finalize as configurações, clicando em "Next" e depois em "Finish"

^{Figura 4: Tela de conclusão das configurações}

Dica: No caso de implantação do processo, antes de iniciar o serviço do Integrador,  envie uma Carga inicial via Webservice através do Programa Fabrica.exe.

• Reinicie o serviço do integrador

1. No Windows, pressione a tecla do logotipo do Windows + "R";
2. Digite services.msc e clique "Ok";
3. Localize e clique sobre o serviço "Linx DMS Integrador";
4. Clique em "Reiniciar Serviço";
5. Após este procedimento, o status do serviço deve continuar como "Em Execução".

^{Figura 5: Tela de serviços do Windows}

Observação :

Se o usuário tentar usar o processo antigo do Bi Parts Honda, será exibido uma mensagem:

^{Figura 6: Tela com a mensagem de desativação do BI Parts Honda}

UTILIZAÇÃO DO PROCESSO

O processo de envio dos dados dos itens ocorre de forma  automática via Linx DMS integrador,  a cada alteração que o item sofrer, será disparado á montadora, observar o tópico abaixo "Informações sobre o processo" para obter mais informações.

Como processo de apoio, deve ser utilizado o Processo manual de envio para Sincronização do Estoque.

• Processo Manual

Honda: Fabrica.exe > Fábrica > Honda > Linx DMS Integrador

Através desta tela, é possível gerar um envio de uma Carga Completa do estoque para a Montadora.  Poderá ser realizado o envio via Webservice, ou gerar um arquivo CVS que será salvo na pasta informado nos parâmetros da Empresa/Revenda logada. 

O Gerador apresenta a aba Online Shop, contendo os processos de comunicação disponíveis entre DMS-Montadora, "Sincroniza Estoque" e a Consulta dos Processos "Estoque Completo" e "Estoque individual".

^{Figura 7: Envio de Carga}

O log de comunicação e, ou, exportação é apresentado no botão "Consulta Log do Integrador", onde são apresentadas mensagens relevantes sobre os processos DMS-Montadoras realizados.

O Botão "Gerar arquivo de Log", gera um log texto contendo todas as movimentações de envio da Sincronização do Estoque realizada, este log será gerado na  mesma pasta onde está o executável do Fabrica.exe.  Poderá ser gerado mais de um log  dependendo da quantidade de registros enviados.

Esse log será salvo com o nome "Online Shop_xxxxxxxx.log  de acordo com a data de geração, pode ser utilizado principalmente para conferências de valores e saldo dos itens enviados, caso seja necessário tal validação junto a montadora.

SINCRONIZA ESTOQUE

Tem por objetivo gerar, ou enviar, a carga inicial da posição de estoque de peças por revenda, de itens que já tiveram ou NÃO alguma movimentação, são enviados á  montadora então,  todos os registros cadastrados ativos.

Serão enviados os dados relevantes a movimentação dos ítens

OBS:  São enviados lotes de 1000 peças até enviar todas as peças do estoque.

A sincronização do Estoque pode ser gerada por arquivo .CSV ou envida diretamente ao Web Service da Montadora. O arquivo .CSV sempre será gerado e salvo no diretório de saída configurado em

"Apollo.exe > Configuração > Cadastros > Empresas e Revendas > Aba "Arquivos" .

^{Figura 8: Opção de envio da Carga}

Ao clicar em arquivo CSV ou Webservice, é exibido uma barra de execução para acompanhamento da sincronização

^{Figura 9: Opção de envio da Carga - Barra de geração}

      Caso tenha sido feita a geração de arquivo .CSV, o arquivo terá como nome padrão "ONlineShop_Stock_YYYYMMDD.csv", sendo:

• YYYY: Ano da data atual, no formato de 4 dígitos numéricos
• MM: Mês da data atual, no formato de 2 dígitos numéricos
• DD: Dia da data atual, no formato de 2 dígitos numéricos

Exemplo: ONlineShop_Stock_20200325.csv

O arquivo .CSV gerado pelo botão "Sincroniza Estoque" não é enviado via Web Service. Devem ser seguidas as orientações dadas pela Montadora para dar prosseguimento no processo de Carga Inicial com o arquivo.

A geração da Carga Inicial via Web Service não gera arquivos, e já envia todos os dados para a Montadora conforme as configurações realizadas nos parâmetros.

Dica: No caso de uma geração do estoque completo via Webservice e o serviço do  Integrador estiver ligado, será "desligado" de forma automática o parâmetro "Integra Online Shop"  do Fabrica - aba Online Shop  da filial que está gerando os dados.  Ai final do envio da Carga, o parâmetro é acionado automaticamente novamente.

A geração da carga completa seja via Arquivo CSV ou Via Webservice, é indica que seja gerada fora do horário do expediente, de forma que, no momento de geração não esteja ocorrendo nenhuma movimentação de itens.

CONSULTA

Tem por objetivo consultar a Posição de Estoque de peças ou Demandas do Estoque, que já estão na base da Montadora.

^{Figura 10: Manutenção dos processos: Sincroniza Estoque e Consultas (Posição de Estoque e Demanda do Estoque)}

Quando utilizado a opção Estoque individual, também poderá ser enviado  o registro individualmente a montadora clicando no botão Sincroniza Estoque.

Após informar o código do item e clicar em Sincroniza Estoque, será gerado o alerta em tela:

^{Figura 11: Manutenção dos processos: Sincroniza Estoque e Consultas Individual}

Deve ser observado qual ação deseja tomar com relação ao envio, conforme descrito na mensagem. Selecionando o "Sim". será solicitado se deseja  enviar o registro individual via CSV ou Via Webservice:

^{Figura 12: Manutenção dos processos: Sincroniza Estoque e Consultas Individual}

 Selecionando a opção Webservice, será apresentada a mensagem após o envio:

^{Figura 13: Manutenção dos processos: Sincroniza Estoque e Envio Individual}

Caso tenha selecionado a geração via arquivo CSV, o arquivo "ONlineShop_Stock_YYYYMMDD.csv"  será salvo no diretório de saída configurado conforme detalhado acima neste manual.

Detalhamento da Consulta

• Estoque Completo: Marcar essa opção para consultar todas as peças que estão na base da Montadora. Quando selecionada esse opção as seguintes colunas da grade ficam disponíveis para visualização: "Número da Peça", "Descrição", "Estoque Atual", "Preço de Venda", "Custo Médio Unitário" e "Data da Última Compra".
• Estoque Individual: Marcar essa opção para consultar uma peça específica na base da Montadora.
• Posição de Estoque obrigatório quando marcada opção Estoque Individual. Marcar essa opção para consultar a Posição de Estoque da peça informada. Quando selecionada essa opção as seguintes colunas da grade ficam disponíveis para visualização: "Data Referência", "Número da Peça", "Descrição", "Estoque Atual", "Preço de Venda", "Custo Médio Unitário", e "Data da Última Compra".

As informações mostradas nos processos de consulta serão exibidas somente se já houver sido enviada a Carga Inicial para Montadora.

^{Figura 14: Consulta Estoque Completo}

Informações sobre o processo

O programa do Fabrica.exe executa as rotinas independente do Linx DMS Integrador, portanto:

• O Fabrica.exe gera as cargas, consultas e envio individual;
• O Integrador envia as movimentações dos itens.

Toda movimentação dos itens que alterem:

• Valor unitário de Venda;
• Quantidade de Estoque disponível para comercialização;
• Quantidade de estoque reservado em processos (oficina, balcão);
• Descrição do item;
• Data da última compra;
• Marca
• Custo médio.

Será disparado um evento a montadora atualizando os dados dos itens.

Sobre o Valor unitário de venda, esclarecemos que o valor considerado sempre será o praticado pela concessionária, portanto, é enviado o valor "Público". O valor de custo enviado será o que é apresentado no campo  Custo Médio (71).

^{Figura 15: Consulta Gerencial de Peças} 

Portanto, na atualização da Lista  de preço realizada através da opção Fabrica - Honda - Peças - Lista de preços, será disparado um evento com todos os itens que sofreram alguma alteração de valor ou descrição.

Para concessionárias que praticam o uso da "Tabela de preços", especificada no parâmetro de Peças em  Peças - Parâmetros-  aba Preços - Tabelas.

^{Figura 16: Parâmetros de peças}

Será disparado um evento com todos os itens que sofreram alguma alteração de valor  quando executado a rotina de atualização da tabela de preços em Peças - Cadastro - Preços (Manutenção de Preços de Itens).

Dica:  em caso de dúvidas sobre essa rotina de manutenção de Preços de itens, consultar o manual do Linx DMS.

^{Figura 17: Preços Manutenção.}

Portanto, ´para todos os processo que envolvam qualquer alteração nos dados dos itens como, Comprometimento e ou reserva de itens, emissão de Nota  de venda, nota de entrada, manutenção no cadastro do itens, rotina de inventário, será disparado um evento  contendo os dados alterados.

CONSULTANDO OS ENVIOS NO LINX DMS INTEGRADOR

• Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
• Acesse o menu "Configuração > Monitor Log de execução

Nesta tela, poderá ser acompanhando o envio dos dados e consultar o Json de envio dos dados:

^{Figura 18: Monitor do Log}

^{Figura 19: Json de envio}

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