NOME DO REQUISITO

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

OFINJD01
OFINJD02
OFINJD03
OFINJD04
OFINJD05
OFINJD10
OFINJD22
OFIWJD03
OFIWJD04
OFIWJD05
UPDOFIM5

OFINJD01 – Import Peças JD

Esta rotina foi criada para realizar a atualização do cadastro de peças da marca John Deere junto ao Protheus. Estas informações de peças são conhecidas internamente pela John Deere como Parts Info. A John Deere disponibiliza um arquivo que é lido e interpretado pelo Protheus para que em seguida o cadastro de peças seja atualizado. Este arquivo disponibilizado pela John Deere poderá incluir novas peças, atualizar informações referentes a peça, bem como atualizar preços de Lista e preços Net e remover a utilização de determinadas peças.

OFINJD02 – Subst Peças JD

Esta rotina foi criada para atender a integração disponibilizada pela John Deere para substituição de peças denominada Parts Subs. A rotina irá realizar a substituição automática de determinadas peças da marca John Deere junto ao Protheus. A fábrica disponibiliza um arquivo que é lido e interpretado pelo Protheus para que em seguida a substituição seja realizada.

 OFINJD03 – Localizador Peças

Esta rotina foi criada para atender a integração da John Deere referente ao processo de disponibilização de seu estoque disponível atual para compra entre os concessionários da rede John Deere através do JDPOINT e a visualização do mesmo entre os clientes através do JDParts. Este processo é denominado pela John Deere como Parts Locator. O Protheus permitirá que o usuário realize este processo de maneira automática a partir das informações de saldo atual das peças.

Importante

Antes de executar o compatibilizador informe o UPDOFIM5 é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-

Importante

Antes de executar o compatibilizador informe o UPDOFIM5 é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em TOTVS Smart Client, digite o U_UPDOFIM5 no campo Programa Inicial.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Atualizações do Compatibilizador

4.  Criação de Campos no arquivo SX3 – Campos:

• Tabela SC7 - Pedidos de Compra:

• Tabela VEJ - Codigos dos Tipos de Pedido:

• Tabela SB1 - Descricao Generica do Produto :

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa VEJPED:

• Pesquisa: SF1PRE

• Pesquisa: VE4PED

7.  Criação de Parâmetros no arquivo SX6 – Parâmetros:

Procedimento para Configuração

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do iAutopeças (SIGAOFI), conforme instruções a seguir:

 No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do Oficina (SIGAOFI), conforme instruções a seguir:

Procedimento para Utilização

Import Peças JD (OFINJD01).

1. Ainda no Configurador (SIGACFG)

1. acesse Ambientes/Cadastro/

1. Parâmetros (

1. CFGX017). Pesquise pelo parâmetro MV_MIL0062.
2. Neste parâmetro será possível determinar quais peças não terão o conteúdo do campo Pedi Produto (B1_PEDPRO) zerados durante o processo de importação. A cada importação, o conteúdo do campo Pedi Produto (B1_PEDPRO) é zerado em todos os cadastros de peças, com exceção das peças indicadas neste parâmetro. Para indicar estas peças, informe os grupos das peças que não serão atualizadas com zero neste parâmetro. Exemplo de preenchimento: SHL /JDRM/AB
3. No Oficina (SIGAOFI), acesse Atualizações\Cad Gestão\Parâmetro Marca(OFIPA980).
4. Posicione sobre o registro referente à montadora John Deere e clique em Alterar.
5. Selecione a pasta Integração com Montadora.
6. Os seguintes campos serão utilizados pela rotina de importação:
   1. Cta. Contab. (VE4_CTACTB): será gravado no campo Cta Contabil (B1_CONTA).
   2. Centro Custo (VE4_CENCUS): será gravado no campo Centro Custo (B1_CC).
   3. Armaz.Padrao (VE4_ALMPAD): será gravado no campo Armazem Pad. (B1_LOCPAD).
   4. Grp Item Pad (VE4_GRUITE): será gravado no campo Grupo (B1_GRUPO). Será um grupo temporário, já que o usuário posteriormente irá alterar o grupo de acordo com a sua estrutura de grupo de produtos definida.

ATENÇÃO! Os grupos de peças devem ser definidos e criados no momento da implantação do sistema pelo concessionário. Limite o uso de grupos de peças o máximo possível. O recomendado é não ultrapassar 30 grupos de peças diferentes para as peças John Deere.

1. Forn/Montad (VE4_CODFOR): será gravado no campo Forn. Padrao (B1_PROC).
2. Loja Fornec. (VE4_LOJFOR): será gravado no campo Loja Padrao (B1_LOJPROC).
3. Mesma UF Mon (VE4_FESTCO): será gravado no campo Fora estado (B1_FORAEST).
4. No momento da execução da rotina de importação, o usuário poderá escolher se considerará os campos de TES abaixo para serem gravados nas novas peças:
   1. TES Pad.Ent (VE4_TESENT): será gravado no campo TE Padrao (B1_TE).
   2. TES Pad. Sai (VE4_TESSAI): será gravado no campo TS Padrao (B1_TS).
5. Confirme a alteração.
6. Acesse Atualizações\Peças JD\Import Peças JD (OFINJD01).
7. Clique no botão Param.
8. Na janela aberta, serão exibidos parâmetros a serem preenchidos para a execução da rotina:
   1. Arquivo de Importação: informe o arquivo .DAT disponibilizado pela John Deere através do DTF (Data Transfer Facility), um programa de uso da John Deere que gerencia a transferência dos arquivos entre a concessionária e a John Deere através da internet. O DTF irá baixar estes arquivos e disponibilizá-los. Para exibir a janela de navegação de pastas, deixe o conteúdo do parâmetro em branco e pressione Enter.
   2. Marca: informe o código da marca a ser utilizado nos casos onde há necessidade de inclusão de novas peças. O código informado aqui será utilizado para buscar o cadastro da montadora na rotina Parâmetro Marca (OFIPA980).
   3. Importa TES da marca?: informe se o conteúdo dos campos TES Pad.Ent (VE4_TESENT) e TES Pad. Sai (VE4_TESSAI) da rotina Parâmetro Marca (OFIPA980) serão utilizados para gravação dos campos TE Padrao (B1_TE) e TS Padrao (B1_TS), respectivamente.
9. Confirme o preenchimento dos parâmetros.
10. Clique em OK para dar início ao processo de importação.
11. Vale ressaltar que os Preços e outras informações serão gravados nos campos abaixo:
    1. Preço de Lista: campo Preco Venda (B1_PRV1);
    2. Preço Net: campo Preco Venda2 (B5_PRV2);
    3. Preço Core Exchange Net: campo Preco Venda3 (B5_PRV3);
    4. Preço Core Exchange List: campo Preco Venda4 (B5_PRV4);
    5. Preço Return Credit Net: campo Preco Venda5 (B5_PRV5);
    6. Preço Return Credit List: campo Preco Venda6 (B5_PRV6);
    7. Indicador de Retorno: campo Retornável (B1_REMANE);
    8. Ativo para Compra: campo Pedi Produto (B1_PEDPRO).

ATENÇÃO! Nos casos em que as regras de negócios fizerem uso da tabela SBZ, o ponto de entrada ONJD01AV servirá de auxílio para a atualização das informações necessárias a cada uma das filiais, através do tratamento do vetor aFilis.

1. Também é possível executar esta rotina de forma automática, através do cadastro de schedules do Protheus. Para isso, realize o cadastro do schedule e nos parâmetros da rotina informe: empresa; filial; diretório o qual está armazenado o arquivo a ser gerado; marca; e 1 para importar TES ou 0 para não importar. Exemplo: OFINJD01("01","01","IMP","JD",1), onde “01” é a empresa; “01” filial; “IMP” é o diretório onde está armazenado o arquivo a ser importado; “JD” a marca; e “1” indicando que irá importar TES.

Subst Peças JD (OFINJD02).

1. ATENÇÃO! Vale ressaltar que somente as peças que estão cadastradas na rotina Peças (MATA010) serão consideradas para realização da substituição. Portanto, execute a rotina Import Peças JD (OFINJD01) antes de realizar a importação.
2. No Oficina (SIGAOFI), acesse Atualizações\Peças JD\Subst Peças JD (OFINJD02).
3. Clique no botão Param.
4. Na janela aberta, será exibido o parâmetro a ser preenchido para a execução da rotina:
   1. Arquivo de Importação: informe o arquivo .DAT disponibilizado pela John Deere através do DTF (Data Transfer Facility), um programa de uso da John Deere que gerencia a transferência dos arquivos entre a concessionária e a John Deere através da internet. O DTF irá baixar estes arquivos e disponibilizá-los. Para exibir a janela de navegação de pastas, deixe o conteúdo do parâmetro em branco e pressione Enter.
5. Confirme o preenchimento.
6. Clique em OK para dar início ao processo de importação.
7. Para cada substituição realizada, será criado um registro na rotina Substituic Manual (OFIPA910).

Localizador Peças (OFINJD03).

1. No Oficina (SIGAOFI), acesse Atualizações\Peças JD\Localizador Peças (OFINJD03).
2. Será aberta a janela inicial da rotina. Clique em Param.
3. Será aberta uma janela para que o usuário realize o preenchimento dos parâmetros para geração do arquivo:
   1. Diretório: informe o diretório onde o arquivo XML será gerado.
   2. Grupo de Peças: informe os códigos dos grupos de peças a serem considerados no levantamento das peças. Caso haja mais de um grupo, os mesmos devem ser separados entre barras. Exemplo de preenchimento: JD  /ABCD/T2  /JD1
   3. Nro da Conta Principal: informe o código principal de conta da concessionária junto a John Deere.
   4. Considera Armazém?: informe qual armazém será considerado no levantamento das peças:
      1.                                        i.      Parâmetro: será considerado o armazém informado no conteúdo do próximo parâmetro, denominado Armazém.
      2.                                      ii.      Padrão da Peça: será considerado o armazém padrão da peça, existente no próprio cadastrado da peça através do campo Armazem Pad. (B1_LOCPAD).
   5. Armazém: caso o parâmetro Considera Armazém? esteja preenchido com a opção Parâmetro, o conteúdo informado aqui será considerado.
4. Após preenchimento dos parâmetros, confirme.
5. Clique em OK na janela principal.
6. Será exibida a mensagem informando que o arquivo foi gerado com sucesso.
7. O arquivo gerado possuirá a extensão .DAT, e seu nome será atribuído desta forma: DLR2JD_ + DIA + MÊS + ANO + _ + HORA + MINUTO + SEGUNDO.DAT. Exemplo: DLR2JD_25OCT2015_130440.DAT.
8. ATENÇÃO! Serão consideradas apenas as peças que possuem saldo atual em estoque maior do que zero, de acordo com o armazém considerado.

Procedimento para Utilização

Import Peças JD (OFINJD01).

1. Ainda no Configurador (SIGACFG) acesse Ambientes/Cadastro/Parâmetros (CFGX017). Pesquise pelo parâmetro MV_MIL0062.
2. Neste parâmetro será possível determinar quais peças não terão o conteúdo do campo Pedi Produto (B1_PEDPRO) zerados durante o processo de importação. A cada importação, o conteúdo do campo Pedi Produto (B1_PEDPRO) é zerado em todos os cadastros de peças, com exceção das peças indicadas neste parâmetro. Para indicar estas peças, informe os grupos das peças que não serão atualizadas com zero neste parâmetro. Exemplo de preenchimento: SHL /JDRM/AB
3. No Oficina (SIGAOFI), acesse Atualizações\Cad Gestão\Parâmetro Marca(OFIPA980).
4. Posicione sobre o registro referente à montadora John Deere e clique em Alterar.
5. Selecione a pasta Integração com Montadora.
6. Os seguintes campos serão utilizados pela rotina de importação:
   1. Cta. Contab. (VE4_CTACTB): será gravado no campo Cta Contabil (B1_CONTA).
   2. Centro Custo (VE4_CENCUS): será gravado no campo Centro Custo (B1_CC).
   3. Armaz.Padrao (VE4_ALMPAD): será gravado no campo Armazem Pad. (B1_LOCPAD).
   4. Grp Item Pad (VE4_GRUITE): será gravado no campo Grupo (B1_GRUPO). Será um grupo temporário, já que o usuário posteriormente irá alterar o grupo de acordo com a sua estrutura de grupo de produtos definida.

ATENÇÃO! Os grupos de peças devem ser definidos e criados no momento da implantação do sistema pelo concessionário. Limite o uso de grupos de peças o máximo possível. O recomendado é não ultrapassar 30 grupos de peças diferentes para as peças John Deere.

1. Forn/Montad (VE4_CODFOR): será gravado no campo Forn. Padrao (B1_PROC).
2. Loja Fornec. (VE4_LOJFOR): será gravado no campo Loja Padrao (B1_LOJPROC).
3. Mesma UF Mon (VE4_FESTCO): será gravado no campo Fora estado (B1_FORAEST).
4. No momento da execução da rotina de importação, o usuário poderá escolher se considerará os campos de TES abaixo para serem gravados nas novas peças:
   1. TES Pad.Ent (VE4_TESENT): será gravado no campo TE Padrao (B1_TE).
   2. TES Pad. Sai (VE4_TESSAI): será gravado no campo TS Padrao (B1_TS).
5. Confirme a alteração.
6. Acesse Atualizações\Peças JD\Import Peças JD (OFINJD01).
7. Clique no botão Param.
8. Na janela aberta, serão exibidos parâmetros a serem preenchidos para a execução da rotina:
   1. Arquivo de Importação: informe o arquivo .DAT disponibilizado pela John Deere através do DTF (Data Transfer Facility), um programa de uso da John Deere que gerencia a transferência dos arquivos entre a concessionária e a John Deere através da internet. O DTF irá baixar estes arquivos e disponibilizá-los. Para exibir a janela de navegação de pastas, deixe o conteúdo do parâmetro em branco e pressione Enter.
   2. Marca: informe o código da marca a ser utilizado nos casos onde há necessidade de inclusão de novas peças. O código informado aqui será utilizado para buscar o cadastro da montadora na rotina Parâmetro Marca (OFIPA980).
   3. Importa TES da marca?: informe se o conteúdo dos campos TES Pad.Ent (VE4_TESENT) e TES Pad. Sai (VE4_TESSAI) da rotina Parâmetro Marca (OFIPA980) serão utilizados para gravação dos campos TE Padrao (B1_TE) e TS Padrao (B1_TS), respectivamente.
9. Confirme o preenchimento dos parâmetros.
10. Clique em OK para dar início ao processo de importação.
11. Vale ressaltar que os Preços e outras informações serão gravados nos campos abaixo:
    1. Preço de Lista: campo Preco Venda (B1_PRV1);
    2. Preço Net: campo Preco Venda2 (B5_PRV2);
    3. Preço Core Exchange Net: campo Preco Venda3 (B5_PRV3);
    4. Preço Core Exchange List: campo Preco Venda4 (B5_PRV4);
    5. Preço Return Credit Net: campo Preco Venda5 (B5_PRV5);
    6. Preço Return Credit List: campo Preco Venda6 (B5_PRV6);
    7. Indicador de Retorno: campo Retornável (B1_REMANE);
    8. Ativo para Compra: campo Pedi Produto (B1_PEDPRO).

ATENÇÃO! Nos casos em que as regras de negócios fizerem uso da tabela SBZ, o ponto de entrada ONJD01AV servirá de auxílio para a atualização das informações necessárias a cada uma das filiais, através do tratamento do vetor aFilis.

1. Também é possível executar esta rotina de forma automática, através do cadastro de schedules do Protheus. Para isso, realize o cadastro do schedule e nos parâmetros da rotina informe: empresa; filial; diretório o qual está armazenado o arquivo a ser gerado; marca; e 1 para importar TES ou 0 para não importar. Exemplo: OFINJD01("01","01","IMP","JD",1), onde “01” é a empresa; “01” filial; “IMP” é o diretório onde está armazenado o arquivo a ser importado; “JD” a marca; e “1” indicando que irá importar TES.

Subst Peças JD (OFINJD02).

1. ATENÇÃO! Vale ressaltar que somente as peças que estão cadastradas na rotina Peças (MATA010) serão consideradas para realização da substituição. Portanto, execute a rotina Import Peças JD (OFINJD01) antes de realizar a importação.
2. No Oficina (SIGAOFI), acesse Atualizações\Peças JD\Subst Peças JD (OFINJD02).
3. Clique no botão Param.
4. Na janela aberta, será exibido o parâmetro a ser preenchido para a execução da rotina:
   1. Arquivo de Importação: informe o arquivo .DAT disponibilizado pela John Deere através do DTF (Data Transfer Facility), um programa de uso da John Deere que gerencia a transferência dos arquivos entre a concessionária e a John Deere através da internet. O DTF irá baixar estes arquivos e disponibilizá-los. Para exibir a janela de navegação de pastas, deixe o conteúdo do parâmetro em branco e pressione Enter.
5. Confirme o preenchimento.
6. Clique em OK para dar início ao processo de importação.
7. Para cada substituição realizada, será criado um registro na rotina Substituic Manual (OFIPA910).