Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Manual técnico do projeto RIM – Retail Inventory Management da Nissan, contendo os passos de configuração, cargas e monitoramento. |
Produto | Linx DMS |
---|---|
Menu | Incluso no manual. |
Data | |
Autor | Distribuição Linx DMS |
Área | P&D DMS Porto Alegre |
Aviso | ||
---|---|---|
| ||
Após finalizar este manual, leia os procedimentos descritos no documento Projeto RIM Nissan | Manual Operacional. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Esse Documento tem a finalidade de detalhar a configuração do projeto RIM – Retail Inventory Management da Nissan, bem como os processos de cargas e monitoramento. |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Este documento destina-se a todas as concessionárias da montadora Nissan. |
Painel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
O projeto RIM (Retail Inventory Management) trata-se de um novo processo de troca de informações entre a Rede de Concessionárias Nissan e a Montadora que visa suportar o novo processo de reposição de peças. Esta troca de informações contempla o envio e recebimento de dados do Estoque (Ficha Gama da Nissan, Ficha Gama do Linx DMS e Posição do Estoque), Vendas e Pedidos (Normal, PVI, SAP, DSH, Transferências, Devolução e Scrap). A seguir temos a descrição as interfaces previstas:
Interfaces de RecebimentoInterfaces que a Nissan envia informações para a concessionária e são responsáveis pela atualização dos dados no Linx DMS.
Recebimento do catálogo oficial de Peças e acessórios Nissan. Importante: Esta interface substituirá o arquivo PARTAR utilizado atualmente.
Recebimento de informações dos Pedidos Aprovados ou Não Aprovados pela concessionária na plataforma da Nissan (fornecedores DSH e Armazém da Montadora).
Recebimento da situação dos Pedidos que foram aprovados pelos fornecedores DSH e Armazém da Montadora (SAP).
Recebimento de informações das linhas de pedidos de Devolução/Scrap confirmada pela concessionária no Syncron.
Recebimento das informações dos itens a serem transferidos entre lojas do mesmo grupo, com base no aceite realizado pela concessionária na ferramenta do Syncron. Interfaces de EnvioInterfaces que a concessionária envia informações para a Nissan.
Envio de informações do catálogo de peças e acessórios do Linx DMS (dados cadastrais), sempre que ocorrer uma inclusão ou atualização dos registros.
Envio da posição do estoque de peças e acessórios do Linx DMS, diariamente após o fechamento da operação de pós-vendas da concessionária.
Envio das informações de vendas, cancelamentos e devoluções de peças e acessórios realizadas pela concessionária para o cliente final.
Envio dos Pedidos de Peças Normal e PVI (emergência) que são criados no Linx DMS. Inicialização Automática da AplicaçãoÉ recomendando que o programa do Nissan RIM seja instalado em um servidor para que fique rodando em tempo integral. Em casos de reinicialização do Servidor, o programa do RIM será iniciado automaticamente na rotina de monitoramento, com o usuário ultimo que inicializou o monitoramento automático. Configuração do Processo no Linx DMS A seguir são descritos os pontos de configuração do sistema para a utilização do processo. Parâmetros do FabricaMenu: Fabrica > Nissan > Parâmetros
Preencher com os valores padrões para a criação dos pedidos recebidos da Nissan (interfaces PA001).
Pode ser informado Normal. Para a criação dos pedidos são considerados os Tipos fornecidos pela da Nissan na integração : 270 – Syncron, 170 – NBA Manual, 370 – DSH Manual.
Parâmetro do Linx DMSMenu: Linx DMS > Oficina > Cadastros > Tipo de Serviço Preencher o campo Tipo de O.S. Padrão Nissan com o valor correspondente para a Nissan, em todos os tipos de serviço. Valores disponíveis para a Nissan: Configuração e Utilização do Processo no Nissan RIMO Nissan RIM é uma interface de integração entre a rede de concessionários e a montadora. O programa realiza o envio/consulta automática de todas as interfaces, bem como permite a realização do envio/consulta manual, além das opções de consulta e detalhamentos dos dados transmitidos. As abas que compõem o Nissan RIM são: Aba MonitoramentoNesta aba estão presentes os Painéis de Monitoramento dos processos.
Contém o painel principal que apresenta todas as interfaces cadastradas com o resumo do último envio realizado e próximo envio agendado. As seguintes opções estão disponíveis:
Contém o painel de histórico que apresenta todas as comunicações realizadas para a interface selecionada. Para selecionar a interface, deve-se clicar duas vezes na linha da grade principal. As seguintes opções estão disponíveis:
Apresenta as principais colunas dos registros enviados/recebidos na interface selecionada. Esta aba é apresentada somente quando a opção de detalhamento é selecionada em um dos painéis de monitoramento. As seguintes opções estão disponíveis:
Aba Comunicação ManualNesta aba são acessadas as abas correspondentes a cada uma das interfaces existentes no projeto. Cada uma delas será detalhada posteriormente neste manual. Importante: O envio manual das interfaces é realizado somente para a revenda que o usuário estiver logado. Com relação às interfaces de envio (DM005, PE001 e IV001), a data de extração dos dados pode ser alterada em cada interface caso o usuário deseje enviar dados retroativos. Para isso basta mudar na configuração da interface o campo "Ultima Execução". Será então respeitado essa data para buscar os registros que deseja enviar manualmente. Atenção com a data a ser informada! Se for informada uma data muito antiga, avaliar a real necessidade de reenvio de todas as informações antes de clicar em "Enviar para a Nissan", pois todos os registros serão enviados, podendo causar a lentidão no processo. O programa efetua a gravação de um log contendo todas as informações referentes ao processo de transmissão dos dados. Localiza-se no mesmo diretório do executável do NissanRIM e segue a seguinte nomenclatura: NissanRIM_AAAAMMDD.log Aba ConfiguraçãoNesta aba são apresentadas as opções necessárias para a execução do processo.
Nesta aba é possível preencher os dados de cada interface além de ativar cada uma delas. Campos:
Importante: A partir da Versão 5.16 do Linx DMS, o envio da PE001 passou a ser via arquivo por FTP, não utilizando mais o endereço da API acima. Observar o tópico abaixo com o detalhamento do preenchimento dos campos para envio.
Importante: Este interface somente deve ser configurada e Ativa após alinhamento com a Montadora para liberação do uso.
Importante: Este interface somente deve ser configurada e Ativa após alinhamento com a Montadora para liberação do uso.
O Envio da Posição do estoque é realizado via arquivo CSV e enviado á Nissan via FTP. Na configuração desta interface, deve também ser preenchido os campos do ser mantido o horário de Comunicação as 20 hrs, nesse horário será chamada a rotina de envio via FTP, então é necessário preencher o campo "Configuração de Envio". Também deve ser preenchido os campos do grupo "Horário Response" , além das configurações de Envio. Essas informações são usadas na execução da interface para buscar as informações de com o horário Inicial as 05:00 e final as 06:00, nesse horário, no dia seguinte ao envio do arquivo da PE001, será recebido o retorno da Nissan com a validação dos registros que foram enviados. A partir da Versão 5.16 do Linx DMS, quando o envio passou a ser realizado via FTP, os campos de Configuração do Web Service não ficam mais acessíveis. Deve ser informado o endereço FTP : nlb-sftp-s3transfer-a1ce4d18af866642.elb.us-east-1.amazonaws.com (fornecido pela montadora). IMPORTANTE: o endereço deve ser informado como está mostrando a imagem, sem / no final e ou HTTPS no início. Usuário: DMS_LINX Porta: 22 No campo 'Arquivo da Private Key' deverá ser informado o caminho onde foi salvo o arquivo DMS_LINX.ppk. Os arquivos necessários para que essa rotina seja efetuada com sucesso, são: DMS_LINX.ppk, WinSCP.com, WinSCP.exe, WinSCP.ini, WinSCPnet.dll . Eles devem ficar na mesma pasta do executável do NissanRim.
Na configuração desta interface, deve também ser preenchido o campo Configuração da Carga Full. Essa informação será usada na execução da interface para rodar a carga full que é realizada aos domingos e traz a carga completa (substituição do PARTAR). Deve ser informado o endereço FTP : nlb-sftp-s3transfer-a1ce4d18af866642.elb.us-east-1.amazonaws.com IMPORTANTE: o endereço deve ser informado como está mostrando a imagem, sem / no final e ou HTTPS no início. Usuário: DMS_LINX Porta: 22 Arquivo da Private Key- deverá ser informado o caminho onde foi salvo o arquivo DMS_LINX.ppk Os arquivos necessários para que essa rotina seja efetuada com sucesso, são: DMS_LINX.ppk, WinSCP.com, WinSCP.exe, WinSCP.ini, WinSCPnet.dll . Eles devem ficar na mesma pasta do executável do NissanRim. O programa efetua a gravação de um log contendo todas as informações recebidas na Carga Full e segue a seguinte nomenclatura: DM002_FULL_xxxxxxxx.csv Aba Configuração
Nesta aba é possível preencher os dados referente a inclusão ou atualização dos itens. Importante: Estas informações serão utilizadas na importação da Ficha Gama de Peças e Acessórios Nissan (DM002), que é o processo que substituirá a importação do arquivo PARTAR, portanto é recomendado que sejam utilizados os mesmos parâmetros do programa de importação do arquivo PARTAR (menu Fabrica > Nissan > Processos > Fabrica-Rede > Importa Arquivo PARTAR). Dados precisam ser preenchidos somente na Matriz.
Campos:
Campos:
Campos:
Importante: Utilizar a mesma forma como era considerado o preenchimento destes parâmetros na importação do PARTAR, para garantir a forma como era importados os itens. Execução AutomáticaO NissanRIM.exe é um programa que precisar rodar de forma única estiver 'Ativado o monitoramento', de envio das interfaces, portanto, somente um exe deve ficar em execução. Caso seja necessário realizar algum envio manual de qualquer interface, deverá ser "Desativado o Monitoramento' antes de fazer qualquer envio. Após fazer os envios, Ativar o monitoramento novamente. No caso de abrir um segundo programa do NissanRIM.exe para eventuais consultas a dados de enviados, orientamos a fechar esse programa após as consultas, deixando somente um programa em execução com o monitoramento ativo. Detalhamento das InterfacesA seguir é apresentado o detalhamento de cada interface existente no processo RIM. Interfaces de Recebimento
Esta interface é responsável pelo recebimento do catálogo oficial de Peças e acessórios da Nissan. Deve Ser configurada somente na Matriz. Importante: Esta interface substituirá o arquivo PARTAR utilizado atualmente. Após a ativação do processo do RIM, não será mais permitida a importação. Deve ser configurada para executar diariamente às 06:00 hrs, sendo que aos domingos será realizada a carga full e de segunda a sábado será realizada a carga incremental. A carga full utiliza como data inicial o valor informado no parâmetro "Data Inicial da Carga Completa". Já a carga incremental utiliza como data inicial o valor informado no campo "Última Execução" da aba de configurações. Será gerado um Log na pasta onde está instalado o Apollo.exe com o nome "DM002_FULL_20230115.csv" que pode ser usado para conferências quando necessário.
Esta interface é responsável pelo recebimento de informações dos Pedidos Aprovados ou Não Aprovados pela concessionária na plataforma da Nissan (fornecedores DSH e Armazém da Montadora). Efetua apenas a inclusão de pedidos. Deve ser configurada para executar a cada uma hora. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações. Importante considerar o horário de início e fim da execução conforme tabela abaixo. Importante: Este interface somente deve ser configurada e Ativa após alinhamento com a Montadora para liberação do uso.
Esta interface é responsável pelo recebimento da situação dos Pedidos que foram aprovados pelos fornecedores DSH e Armazém da Montadora (SAP). Efetua apenas a atualização dos pedidos. Deve ser configurada para executar a cada uma hora. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações. A consulta do histórico de status do pedido pode ser realizada na tela de manutenção do pedido no Linx DMS ou no Fabrica.
Esta interface é responsável pelo recebimento de informações das linhas de pedidos de Devolução/Scrap confirmada pela concessionária no Syncron. Deve ser configurada para executar uma vez ao dia, após as 22:00. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações. Após o recebimento a concessionária deve proceder com a emissão da nota fiscal de devolução ou scrap.
Esta interface é responsável pelo recebimento das informações dos itens a serem transferidos entre lojas do mesmo grupo, com base no aceite realizado pela concessionária na ferramenta do Syncron. Deve ser configurada para executar a cada uma hora. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações. Após o recebimento a concessionária deve proceder com a emissão da nota fiscal de transferência entre filiais. Importante: Todo pedido que não for faturado no mesmo dia será cancelado automaticamente. Importante: Este interface somente deve ser configurada e Ativa após alinhamento com a Montadora para liberação do uso. Interfaces de Envio
Esta interface é responsável pelo envio de informações do catálogo de peças e acessórios do Linx DMS (dados cadastrais), sempre que ocorrer uma inclusão ou atualização dos registros. Como o responsável pela comunicação é o NissanRIM, esta interface deve ser configurada para envio a cada 1 hora durante o expediente da concessionária. Os itens selecionados respeitam a seguinte regra: Carga Diária
Carga Histórica
Esta interface é responsável pelo envio da posição do estoque de peças e acessórios do Linx DMS, diariamente após o fechamento da operação de pós-vendas da concessionária. Deve ser configurada para executar uma vez ao dia, após o fechamento da operação de pós-vendas na concessionária , indicado iniciar as 20hrs e limitado às 22:00. A data inicial para a consulta das peças é o valor informado no campo "Última Execução" da aba de configurações. Esta interface possui uma particularidade diferente das outras : a validação das informações enviadas ocorre posteriormente, através de um arquivo de resposta (Response), recebido via SFTP da montadora. Os campos de configuração "Horário Response" indicam em qual momento será realizada a busca do arquivo de resposta, com a validação das informações enviadas. Por isto, ao consultar o painel de monitoramento, caso a mensagem abaixo seja apresentada, indica que as informações foram enviadas, mas ainda não estão validadas, pois o arquivo de resposta ainda não foi processado. Essa validação ocorre no dia posterior ao envio das informações, por isso é importante nas configuração "Horário Response" informar um valor posterior ao "Horário de Comunicação", como por exemplo com a indicação da Montadora para ser o "Horário Inicial" 05:00 e "Horário Final" 06:00.:00 e "Horário Final" 06:00. Será criada uma pasta denominada "ComunicacaoPE001" na pasta raiz onde está o executável do Nissan RIM, que vai conter uma cópia (para simples conferência) dos arquivos CSV enviados e uma cópia do Response vindo da Nissan com o processamento. Importante: Realizar a limpeza dos arquivos de tempos em tempos, esse arquivo é somente para conferência e não será mais usado. Os itens selecionados respeitam a seguinte regra:
No Processo de envio desta interface, são realizadas duas validações: 1º-É realizada a verificação se a interface PA001-Pedidos Aprovados está ativa. Uma vez ativa será avaliado se houve a execução desta interface após as 16:30 hrs. Havendo uma comunicação com status OK registrada deste horário em diante, a PE001 será enviada normalmente. Caso não tenha ocorrido, não será enviado a Nissan neste dia a PE001 e será apresentado no log a seguinte mensagem: "Não foi possível enviar a interface Posição de Estoque de Peças e Acessórios(PE001). Não houve o recebimento da interface PA001 com status = 0 (Recebido com Sucesso). " Isso garante que somente será enviado a Nissan a atualização do estoque via PE001, se houver sido integrado todos os pedidos realizados no Syncron no dia, e que são recebidos via PA001. 2º- É realizado um controle para identificar quais peças estão sendo enviadas, e que ainda não tiveram o envio realizado pela DM005. Se houver peças nestas situações, primeiro será disparado a DM005 destes itens, e somente após isso, será disparado de fato a PE001 completa. Para o processo do RIM, todas as peças que são enviadas pela PE001 precisam em algum momento ter sido enviadas pela DM005, então este controle garante que, de forma automática isso seja feito.
Esta interface é responsável pelo envio das informações de vendas, cancelamentos e devoluções de peças e acessórios realizadas pela concessionária para o cliente final. Importante: No processo de implantação é necessário o envio dos dados do histórico do período de 2 anos, por BIR. Deve ser configurada para executar a cada uma hora. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações. Nesta interface não são enviadas as notas de transferência entre filiais, notas de devoluções para a montadora e notas de scrap.
Esta interface é responsável pelo envio dos Pedidos de Peças Normal e PVI (emergência) que são criados no Linx DMS. Como o responsável pela comunicação é o NissanRIM, esta interface deve ser configurada para envio a cada 15 minutos durante o expediente da concessionária. Serão selecionados os pedidos fechados para alterações (data de emissão preenchida) e marcados como "Transmitir para a Fábrica". Estes pedidos devem ser gerados apenas para pedidos adicionais (Tipo Normal ou Emergência) que não foram gerados pela sugestão automática da Syncron. Observação: Os pedidos de peças para terceiros devem ser gerados utilizando o tipo "Complementar". Estes pedidos não serão enviados para a Nissan. Resumo da configuração das interfacesA seguir é apresentado um resumo contendo para a configuração das interfaces.
ImplantaçãoApós a configuração de todos os parâmetros do RIM devem ser executadas as cargas full/históricas das seguintes interfaces: Recomendamos que seja executa a comunicação manual para estas interfaces para o envio das Cargas, de forma a acompanhar os envios. Considerando que seja realizada a configuração somente delas no primeiro momento, informando as datas conforme indicado abaixo. Depois, executar manualmente uma por uma, após a finalização do envio da primeira loja, repetir para as filias. Após os envios, configurar as demais interfaces e Ativar o Monitoramento.
|
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. |