Configurações, Rotina Marcado Vendido (VEIA380), Consulta Status da Execução, Dicionário
ids
passo1,passo2,passo3,passo4
Totvs custom tabs box items
default
yes
referencia
passo1
Na rotina Integração John Deere - Configurações OKTA - John Deere (OFIA280) foi criada uma nova aba (CIFTAPI) na qual deverão ser informados os dados para a configuração da integração com o CIFT.
No campo URL Token deverá ser informada a URL onde será obtido o token de autenticação.
No campo Auth Server deverá ser informado o Servidor de Aplicação onde será obtido o token de autenticação.
No campo URL Auth deverá ser informado o Complemento do Caminho onde será obtido o token de autenticação.
No ca mpo Escopo deverá ser informado o Escopo da integração.
No campo URL WS deverá ser informada a URL onde será efetuada a integração.
No campo Client ID deverá ser informado o ID para obtenção do token de autenticação.
No campo Client Secret deverá ser informada a Senha para obtenção do token de autenticação.
Aviso
Essas informações são de responsabilidade dos concessionários e deverão ser fornecidas pelo Analista de Implantação da John Deere.
Totvs custom tabs box items
default
no
referencia
passo2
A Rotina Marcado Vendido (VEIA380), tem por objetivo gerar e efetuar o envio das informações Marcado Vendido para a API de integração.
Através do botão "Agendar", é possível programar a execução da rotina pelo Schedule do Protheus. Ressalta-se que a rotina foi desenvolvida para suportar execução automática por meio do agendador e orientamos que tenha a recorrência de execução de uma vez ao dia.
Na aba "Perguntas", é possível definir os parâmetros necessários para a execução da rotina:
Dir. geração de arquivos? Diretório onde os arquivos gerados serão salvos para posterior envio à integração. O envio será feito a partir deste diretório. Formato sugerido:/diretorio/
Dir. arquivos importados? Diretório para o qual serão movidos os arquivos que forem enviados com sucesso. Formato sugerido:importados
Após a parametrização da rotina conforme descrito no tópico anterior, é possível executá-la manualmente. Para isso, acesse a aba "Informações"e clique no botão "Executar";
Ao executar, a rotina irá gerar no diretório informado no primeiro parâmetro (Dir. geração de arquivos?), um arquivo seguindo o padrão "DLR2JD_MARKSOLD_*.json"; Observação: O asterisco (*) representa informações específicas da geração, como o código do dealer e a data/hora em que o arquivo foi gerado. Por exemplo: dlr2jd_marksold_010101_20250704_170853.
Após geração, a rotina executará automaticamente uma varredura no diretório indicado do passo anterior no primeiro parâmetro e realizará a integração/envio do arquivo para o CIFT, movendo os arquivos enviados com sucesso para o diretório informado no segundo parâmetro.
Aviso
O arquivo somente será movido para pasta informada no segundo parâmetro (Dir. arquivos importados?), caso o retorno da API seja positivo, caso contrário, ele permanecerá no diretório de geração para que seja enviado numa execução posterior.
Na aba "Log de Processos" é possível visualizar o histórico de execuções da rotina.
Totvs custom tabs box items
default
no
referencia
passo3
Aviso
title
Atenção!
O status do processo, pode ser conferido através da rotina Consulta Log Rest (OFIA262) filtrando as colunas "Tipo de Dado" igual a CIFT e "Tabela Ori." igual a VEIA380.
Caso o envio não seja bem sucedido, a mensagem de erro retornada será exibida nos campos "Resp. Cab". e "Resp. Body".
Caso o envio seja bem sucedido, os campos "Req. Cab". e "Req. Body" serão preenchidos com as informações que foram enviadas ao CIFT;
O campo "Resp. Cab". será preenchido com o nome do arquivo gerado e o campo "Resp. Body" apresentará a mensagem "Arquivo enviado, verificar código do retorno.".
Totvs custom tabs box items
default
no
referencia
passo4
CriaçãodeCampo no arquivo SX3 – Campos:
Tabela VV9- (Recepção Clientes/Visitantes):
Campo
VV9_ENVCFT
Tipo
C
Grupo de Campos
Ordem
40
Tamanho
1
Decimal
0
Formato
@!
Contexto
R
Propriedade
V
Título
Env. CIFT
Descrição
Enviar ao CIFT
Val. Sistema
Pertence('01')
Opções
0=Sim;1=Não
Inic. Padrão
"0"
Inic. Browse
Cons. Padrão
Nível
Usado
NAO
Obrigatório
NAO
Browse
NAO
When
Pasta
Help
Indica se o atendimento deverá ou não ser enviado para integração com o CIFT.