01. DADOS GERAIS
| Produto: | |
|---|
| Linha de Produto: | |
|---|
| Segmento: |  Varejo Lojas
|
|---|
| Módulo: | 







TOTVS DMS (Linha Protheus) - Oficina (SIGAOFI) TOTVS DMS (Linha Protheus) - Veiculos (SIGAVEI) TOTVS DMS (Linha Protheus) - Auto-Peças (SIGAPEC) |
|---|
| Função: | VEIA380 |
|---|
| País: | Brasil |
|---|
| Ticket: | Não se aplica |
|---|
| Requisito/Story/Issue (informe o requisito relacionado) : | DVARMIL-9756 |
|---|
02. SITUAÇÃO/REQUISITO
É necessário implementar um processo que permita a obtenção de informações sobre o status de Marcado Vendido para Atendimentos de máquinas/veículos nos concessionários. Esse requisito se aplica exclusivamente a atendimentos de equipamentos Novos da marca John Deere.
Essa iniciativa é uma exigência da John Deere e será inicialmente implementada no Brasil, com posterior expansão para os demais países da Região 3.
03. SOLUÇÃO
Foi desenvolvida a rotina Levantamento de Informações - Marcado Como Vendido (VEIA380), que tem como objetivo identificar e enviar ao sistema CIFT as informações relacionadas ao status Marcado Vendido através da geração de um arquivo ".JSON", conforme diretrizes estabelecidas pela John Deere.
Essa rotina pode ser executada de forma automatizada por meio do agendador (Schedule) do sistema.
- Para o correto funcionamento dessa nova funcionalidade, deverá ser criado o novo campo e novo pergunte, conforme instrução da aba "Dicionário" e os patchs deverão ser aplicados seguindo a ordem 1ºEtapa e em seguida, 2ºEtapa.
- Quanto ao agendamento (Schedule) do sistema, orientamos que tenha a recorrência de execução de uma vez ao dia.
|
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.
Essas informações são de responsabilidade dos concessionários e deverão ser fornecidas pelo Analista de Implantação da John Deere. |
|
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.



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

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

|
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 |
|
|
|---|
|
|
04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS
9221943 MMIL-6082 DT - Implementação Autent. WebService JD OKTA (OFIA280) - Linha Microsiga Protheus - TDN
