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
Campo | Preenchimento |
Identificação | PMLINK |
Descrição | Envio de pedidos de compra ao PMLink |
Versão MSG | 1.0 |
Url Produção | |
Url Homologado |
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
Campo | Preenchimento |
Identificação | ORDERSTATUS |
Descrição | Atualizar o estado de compra ao PMLink (Retorno) |
Versão MSG | 1.0 |
Url Produção | |
Url Homologado |
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.
Parametrizações no CADA3100:
Cadastras as novas URLS utilizadas nos processo como as imagens abaixo:
URL TOKEN - A John Deere vai fornecer as URL's de Homologação e Produção, que devem ser cadastrados com a Identificação TdOKEN_OKTA.
URL AUTH - A John Deere vai fornecer as URLs de Homologação e Produção, que devem ser cadastrados com a Identificação OKTA_AUTHN.
URL CODE - A John Deere vai fornecer as URL's de Homologação e Produção, que devem ser cadastrados com a Identificação OKTA_CODE.
Devemos também parametrizar as novas URL's dos WebServices da John Deere, com as Identificações abaixo.
OrderStatus:
PMLink:
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.
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