totvs-customtotvs-custom-tabs-box-items |
---|
default | no |
---|
referencia | ConfiguraçãoDeDiretórios |
---|
|
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 DTFb. CGPoll - "CGPoll - "RECEIPTS_" cb. Cotacao_Maquina - "DLR2JD_*.JDQUOTE" dc. PMMANAGE - "DLR2JD_*.DAT" ed. DPMEXT - "DLR2JD_DPMEXT*.DPM" fe. Warranty - "JD2DLR_*_WARRMEMO_*.XML" gf. 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. Clique em Confirmar para salvar a alteração; b. Saia/Feche o Protheus; |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | AgendamentoExecuçãoAutomática |
---|
|
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.
Totvs custom tabs box items |
---|
default | no |
---|
referencia | EnvioERecebimentoDeArquivo |
---|
|
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 arquvivos)
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)
Totvs custom tabs box items |
---|
default | no |
---|
referencia | ConsultaStatus |
---|
|
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.
Totvs custom tabs box items |
---|
default | no |
---|
referencia | ConsultaLogs |
---|
|
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:
Error Code | HTTP Status & Code | Message |
---|
FileAttachmentMissing | Bad Request (400) | File Attachment not found |
Not Found | Not Found(404) | No message available |
DealerPathNotFound | Not Found (404) | The specified dealer path doesn't exist: [Parent id] |
FileAlreadyExists | Conflict (409) | The specified file already exists |
insufficient_scope | Forbidden (403) | Insufficient scope for this resource |
FileIOException | Internal Server Error (500) | The specified file not able to write to the specified resource path |
In case of no file found, we return 200 (OK) with empty message | 200 (OK) | DealerSetupNot Found | Not Found (404) | Dealer setup does not exist. |
insufficient_scope | Forbidden (403) | Insufficient scope for this resource |
ServiceUnavaila ble | Internal Server Error (500) | Unable to process your request. |
FileNotFound | Not Found (404) | Specified File does not exist. |
NotReadble | Forbidden (403) | Unable to read the file. |
insufficient_scope | Forbidden (403) | Insufficient scope for this resource |
ServiceUnavailable | Internal Server Error (500) | Unable to process your request |