ASSUNTO

Implementação do Projeto BI Parts Honda

PRODUTOLinx DMS
MENU

Linx DMS Integrador: Configuração > BI Parts Honda

Fábrica: Fábrica > Honda > Parâmetros

DATA

 

AUTOR
ÁREAAutomotivo
FINALIDADE

Este documento tem a finalidade de explicar o funcionamento do módulo BI Parts Honda

ABRANGÊNCIA

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

APLICAÇÃO

O BI Parts é 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 e demanda atual das concessionárias.

O envio das informações entre o DMS e a Montadora irá funcionar por 3 fluxos, sendo eles descritos na tabela abaixo:

FluxoDescrição
Sincroniza EstoqueEstado atual do estoque para peças com quantidade disponível superior a zero e envio de itens com quantidade zero que tiveram demanda
Posição de EstoqueMovimentação das alterações de quantidade disponível em estoque
Demanda EstoqueMovimentação das demandas de estoque enviados uma vez ao mês

Tabela 1: Fluxo de informações entre DMS e Montadora

CONFIGURAÇÃO DO FÁBRICA

Manutenção dos parâmetros da Honda

Menu: Fabrica.exe > Honda > Parâmetros

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

    • Dados de Acesso
    • Geração das Demandas

Aba BI Parts

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
  • Dia do mês: Preencha o dia do mês para execução da API de Geração das Demandas. Sugerimos agendar para o dia 1º de cada mês para não correr o risco de enviar um mês em duplicidade.
  • Horário para Geração: Preencha o horário para execução da API de Geração das Demandas
  • Data do Último Envio (Data na qual foi realizado o último envio da API de Geração das Demandas): Preenchido automaticamente, ao término do processo de envio.
    Obs.: Ao realizar a primeira integração, o Linx DMS irá trabalhar com informações dos últimos 36 meses até a data atual. Para isso é necessário que este campo esteja em branco, do contrário irá enviar o mês fechado tendo como base a data vigente.
  • 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 > BI Parts 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:

ValorDescrição
-1Mantém o log sem limite de data
0Não grava log
>0Mantém o log por "n" dias
  • 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 BI Parts 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;
  6. Agendamento:
    • Diariamente de: Hora do dia ao qual será realizada a consulta das informações

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 BI Parts" do Fábrica
  • 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


  • 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

UTILIZAÇÃO DO PROCESSO

  • Processo Manual

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

O Gerador apresenta a aba BI Parts, contendo os processos de comunicação disponíveis entre DMS-Montadora, "Sincroniza Estoque" e a Consulta dos Processos "Posição de Estoque" e "Demandas do Estoque"

Figura 6: Envio de Carga Inicial

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

SINCRONIZA ESTOQUE

Tem por objetivo gerar, ou enviar, a carga inicial da posição de estoque de peças que tem estoque disponível superior a zero ou pelas com estoque disponível zero, mas que houve demandas históricas

OBS: O processo irá trabalhar com informações dos últimos 36 meses até a data atual

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" . O envio via Web Servicenão gera arquivos

Figura 7: Opção de envio da Carga Inicial


Caso tenha sido feita a geração de arquivo .CSV,o arquivo terá como nome padrão "BIParts_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: BIParts_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 anteriormente.

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 8: Manutenção dos processos: Sincroniza Estoque e Consultas (Posição de Estoque e Demanda do Estoque)

PARÂMETROS

  • 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", também estará disponível um agrupamento com as seguintes colunas: "Demanda Ano/Mês" e "Quantidade".
  • Estoque Individual: Marcar essa opção para consultar uma peça específica na base da Montadora. Essa opção é vinculada às seguintes opções: Informação ("Posição de Estoque", "Demandas do Estoque") e o campo Código do Item.
  • 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".
  • Demanda do Estoque obrigatório quando marcada opção Estoque Individual. Informar uma peça para consultar na base da Montadora.

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

Figura 9: Consulta Estoque Completo


Estoque Completo: Selecione a opção Estoque Completo e clique em Consultar. Na grade abaixo, serão exibidas as peças que já estão na base da Montadora

Figura 10: Consulta Estoque Individual, opção de Estoque


Estoque Individual: Clique em Estoque Individual, logo após escolha o tipo de informação (Posição de Estoque ou Demanda do Estoque), em seguida, informe o Código do Item a ser consultado e clique em Consultar.

Posição de Estoque: Clique em Posição de Estoque, informe o Código do Item a ser consultado e clique em Consultar.

Figura 11: Consulta Estoque Individual, opção Demanda do Estoque


Demanda de Estoque: Clique em Demanda do Estoque, informe o Código do Item a ser consultado e clique em Consultar.

  • Processo Automático

O Linx DMS Integrador é responsável por efetuar a comunicação entre o DMS e a Montadora

São realizadas as seguintes comunicações:

1. Envio da Posição de Estoque: São consultadas as peças que contenham estoque disponível superior a zero. Para geração das informações da posição de estoque é feita uma verificação para cada peça. Se ela tem estoque disponível superior a zero e não foi enviada para a Montadora, então ela é enviada. Caso já tenha sido enviada, é feita a verificação para validar se o estoque disponível é diferente da quantidade enviada, se forem diferentes será enviada para a Montadora.

2. Envio das Demandas do Estoque: São consultados os últimos 36 meses de demanda do estoque de peças. Para geração das informações de demanda do estoque, são utilizados os parâmetros: Dia do mês e horário para geração, que se encontram nos parâmetros Honda. Serão considerados os últimos 36 meses de demanda do Estoque, para peças que houver movimentação no mês anterior ao envio.

Ex.: Para geração no dia 05/02/2020, a demanda histórica deve ser de 02/2017 a 01/2020 para os itens que possuam movimentação no mês 01/2020

CONTEÚDO DO PACOTE

#Nome do arquivoComentário
1Linx DMS Integrador - Manual HON BI Parts.pdfEste documento
2Fabrica.exeExecutável da montadora Honda
3FabricaClient.exeExecutável da montadora Honda (3 camadas)
4Apollo.exe Executável da montadora Honda
5ApolloClient.exe Executável da montadora Honda (3 camadas)
6eLDIBIPartsHonda.exeExecutável da montadora Honda (Integrador)
7LDIMenuBIPartsHonda.exeExecutável da montadora Honda (Menu Integrador)
DÚ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

  • Sem rótulos