RENA0000 - Exportação de Arquivos PLR2 Renault , SIP Nissan e AGILE SUPPLY para outras bandeiras
Este programa exporta as informações relativas aos itens em estoque de uma filial, gerando um arquivo texto com layout diferenciado, dependendo da opção de menu escolhida, conforme documentação disponibilizada pelas montadoras Renault e Nissan.

Para que os layout's sejam montados corretamente, informe através do programa CADA0144, como as filiais estão cadastradas no sistema da Renault/Nissan. Para este procedimento, será necessário incluir uma nova parametrização, informando:

• Sistema: SISDIA
• Entidade: cofilial
• Atributo: filial
• Descrição: opcional, sugestão "RENA0000 e RENA0100".

Após confirmar a inclusão, informe os parâmetros DE/PARA considerados neste processo. O usuário deverá ter conhecimento do código da empresa no sistema das montadoras, bem como dos códigos das filiais cadastrados no SISDIA e os códigos correspondentes no sistema das montadoras.

Parametrizar a empresa, informando:
Observação: Para clientes com bandeira Renault o sistema de destino deverá ser "PLR2-REN"; para clientes com bandeira Nissan o sistema de destino deverá ser "SIP-NIS"; para a bandeira Peugeot o sistema de destino deverá ser "AGI-SUPPGT" e para a bandeira Citroen o sistema de destino deverá ser "AGI-SUPCIT".

• Sistema de Destino: PLR2-REN ou SIP-NIS ou AGI-SUPPGT ou AGI-SUPCIT.
• De: 0 (zero), que indica a empresa.
• Para: código da empresa no sistema das montadoras, fornecido pelo SAC do PLR2 (Renault), ou SIP (Nissan) ou outra.
• Obs.: opcional, sugestão "EMPRESA".

Para parametrizar cada filial do SISDIA, informe:

• Sistema de Destino: PLR2-REN ou SIP-NIS ou AGI-SUPPGT ou AGI-SUPCIT.
• De: código da filial no SISDIA.
• Para: código da filial no sistema das montadoras ou os 5 últimos dígitos do CNPJ da filial.
• Obs.: opcional, sugestão "FILIAL".

É necessário parametrizar também, através do programa CADA0144, os fabricantes ou fornecedores conforme sistema das montadoras. Para este procedimento, deverá incluir uma nova parametrização informando:

• Sistema: SISDIA;
• Entidade: cffornec;
• Atributo: cgccpf;
• Descrição: opcional.

Após confirmar a inclusão, informe os parâmetros DE/PARA considerados neste processo. O usuário deverá ter conhecimento dos fabricantes/fornecedores cadastrados no SISDIA e os códigos correspondentes utilizados no sistema das montadoras:
Observação: Para clientes com bandeira Renault o sistema de destino deverá ser "PLR2-REN"; para clientes com bandeira Nissan o sistema de destino deverá ser "SIP-NIS"; para a bandeira Peugeot o sistema de destino deverá ser "AGI-SUPPGT" e para a bandeira Citroen o sistema de destino deverá ser "AGI-SUPCIT".

• Sistema de Destino: PLR2-REN ou SIP-NIS ou AGI-SUPPGT ou AGI-SUPCIT.
• De: informe o CGC do fabricante/fornecedor cadastrado no SISDIA.
• Para: informe o código do fabricante/fornecedor, conforme cadastrado no sistema da montadora.
• Obs.: opcional.

Após finalizar esta parametrização, o usuário poderá exportar as informações. Caso a parametrização esteja incorreta ou incompleta, será apresentada a mensagem:

Dados Iniciais – layout 4.1
Esta opção exporta as informações consideradas "Dados iniciais para carga no sistema", gravando um arquivo texto no layout 4.1.

Nesta opção, o usuário deverá informar:

• Utilizar Demandas do Ano: qual ano será utilizado para gerar os dados iniciais, que serão lidos da tabela ccdemand.
• Considera Itens com Saldo Atual Zerado?: valores válidos S = Sim ou N = Não.
• Considerar Itens com Todas as Demandas Mensais Zeradas?: valores válidos S = Sim ou N = Não.
• Considera Todas as Linhas/Grupos?: valores válidos S = (Sim) ou N = Não. Caso informe "Não", será apresentada tela para especificar quais linhas/grupos serão exportados.

Em seguida, o nome do arquivo será montado e exibido na tela, da seguinte forma: demandaaaaa.txt, onde "aaaa" refere-se ao ano informado e que está sendo exportado. O usuário necessita, então, confirmar o processamento. Ao término da exportação, será apresentada a mensagem:

Análise – layout 4.2
Esta opção exporta informações sobre os itens em estoque, tais como preço de venda, custo médio contábil, data da primeira compra, etc, (das tabelas cmpreest e cmestoqu), conforme layout 4.2.

Nesta opção, o usuário deverá informar:

• Considera Itens com Saldo Atual Zerado?: valores válidos "S" (Sim) ou "N" (Não).
• Considera Todas as Linhas/Grupos?: valores válidos "S" (Sim) ou "N" (Não). Caso informe "Não", será apresentada tela para especificar quais linhas/grupos serão exportados.

Em seguida, o nome do arquivo será montado e exibido na tela, da seguinte forma: analiseddmmaaaa.txt, onde "ddmmaaaa" refere-se à data do processamento. O usuário necessita, então, confirmar o processamento. Ao término da exportação, será apresentada a mensagem:

Substituição – layout 4.3
Esta opção exporta informações sobre substituição de um item por outro item, da tabela cmsubpro, conforme layout 4.3.

Nesta opção, o usuário deverá informar:

• Data de Substituição: data a ser exportada.
• Considera Todas as Linhas/Grupos?: valores válidos "S" (Sim) ou "N" (Não). Caso informe "Não", será apresentada tela para especificar quais linhas/grupos serão exportados.

Em seguida, o nome do arquivo será montado e exibido na tela, da seguinte forma: substddmmaaaa.txt, onde "ddmmaaaa" refere-se à data informada na tela. O usuário necessita, então, confirmar o processamento. Ao término da exportação, será apresentada a mensagem:

Carteira – layout 4.7
Esta opção exporta informações sobre a carteira de clientes, através de informações das notas fiscais de saída emitidas num determinado período, tabela cnnfcapa, conforme layout 4.7.

Nesta opção, o usuário deverá informar:

• Intervalo De/Até: o período para análise das notas fiscais.
• Considera Todas as Linhas/Grupos?: valores válidos "S" (Sim) ou "N" (Não). Caso informe "Não", será apresentada tela para especificar quais linhas/grupos serão considerados.

Em seguida, o nome do arquivo será montado e exibido na tela, da seguinte forma: carteiraddmmaaaa.txt, onde "ddmmaaaa" refere-se à data inicial informada na tela. O usuário necessita, então, confirmar o processamento. Ao término da exportação, será apresentada a mensagem:

Acessórios – layout 4.8
Esta opção exporta informações sobre os acessórios, tais como classificação fiscal, se possui incidência sobre PIS e COFINS, conforme layout 4.8.

Nesta opção, o usuário deverá informar:

• Considera Itens com Saldo Atual Zerado?: valores válidos "S" (Sim) ou "N" (Não).
• Considera Todas as Linhas/Grupos?: valores válidos "S" (Sim) ou "N" (Não). Caso informe "Não", será apresentada tela para especificar quais linhas/grupos serão exportados.

Em seguida, o nome do arquivo será montado e exibido na tela, da seguinte forma: acessoriosddmmaaaa.txt, onde "ddmmaaaa" refere-se à data do processamento. O usuário necessita, então, confirmar o processamento. Ao término da exportação, será apresentada a mensagem:

O programa passará utilizar o processo Sistema Integrado de Peças Nissan – SIP
A bandeira será verificada através da filial selecionada no monitor do sistema.
O cálculo dos campos "Quantidade Pendente" (16 da planilha), e "Quantidade pendente BO" (25 da planilha) baseado na regra da montadora Renault: "A quantidade pendente (16) é a quantidade solicitada dos pedidos que ainda não chegou." e ''A quantidade pendente BO (25) é a quantidade que não tem estoque na montadora ou no fornecedor''.

• Quando o programa for executado com integração do usuário, será solicitado a bandeira, podendo assim ser executado com mais de uma bandeira parametrizada para filial no CADA0280.

Ao abrir o módulo RENA0000, é solicitado a seleção da bandeira para geração dos arquivos.

Procedimentos para rodar o programa de forma automática
Para a bandeira Renault, será possível realizar parametrizações que permitirão a execução desse programa de forma automática, através do CRONTAB. Além disso, os dados serão enviados via WebService para a montadora.
Acessar a área de "Serviços", "Aplicativos" e baixar a liberação: InstallRENA0000.zip ou através do link InstallRENA0000.zip. Após a realização do download, seguir o processo descrito abaixo.

• Salve o arquivo InstallRENA0000.zip em um diretório do Windows e transfira via FTP como binário para o diretório /ext/install.
• Abra uma sessão do PuTTY ou QVT-Term com usuário "root" e digite o comando:

cd /ext/install pressione <ENTER>

• Descompacte o instalador usando o comando:

unzip InstallRENA0000.zip pressione <ENTER>.

• Em seguida, acesse o diretório "InstallRENA0000" usando o comando:

cd InstallRENA0000 pressione <ENTER>.

• Na sequência, digite o comando:

sh InstallRENA0000.sh pressione <ENTER>.

• Após isto, execute o comando para dar permissão para executar o .sh:

chmod 777 /root/bin/rena0000.sh pressione <ENTER>.

• Para se certificar que o serviço foi instalado corretamente execute o comando e verifique se o serviço aparece na lista:

crontab -l pressione <ENTER>.

• Vá até o diretório /root/bin e edite via Linux o arquivo rena0000.sh

Procure pelo comando INFORMIXSERVER=ol_standard e substitua a variável ol_standard pelo nome da sua instância de produção. Exemplo:
INFORMIXSERVER=ol_standard
Procure pelo comando cd /sisdia, o qual deverá ser substituído por:
cd + o caminho do diretório de produção do SISDIA
Exemplo: cd /ext/sisdia

• Agora execute o comando crontab –e, vá até as linhas onde estão configuradas as tarefas para o programa RENA0000 e troque o caracter X pelo valor desejado para os seguintes parâmetros:

Primeiro X = Código da Filial;
Segundo X = Considerar Itens com Saldo Atual Zerado (S / N);
Terceiro X = Considerar Itens com Todas as Demandas Mensais Zeradas (S / N);
Quarto X = Considerar Todas as Linhas/Grupos (S / N);
Quinto X = Códigos dos grupos desejados ("CADA0270") separados por ponto e vírgula. Apenas se o parâmetro "Considerar Todas as Linhas/Grupos" for igual a "N", senão deixar o 'X'.
Exemplo:
Original
00 07 * * 5 /root/bin/rena0000.sh 'X' 'AUTO' '1' 'X' 'X' 'X' 'X'
Alterado
00 07 * * 5 /root/bin/rena0000.sh '1' 'AUTO' '1' 'S' 'N' 'S' 'X'
Ou
00 07 * * 5 /root/bin/rena0000.sh '1' 'AUTO' '1' 'S' 'N' 'N' '1001;1002'

• Obs. 1: dias/horários de execução já estão parametrizados de acordo com o solicitado pela montadora.
• Obs. 2: após o parâmetro 'AUTO' está o parâmetro que indica o arquivo que será gerado. Onde:

'1' = Dados Iniciais
'2' = Análise
'3' = Substituição
'7' = Carteira
'8' = Acessórios

• Obs. 3: alguns parâmetros não são necessários para a geração de determinados arquivos. Neste caso, eles deverão permanecer com 'X'. Para conferir quais parâmetros devem ser preenchidos, basta acessar o programa no Sisdia.
• Obs. 4: em relação aos períodos utilizados nos processos, para atender a frequência de envio determinada pela montadora eles ficarão da seguinte forma:
  • Dados Iniciais (1): considera o ano corrente da data anterior a data de geração.
  • Análise (2): considera a data anterior a data de geração (atual).
  • Substituição (3): considera as substituições da última semana, referente a data anterior da data de geração (data anterior - 7 dias).
  • Carteira (7): considera movimentações da data anterior a data de geração (atual).
  • Acessórios (8): não foi alterado pois não depende de período.
• Assim que a instalação for concluída, basta desconectar o PuTTY digitando exit.

Além dos procedimentos descritos acima, será necessário também realizar as seguintes parametrizações:

• ("CADA3200"): se a instância do banco ainda não estiver cadastrada, fazer sua inclusão;
• ("CADA3100"): incluir um registro onde o campo "Identificacao" deverá ser igual a "WS_PLR2-REN". No campo "Versao MSG", informar o código do usuário que deverá ser utilizado para realizar a comunicação. Esse código é definido pela montadora.
• Para a bandeira Renault deve ser informada a identificação: "WS_ PLR2-REN".
• Para a bandeira Nissan deve ser informada a identificação: "WS_ SIP-NIS".
• Para a bandeira Peugeot deve ser informada a identificação: "WS_AGI-SUPPGT"
• Para a bandeira Citroen deve ser informada a identificação: "WS_AGI-SUPCIT"
• Veja um exemplo na figura abaixo:

Ao final da execução automática, será gerado um arquivo de log no diretório definido para o programa no ("COPE0100"). O Padrão de nomenclatura do arquivo é:
logRENA0000_AAAAMMDDhhmmss.log
onde:
AAAA = ano
MM = mês
DD = dia
hh = hora
mm = minuto
ss = segundo


Procedimentos para envio/consulta dos arquivos via WebService
Para a bandeira Renault, para que os arquivos possam ser enviados e/ou baixados da montadora, é necessário realizar algumas configurações.
Acessar a área de "Serviços", "Aplicativos" e baixar a liberação: PLR2.zip ou através do link PLR2.zip. Após a realização do download, seguir o processo descrito abaixo.

• Salve o arquivo PLR2.zip em um diretório do Windows e transfira via FTP como binário para o diretório de instalação do Sisdia.
• Abra uma sessão do PuTTY ou QVT-Term com usuário "root" e descompacte o pacote usando o comando:

unzip PLR2.zip pressione <ENTER>.

• Após isto, execute o comando para dar permissão para executar o .sh:

chmod 777 plr2.sh pressione <ENTER>.
Para toda chamada a qualquer operação do WebService, será gerado um arquivo de log no diretório "logs_plr2". O Padrão de nomenclatura do arquivo é:
AAMMDDhhmmss.log
onde:
AA = ano
MM = mês
DD = dia
hh = hora
mm = minuto
ss = segundo
Obs.: caso o arquivo gerado esteja vazio, o WebService não será executado pois a montadora retorna erro nesse caso.
Estarão disponíveis nesta tela os seguintes botões, permitindo a navegação e conclusão da reserva:

• Concluir: Confirma o processamento/ação.
• Interromper: Interrompe o processo.
• Documentação: Acesso à documentação do programa.
• Sair: Finaliza as atividades.