Histórico da Página

Autent. Webservice Jd Okta (OFIA280)

• 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 - 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 Agendamento (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').

Marcado Vendido (VEIA380)

Essa Rotina 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 Agendamento 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

  • Carga Inicial? Caso seja necessário, marcando como SIM, é possível fazer o envio de uma nova carga inicial. Para mais informações, verifique a aba "Reenvio de Carga Inicial".
    • Inicializador Padrão:NÃO

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

Consulta Log Rest (OFIA262)

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

Reenvio de Carga Inicial:

Caso seja necessário, é possível fazer o envio de uma nova carga inicial.

Para executar o processo:

• Na aba "Perguntas", selecionar a opção "Sim" no parâmetro "Carga Inicial?";
• Na aba "Informações", selecione a opção "Executar".
  
  

Esse processo irá realizar a limpeza do campo (Env. CIFT - VV9_ENVCFT) que controla quais registros deverão ser enviados e automaticamente dará inicio ao Reenvio da Carga Inicial, conforme descrito na aba "Critérios e Lógica de Levantamento".

Dicionário de Dados

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

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

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

• DVARMIL-12489 DT - Adição de novas tags no arquivo do Marcado Vendido (VEIA380)

{
           "Chave": {
                  "DEALER": MV_MIL0005 da Matriz"Codigo Dealer",
       "DATETIME": DD MM AAAA - HH:mm:ss da geração do arquivo,
      "COMAR_NUMBERDATETIME": "VJR_ORDNUM",
      "SERIALxx/xx/xxxx-xx:xx:xx",
            "COMAR_NUMBER": VV1_CHASSI,
      "PRESOLD_DATE": VQ0_DATVEN,
      "NF_SERIE": VV0_NUMNFI + " " + VV0_SERNFI
      "NF_DATE": F2_EMISSAO
    },
    "Atendimento": {
      "ID_ATENDIMENTO": VVA_NUMTRA,
      "STATUS": VV9_STATUS,
      "NOME_VENDEDOR": VAI_NOMTEC,
      "USUARIO_X": VAI_FABUSR
    },
    "Cliente": {
      "TAX_ID_CPF_CNPJ": A1_CGC,
      "CUSTOMER_NAME": A1_NOME,
      "ADDRESS": A1_END,
      "CITY": A1_MUN,
      "STATE": A1_EST,
      "COUNTRY": YA_DESCR,
      "POSTAL_CODE": A1_CEP,
      "PHONE": "+" + A1_DDI + " (" + A1_DDD) + ") " + A1_TEL,
      "EMAIL": A1_EMAIL
    },
    "Financiamento": [
      {
        "FINANCING_TYPE": VSA_TIPO,
        "BANK_NAME": A1_NREDUZ (DEPENDE DA FORMA DE PAGTO)
        "FINANCING_PROCESS_NUMBER": VV0_NFINAM ( APENAS FINAME)
      }
    ]
 "",
            "SERIAL_NUMBER": "CHASSI",
            "PRESOLD_DATE": "xx/xx/xx",
            "DELIVERY_DATE": "xx/xx/xxxx",
            "NF_SERIE": "",
            "NF_DATE": ""
        },
        "Atendimento": {
            "ID_ATENDIMENTO": "000000000",
            "STATUS": "Aprovado",
            "NOME_VENDEDOR": "Vendedor",
            "USUARIO_X": "Usuário",
            "ATENDIMENTO_DATE": "xxxx/xx/xx"
        },
        "Cliente": {
            "TAX_ID_CPF_CNPJ": "03982513000133",
            "CUSTOMER_NAME": "Nome cliente",
            "ADDRESS": "Endereço",
            "CITY": "Cidade",
            "STATE": "Estado",
            "COUNTRY": "",
            "POSTAL_CODE": "",
            "PHONE": "+ () ",
            "EMAIL": ""
        },
        "Financiamento": [
            {
                "FINANCING_TYPE": "Entradas",
                "BANK_NAME": "Banco",
                "FINANCING_PROCESS_NUMBER": "",
                "EXPECTED_RELEASE_DATE": "xx/xx/xxxx"
            }
        ]
    }