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:

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 RemovedImage 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.

f. 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:

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

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

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

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

Configuração do Diretórios

1 - Acesse a rotina Atualizações\Geral John Deere\Configura diretórios DTF API (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;

b. Saia/Feche o Protheus;

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 REST: inclua este novo agendamento conforme abaixo:

i. Usuário: 000000 (Administrador);

ii. Rotina: OFIA411;

iii. Empresa/Filial: selecione a Empresa e suas filiais;

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

v. Recorrência: ao clicar neste botão, selecione a opção Sempre ativo.

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 arquivos)

a - Painel Pedidos Imp. CGPoll JD (VEIA160)

i. CGPoll(RECEIPTS_*.DAT)

b - Solicitação de Garantia ( OFINJD15 )

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

c - Trans/Recep de NFs (VEIVM200)

i. Incentivos Máquinas(*.BRCMAMT)

ii. Incentivos Máquinas(*.BRSLERR)

d - Config JDPrism DPM (OFINJD35)

i. JDPRISM(DPMORD)

ii. JDPRISM(DPMSCHED)

iii. JDPRISM(DPMXFER)

e - DTF API REST (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)

2 - Upload(envio de arquivos)

a - DTF API REST (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)

b - Config JDPrism DPM (OFINJD35)

i. DPM PMMANAGE(DLR2JD_*.DAT)

ii. DPM DPMEXT(DLR2JD_DPMEXT*.DPM)

Consulta Status das APIs e chamadas pontuais

Criada rotina DTF API REST (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.

Consulta de Logs

Disponibilizada na rotina Consulta de Logs (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.

Lista de erros:

Arquivos e processos de integração contemplados pelo DTF