Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Manual técnico do projeto RIM – Retail Inventory Management da Nissan, contendo os passos de configuração, cargas e monitoramento. |
Produto | Linx DMS Apollo |
---|---|
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 Apollo. 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: Apollo 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 apesentadas 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 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 Ful 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 inicialmantido 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" 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. 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. Pedidos Aprovados - PA001A 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 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 pedidosdas linhas de pedidos de Devolução/Scrap confirmada pela concessionária no Syncron. Deve ser configurada para executar a cada uma horauma 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. 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. Status dos Pedidos SAP / DSH - SP001da 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 da situação dos Pedidos que foram aprovados pelos fornecedores DSH e Armazém da Montadora (SAP). Efetua apenas a atualização dos pedidosdas 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. A consulta do histórico de status do pedido pode ser realizada na tela de manutenção do pedido no Linx DMS Apollo ou no Fabrica. Pedidos de Devolução/Scrap - DS001Apó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 recebimento envio 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 Syncrondo 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 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, limitado as 22:00. Data inicial para a consulta é o valor informado no campo "Última Execução" da aba de configurações.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", com a indicação da Montadora para ser o "Horário Inicial" 05: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 com um recebimento de Status OK dentro do prazo de duas horas anteriores a execução da PE001 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 e que ainda não tiveram o envio realizado pela DM005, se . 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 Apollo. 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. |