...
Essa rotina pode ser executada de forma automatizada por meio do agendador (Schedule) do sistema.
| Nota |
|---|
| title | INFORMATIVOInformativo |
|---|
|
O CIFT é uma nova API REST de integração da John Deere e não está relacionado à API DTF, ou seja, são APIs distintas. |
...
| Totvs custom tabs box |
|---|
| tabs | 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 enviar as informações 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 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 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. As informações relacionadas ao status de execução podem ser verificadas na aba "Consulta Status da Execução". |

- 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 |
|---|
| 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ção de Campo 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. |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | VEIA380 | VEIA380 |
|---|
Ordem | 01 | 02 |
|---|
Pergunta | Dir. geração de arquivos? | Dir. arquivos importados? |
|---|
Tipo | C | C |
|---|
| Tamanho | 99 | 99 |
|---|
| Decimal |
|
|
|---|
| Var01 | MV_PAR01 | MV_PAR02 |
|---|
| Formato |
|
|
|---|
| Validação |
|
|
|---|
| Objeto | G | G |
|---|
| Consulta Padrão |
|
|
|---|
| Pré-Seleção (Combo) |
|
|
|---|
| Item 1 |
|
|
|---|
| Item 2 |
|
|
|---|
| Item 3 |
|
|
|---|
| Item 4 |
|
|
|---|
| Item 5 |
|
|
|---|
| Help |
|
|
|---|
|
|
...