PEDJ0600

PEDJ0600
PEDIDO DE PEÇAS

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.
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>.xcf
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 quando na instalação do "gas", ele foi criado pela TI, e poderia ter outro nome ou estar em outro local. Segue 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:
O programa PEDJ0600 tem as seguintes opções:

• EnvioJD
• RetornoJD
• PosiçãoJD

Envio JD: Permite que o usuário envie um pedidode 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