Histórico da Página

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

Dados à serem gerados:

O levantamento parte da tabela de Atendimento (VVA) e também há integração com outras tabelas conforme abaixo:

• VV0 - Saídas de Veículos
• VQ0 - Pedido de Veículos
• VJR - Complemento Pedido John Deere
• VV1 - Cadastro de Veículos
• VE1 - Marcas  
• VV9 - Recepção Clientes/Visitantes
• SA1 - Clientes
• SYA - Países
• VAI - Técnicos
• SF2 - Cabeçalho das NF de Saída

Atenção: Os Pedido de Veículos (VQ0) com status CANCELADO (VQ0_STATUS = 3), NÃO serão considerados no levantamento das informações para geração do arquivo.

Uma informação de grande importância é a data de Marcado Vendido (campo "Vendido em" - VQ0_DATVEN ) que deve ser preenchida através da rotina Painel Pedidos Compra Máquina JD (VEIA162).

Regras para geração do arquivo:

• O levantamento é feito apenas para máquinas/veículos novos da marca John Deere (JD, GRS, PLA, JDC, HCM).
• Para que um atendimento seja considerado na geração do arquivo, é necessário que contenha, obrigatoriamente, as seguintes informações:
  • O Cliente (SA1);
  • Máquina/Veículo (VV1) (por exemplo, um Pedido de Máquina) devidamente cadastrados;
  • "Comar Code" (VJR_ORDNUM) informado no pedido ou "Chassi" (VV1_CHASSI) informado no atendimento;
  • O Vendedor (SA3) informado no atendimento deverá possuir cadastro na Equipe Técnica (OFIOA180) e o correto relacionamento através do campo "Cod Vendedor" (VAI_CODVEN).
  
  Obs.: Atendimentos do tipo "Venda Futura" e "Venda Direta" NÃO serão considerados na geração do arquivo.

Regras para envio dos atendimentos:

• Os Atendimentos Faturados e Cancelados serão enviados apenas uma vez.
• Já os Atendimentos Em Aberto serão enviados continuamente até que seu status mude para Faturado ou Cancelado.

Primeira Execução (Execução Carga Inicial)

• A lógica considera uma Data de Corte (D-15 dias) da data atual, conforme definido pela John Deere.
• São marcados para envio os registros (flag VV9_ENVCFT = '0'):
  • Todos os atendimentos Faturados nos últimos 15 dias.
  • Todos os atendimentos Em Aberto, independentemente da data.

Execuções Posteriores (Recorrentes)

• Executadas conforme agendador (Schedule) do sistema (frequência definida em documentação).

Considerando:

• • Todos os atendimentos Em Aberto.
  • Faturados e Cancelados que ainda não foram enviados (VV9_ENVCFT = '0').

A Rotina Marcado Vendido (VEIA380) tem por objetivo gerar e enviar as informações de Marcado Vendido para a API de integração (CIFT).

•  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 enviados? Diretório para o qual serão movidos os arquivos que forem enviados com sucesso.
    Formato sugerido:enviados

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

• Na aba "Log de Processos" é possível visualizar o histórico de execuções da rotina:

• 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.".

Limpeza de Flag de Envio:

Caso seja necessário, é possível fazer uma limpeza na flag que controla o envio dos arquivos, permitindo que  seja gerada de uma nova carga inicial.

Para executar o processo:

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

• Tabela VV9- (Recepção Clientes/Visitantes):

Criação de Pergunte no arquivo SX1 – Pergunta: