Assunto

O programa PEDJ0600 insere os pedidos de peças para o Deere System através de arquivo XML, fornecendo a integração dos pedidos de venda com o sistema PMLink com base no programa PEDC0600.

Abrangência 

Programa de uso exclusivo para concessionários da montadora JOHN DEERE.

Requisitos 

Para a correta integração com o sistema PMLink é necessário configurar a biblioteca jd.jar atualizada de acordo com as instruções abaixo:

• Instalação do arquivo jd.jar

O arquivo de configuração do banco de dados fica no diretório: 
/usr/local/genero/gas/app/<nome_da_instância>.xcf0

Geralmente temos a instância treino e a standard (de produção). Somente pessoas com conhecimento de Linux e permissão de acesso, podem alterar estes arquivos.
Editar estes arquivos e na tag <ENVIRONMENT_VARIABLE Id="CLASSPATH">, acrescente no final o caminho onde encontramos os arquivos que fazem a comunicação com o WebService da John Deere. Veja o exemplo: 

<ENVIRONMENT_VARIABLE
Id="CLASSPATH">/usr/local/genero/poi.jar:/usr/local/genero/fgl/lib/fgl.jar:
/usr/local/genero/gas/lib/jd.jar:/usr/local/genero/gas/lib/axis.jar:/usr/local/ genero/gas/lib/commons-codec.jar:/usr/local/genero/gas/lib/commons-discovery-0.2.jar:/usr/local/genero/gas/lib/commons-logging.jar:/usr/local/genero/gas/lib/javax.wsdl_1.6.2.v201012040545.jar:/ usr/local/genero/gas/lib/jaxrpc.jar:/usr/local/genero/gas/lib/org.apache.co mmons.logging_1.0.4.v201101211617.jar
</ENVIRONMENT_VARIABLE>

O diretório /lib, não é um diretório que foi criado na instalação do "gas", ele foi criado pela TI, e poderia ter outro nome ou estar em outro local. Seguem os arquivos do diretório /usr/local/genero/gas/lib:

-rwxr-xr-x 1 root root 1.6M Oct 13 13:42 axis.jar
-rwxr-xr-x 1 root root 70K Oct 13 13:42 commons-discovery-0.2.jar
-rwxr-xr-x 1 root root 32K Oct 13 13:42 commons-email-1.2.jar
-rwxr-xr-x 1 root root 1.9M Oct 13 13:42 itext-1.4.8.jar
-rwxr-xr-x 1 root root 165K Oct 13 13:42
javax.wsdl_1.6.2.v201012040545.jar
-rwxr-xr-x 1 root root 31K Oct 13 13:42 jaxrpc.jar
-rwxr-xr-x 1 root root 1.4M Oct 16 20:19 jd.jar
-rwxr-xr-x 1 root root 45K Oct 13 13:42
org.apache.commons.logging_1.0.4.v201101211617.jar 

Das bibliotecas .jar acima, a jd.jar é a que possui as classes java que fazem a comunicação WebService dos diversos processos, como a OrderStatus e SubmitOrder pertencente a PEDC0600, AdvanceShipNotice pertencente ao ENTR1000, a WarrantyMemo da Garantia e assim por diante. As demais .jar foram importadas da JD.

• Cadastro do endereço do WebService do PMLink e do ORDERSTATUS da John Deere

Para o cadastro, tanto quanto do WebService quanto do ORDERSTATUS, é necessário inserir o endereço no programa CADA3100 com sua "Identificação" como visualizado abaixo. Para mais fácil compreensão sobre como preencher os campos para o cadastro, visualize as telas e tabelas abaixo: 

WebService do PMLink

Link para produção: https://parts.deere.com/dns/services/PMLinkWS_1_2
Link para testes: https://parts.tal.deere.com/dns/services/PMLinkWS_1_2 

ORDERSTATUS da John Deere

Link para produção: https://parts.deere.com/dns/services/OrderStatusWS_1_2
Link para testes: https://parts.tal.deere.com/dns/services/OrderStatusWS_1_2 




Telas:
WebService do PMLink 

 

ORDERSTATUS da John Deere 

• Cadastro de usuário e senha

É necessário inserir o usuário e a senha com permissão para o cadastro de pedido de venda através do programa CADA3300 e com a identificação PMLINK para o envio e ORDERSTATUS para o retorno. Conforme as telas abaixo.

• PEDC0500 – Manutenção Pedido de Compra

É também necessário a inclusão de um pedido de compra no programa PEDC0500 com Capa e Itens, conforme as telas abaixo.
Capa:

Itens:

Após a migração da John Deere para plataforma de gerenciamento de acesso do seu portal JDPoint  para a Okta, foram implementadas algumas alterações neste programa, nos processos de comunicação com a montadora John Deere, para que esse processo recebesse o novo método de autenticação OAuth 2.0.

Para que o processo de comunicação com a montadora seja realizada, devemos realizar algumas parametrizações no CADA3100 (Cadastro de URL para Webservices) e no CADA3300 (Cadastro de Usuário JD), conforme demonstrado abaixo.

As parametrizações que deveria ser realizadas no CADA3100 são realizadas via DIALIB. Mas caso existam dúvidas favor consultar a documentação Okta Migration | Descrição de Processo | Sisdia/LinxMaq.

Parametrizações do CADA3300:

Cadastro de Client_ID e Secret

O client_ID deve ser inserido no campo Usuário JD e o Secret deve ser informado no campo de Senha JD, lembrando que todas essas informações URLS, Client_ID e secret são fornecidos pela John Deere.

Opções do programa 

O programa PEDJ0600 tem as seguintes opções:

ENVIO JD

Permite que o usuário envie um pedido de compras existente no sistema para o PMLink.
No nosso exemplo utilizaremos o pedido de compra 16. A tela de envio é composta pelos seguintes campos:

 
Campos:

• Filial: Código da filial para a qual foi feito o pedido a ser enviado.
• Pedido Compra: Número do pedido de compra a ser enviado.
• Transportado: Código do transportador (Ship Method)
• Pedido Fábrica: Número do pedido da fábrica associado pela JD ao pedido de compra enviado.
• Mensagem: Mensagem de confirmação do pedido.

Após confirmar o envio do pedido de compra de número 16 para o JDPoint aparecerá uma tela pop-up com a mensagem:
"Pedido atualizado com sucesso!". Conforme tela abaixo: 
 
Após clicar no botão "Ok" do pop-up, a tela de envio do PEDJ0600 apresenta o número de pedido da fábrica e a mensagem padrão da montadora. No nosso caso o "Pedido Fábrica" é 2003004349 e a mensagem é "Accepted Order, check order status in JDPoint. "conforme tela abaixo: 
 
Possíveis erros após a tentativa de envio:

• Error - Userid not Authorized: Ocorre quando o usuário não está autorizado a submeter o pedido.
• Error - Missing or Incorrect Dealer Account: Ocorre quando o usuário está incorreto ou não existe.
• Error - Missing or Incorrect Order Type: Ocorre quando o tipo de ordem especificado está incorreto ou não existe.
• Error - XML Not Valid: Ocorre quando o código XML gerado após a confirmação contém erros.

RETORNO JD

Permite que o usuário atualize o estado de um pedido de vendas já submetido ao PMLink.

 
Campos:

• Filial: Código da filial para a qual foi feito o pedido a ser atualizado.
• Pedido Compra: Número do pedido de compra a ser atualizado.
• Usuário JD: Código do usuário que tem permissão na JD para atualização dos dados dos pedidos.
• Pedido Fábrica: Número do pedido da fábrica associado pela JD ao pedido de compra enviado.
• Mensagem: Mensagem de confirmação do pedido.

Após a confirmação da mensagem de confirmação de atualização do status do pedido de compra, aparece na tela um pop-up com a mensagem: "Status Atualizado com sucesso!". Conforme tela abaixo:

Após clicar no botão "Ok" do pop-up, a tela de retorno do PEDJ0600 apresenta o número de pedido da fábrica e a mensagem padrão da montadora. No nosso caso o "Pedido de Fábrica" é 2003004349". Conforme tela abaixo: 
 

Possíveis erros após a tentativa de atualização:

• Error - Unauthorized User: Ocorre quando o usuário não está autorizado a realizar essa operação.

Observação: Tanto para o retorno quanto para o envoi, o processo grava arquivos no diretório 'logs' no formato texto. O nome de cada arquivo é:

• Para o envio: pedj0600_envio_xxxxxxx_aaaammddhhmmss.log

Ex: pedj0600_envio_0000000030_20150806121125.log

• Para o retorno: pedj0600_retorno_xxxxxxx_aaaammddhhmmss.log

Ex: pedj0600_retorno_0000000030_20150806121537.log
Onde: xxxxxx é o número do pedido de compra e aaaammddhhmmss é a data e hora da solicitação. 

Em caso de cancelamento de itens no pedido, o programa apresenta uma mensagem informativa no rodapé da tela para cada item e ao final mostra o total de itens cancelados para o pedido carregado.

POSIÇÃO JD

Esta opção gerará um relatório que informará ao usuário a posição de seus pedidos de compra junto a John Deere de acordo com as informações que foram atualizadas a partir da opção "Retorno JD". 

 
Campos:

• Filial: Código da filial para a qual foram gerados os pedidos a serem listados.
• Pedido Compra: Número do pedido de compra a ser listado.
• Previsão Entrega: Intervalo de datas referente à previsão de entrega dos pedidos.

Após a confirmação para gerar o relatório o sistema gera um relatório como o representado abaixo:

Comprovação que o pedido foi enviado à "John Deere":

• O programa considera a instância atual, cadastrada no CADA3200 (tabela CAINSTAN) para determinar qual a URL de retorno, podendo ela assumir dois valores: Treino ou Produção.

• Para o PEDC0510, contempla os seguintes parâmetros:

1 IS EI ESTOQUE INICIAL – PMLINK1S
1 MD MP MAQUINA PARADA – PMLINK1S
1 SO PP PEDIDO PROGRAMADO – PMLINK 1 S
1 TS PR PEDIDO PROMOCIONAL – PMLINK1 S
1 WO PG PEDIDO GARANTIA – PMLINK 1 S

Solução de problemas