Histórico da Página

ATENÇÃO! Como se tratam de rotinas de configurações técnicas do sistema, não insira estas rotinas em menus de usuários. Somente a equipe de T.I. deve ter acesso a estas rotinas!

• No Configurador (SIGACFG) acesse Ambientes/Cadastros/Menu (CFGX013). Informe as novas opções de menu do módulo de Oficina / Auto-Peças / Veículos conforme instruções a seguir:

Os dicionários abaixo, serão criados automaticamente durante a execução do diferencial abaixo:

Criação de Tabela no arquivo Criação de Tabela no arquivo SX2 – Tabelas:

Criação de Campo no arquivo SX3 – Campos:

• Tabela VK5 - Log de Requisições WEB:

Criação de Índices no arquivo SIX – Índices:

• Tabela VCU - Histórico DEF por Campo DEF:

1 - Verifique se o parâmetro MV_MIL0005 está configurado corretamente para cada filial do sistema.

2 - Configure o MaxStringSize no appserver.ini

MaxStringSize - TOTVSTEC - TDN - Configuração Indicada:

[general]

maxStringSize=500

3 - Configure o MemoMega no appserver.ini

MemoMega - TOTVSTEC - TDN - Configuração Indicada:

[DBAccess]

MemoMega=100

4 - Acesse o Protheus com um usuário configurado com permissão / perfil de administrador.

5 - No Modulo Veículos (SIGAVEI) acesse Atualizações\Cad Gerais\Tab. Gener. Conces. (OFIOA560) para que os novos registros padrão da tabela VX5 sejam criados.

Image Added

Configuração do Autenticador

1 - Acesse a rotina Atualizações\Geral John Deere\Autent. WebService JD OKTA (OFIA280).

2 - Será exibida a janela para configuração do autenticador.

3 - Na aba denominada Geral serão informados os dados das credenciais de autenticação enviados pela John Deere para cada concessionário. Desta forma, os campos Client ID, Client Secret e Redirect URI deverão ser passados pela John Deere ao concessionário, conforme explicado no passo 1 da seção Parametrizações. Com as informações disponibilizadas pela John Deere em mãos, preencha os campos desta aba. Após cadastrar estas informações, clique em Confirmar para salvar.

4 - Todas as outras abas correspondem as integrações específicas da John Deere. Vale ressaltar que para ligar e desligar o oAuth2.0/OKTA, cada integração possui um campo denominado oAuth2 que possui as opções 0=Não e 1=Sim. Como padrão, todas as integrações virão desligadas (0=Não).

5 - Para realizar a mudança de forma de autenticação para o OKTA, basta:

a. Acesse a aba correspondente a integração desejada;

b. Preencha o campo oAuth2 com 1=Sim;

c. Clique em Confirmar para salvar a alteração;

d. Saia/Feche o Protheus;

e. Acesse o Protheus novamente para integrar utilizando oAuth2.0/OKTA.

6 - As integrações da John Deere com o concessionário que foram afetadas no Protheus estão listadas abaixo:

a. Aba Garantia: Solic. Garantia JD (OFINJD15) / Cons. Garantia JD (OFICJD01) / Atualiza Status SG (OFINJD26);

b. Aba JDPoint: Pedido de Peças JD (OFINJD10);

c. Aba JDQuote2: Cotações JDQuote (VEIA110) / PO JDQuote (VEIA112) / Importação de Cotações (VEIA113) / Painel JDQuote (VEIA114);

d. Aba Nota Fiscal de Compra: Relac. NF x Pedido (OFINJD22).

e. Aba DTFGETAPI: Configurações para conseguir o Token para efetuar GET na API.

1=Sim;

c. Aba DTFGETAPI: Configurações para conseguir o Token para efetuar GET na API.

i. URL Token: o endereço URL onde será obtido o token de autenticação;

preencher com: https://sso.johndeere.com

ii. Auth Server: o nome do servidor de autenticação para cada integração específica;

preencher com: aus9k0fb8kUjG8S5Z1t7

iii. URL Auth: o endereço URL do servidor de autenticação;

preencher com: /v1/token

iv. Escopo: o escopo de conexão definido para cada integração específica;

preencher com: dtf:dbs:file:read

v. URL WS: endereço URL do webservice para cada integração específica

preencher com: https://servicesext.deere.com/dtfapi/

df. Aba DTFPUTAPI: Configurações para conseguir o Token para efetuar PUT na API.

7 - Além do campo oAuth2, todas as outras abas possuem o mesmo padrão de campos que remetem a informações necessárias para utilização do oAuth2.0/OKTA, cujos campos estarão preenchidos automaticamente, dispensando qualquer alteração/atualização de seus conteúdos. A saber:

PUT na API.

i. URL Token: o endereço URL onde será obtido o token de autenticação;

preencher com: https://sso.johndeere.com

ii. Auth Server: o nome do servidor de autenticação para cada integração específica;

preencher com: aus9k0fb8kUjG8S5Z1t7

iii. URL Auth: o endereço URL do servidor de autenticação;

preencher com: /v1/token

iv. Escopo: o escopo de conexão definido para cada integração específica;

preencher com: dtf:dbs:file:write

v. URL

WS:

endereço URL do

webservice para cada integração específica

preencher com: https://servicesext.deere.com/dtfapi/

e. Clique em Confirmar para salvar a alteração;

f. Saia/Feche o Protheus;

g. Acesse o Protheus novamente para integrar utilizando oAuth2.0/OKTA

d. Escopo: o escopo de conexão definido para cada integração específica;

e. URL WS: endereço URL do webservice para cada integração específica.

IMPORTANTE: Para mais informações referentes ao OKTA, acesse o link: https://tdn.totvs.com.br/pages/releaseview.action?pageId=553893397

Image Added

Image Added

Configuração do Diretórios

1 - Acesse a rotina Atualizações\Geral John Deere\Configura diretórios Diretórios DTF API John Deere (OFIA410).

2 - Será exibida a janela para configuração dos diretórios.

3 - Estes diretórios serão utilizados para o recebimento e envio dos arquivos contemplados pelo DTF. Teremos pastas específicas para cada um dos tipos de arquivos contemplados. Abaixo assuntos e tipos de arquivos interpretados.

a. SetHost - Endereço do host da API DTF

b. CGPoll - "RECEIPTS_"

c. Cotacao_Maquina - "DLR2JD_*.JDQUOTE"

d. PMMANAGE - "DLR2JD_*.DAT"

e. DPMEXT - "DLR2JD_DPMEXT*.DPM"

f. Warranty - "JD2DLR_*_WARRMEMO_*.XML"

g. Incentivo_Maquina - "*.BRCMAMT" e "*.BRSLERR"

h. JDPRISM - "JD2DLR_DPMORD_*.DAT", "JD2DLR_DPMSCHED_*.DAT" e "JD2DLR_DPMXFER_*.DAT"

i. Parts_Info - "PARTINFO_BR_ALL_FULL_V2_*.DAT"

j. Parts_Locator - "DLR2JD_*.DAT"

k. Authorized_Parts_Returns - "*RETATH*.XML"

l. Parts_Surplus_Returns - "DLR2JD_*.DAT"

m. Parts_Subs - Parts Subs - "PARTSUBS_NA_ALL_FULL_*.DAT"

n. SMManage - SMManage - "DLR2JD_*.DAT"

o. DFA - "Definido pelo usuário"

p. ELIPS - "DLR2JD_ELIPS_Hist_*.XML" e "DLR2JD_ELIPS_Delta_*.XML"

q. NAO_CLASSIFICADOS - Para recebimento de arquivos não catalogados.

4 - Estes diretórios e o endereço do Host estarão preenchidos automaticamente, dispensando qualquer alteração/atualização de seus conteúdos.

a. Clique em Confirmar para salvar a alteração;

Abaixo assuntos e tipos de arquivos interpretados.

a. CGPoll - "RECEIPTS_"

b. Cotacao_Maquina - "DLR2JD_*.JDQUOTE"

c. PMMANAGE - "DLR2JD_*.DAT"

d. DPMEXT - "DLR2JD_DPMEXT*.DPM"

e. Warranty - "JD2DLR_*_WARRMEMO_*.XML"

f. Incentivo_Maquina - "*.BRCMAMT" e "*.BRSLERR"

g. UP_Incentivo_Maquina - "*.BRSLDAT" e "*.BRCMDAT"

h. JDPRISM - "JD2DLR_DPMORD_*.DAT", "JD2DLR_DPMSCHED_*.DAT" e "JD2DLR_DPMXFER_*.DAT"

i. Parts_Info - "PARTINFO_BR_ALL_FULL_V2_*.DAT"

j. Parts_Locator - "DLR2JD_*.DAT"

k. Authorized_Parts_Returns - "*RETATH*.XML"

l. Parts_Surplus_Returns - "DLR2JD_*.DAT"

m. Parts_Subs - Parts Subs - "PARTSUBS_NA_ALL_FULL_*.DAT"

n. SMManage - SMManage - "DLR2JD_*.DAT"

o. DFA - "Definido pelo usuário"

p. ELIPS - "DLR2JD_ELIPS_Hist_*.XML" e "DLR2JD_ELIPS_Delta_*.XML"

q. NAO_CLASSIFICADOS - Para recebimento de arquivos não catalogados.

4 - Estes diretórios e o endereço do Host estarão preenchidos automaticamente, dispensando qualquer alteração/atualização de seus conteúdos.

a. Acesse o RootPath onde do Protheus e verifique se já existe o diretório "\DTF".

i. Caso já exista, renomeie o diretório para "\DTF_SALVA".

ii. Caso não exista, ele será criado automaticamente.

b. Clique em Confirmar para criar os diretórios;

i. Os diretórios serão criados conforme a descrição dos campos da rotina.

ii. Dentro de cada um, será criada um diretório com o numero dos Dealers.

Ex: \DTF\COTACAO_MAQUIA\201010\

cb. Saia/Feche o Protheus;

Image Added

Agendamento de Execução Automática

1. No Configurador (SIGACFG), acesse Ambiente\ Schedule\ Schedule (CFGA010).

2. Aqui deverão ser atualizados os seguintes agendamentos referentes a processos para execução automática:

a. OFIA411 – DTF API RESTJohn Deere - OFIA411: inclua este novo agendamento conforme abaixo:

i. Usuário: 000000 (Administrador);

ii. Rotina: OFIA411;

iii. Empresa/Filial: selecione apenas a Empresa e suas filiaisMatriz;

iv. Módulo: 41 (Auto- Peças);

v. Recorrência: ao clicar neste botão, selecione a opção Sempre ativo.Informe Diário a cada 1 dia.

vi. Intervalo: 12 execuções por dia com intervalo de 02hr.

Image Added

Chamadas Pontuais para envio e recebimento de arquivos

Foram disponibilizadas rotinas para efetuar a chamada pontual da API, tanto para envio quanto para recebimento de arquivos.

1 - Download(recebimento de arquvivosarquivos)

a - Painel Pedidos Imp. CGPoll JD (VEIA160)

i. CGPoll(RECEIPTS_*.DAT)

Image Added

b - Solicitação de Garantia ( OFINJD15 )

i . Garantia(JD2DLR_*_WARRMEMO_*.XML).

Image Added

c - Trans/Recep de NFs (VEIVM200)

i. Incentivos Máquinas(*.BRCMAMT)

ii. Incentivos Máquinas(*.BRSLERR)

Image Added

d - Config JDPrism DPM (OFINJD35)

i. JDPRISM(DPMORD)

ii. JDPRISM(DPMSCHED)

iii. JDPRISM(DPMXFER)

Image Added

e - DTF  DTF API REST John Deere (OFIA411)

i. Lista Preço Peças(PARTINFO_BR_ALL_FULL_V2_*.DAT)

ii. Recompra de Peças(*RETATH*.XML)

iii. Substituição Peças(PARTSUBS_NA_ALL_FULL_*.DAT)

Image Added

2 - Upload(envio de arquivos)

a - DTF  DTF API REST John Deere (OFIA411)

i. Cotação Máquinas(DLR2JD_*.JDQUOTE)

ii. Localizador Peças(DLR2JD_*.DAT)

iii. Recompra de Peças(DLR2JD_*.DAT)

iv. SMManage(DLR2JD_*.DAT)

v. DFA(Definido pelo usuário)

vi. ELIPS(DLR2JD_ELIPS_Hist_*.XML)

vii. ELIPS(DLR2JD_ELIPS_Delta_*.XML)

Image Added

b - Config JDPrism DPM (OFINJD35)

i. DPM PMMANAGE(DLR2JD_*.DAT)

ii. DPM DPMEXT(DLR2JD_DPMEXT*.DPM)

Image Added

c - Trans/Recep de NFs (VEIVM200)

i. Inventivos Máquinas(*.BRSLDAT)

ii. Inventivos Máquinas(*.BRCMDAT)

Image Added

Consulta Status das APIs e chamadas pontuais

Criada rotina DTF rotina DTF API REST John Deere (OFIA411). Nesta, é possível acompanhar o status dos serviços da API do DTF.

Também é possível fazer a chamada pontual de todos as integrações disponíveis via DTF.

O botão "TODOS" efetua a chamada em batch de todos os assuntos.

Image Added

Consulta de Logs

Disponibilizada na rotina Consulta de Logs rotina Log DTF API John Deere (OFIA262).

Nesta é possível visualizar de forma simples os logs oriundos das chamadas ao DTF.

Disponibilizado filtro para listar os Logs da API DTF.

FileUpload:

Req. Cab.

Contem o token de autorização do OKTA.

Req. Body.

Contem o caminho completo do arquivo transmitido.

Resp. Cab.

Conteúdo do arquivo transmitido.

Resp. Body.

Contem a resposta da API.

No caso de erro, aqui é gravado o tipo e solução sugerida.

FileList:

Req. Cab.

Contem o token de autorização do OKTA.

Req. Body.

nil

Resp. Cab.

Contem a resposta da API.

Resp. Body.

Conteúdo do arquivo Json, que possui a lista de arquivos disponibilizados para Download.

No caso de erro, aqui é gravado o tipo e solução sugerida.

FileList:

Req. Cab.

Contem o token de autorização do OKTA.

Req. Body.

Caminho e nome do arquivo baixado.

Resp. Cab.

Contem a resposta da API.

Resp. Body.

Conteúdo do arquivo baixado.

No caso de erro, aqui é gravado o tipo e solução sugerida.

OBS: Tamanho do arquivo restrito ao máximo de um campo Memo.

Image Added

Lista de erros:

Arquivos e processos de integração contemplados pelo DTF