Histórico da Página

01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucoes_totvs_cross

SolucaoCross

Solucoes_totvs_parceiros

SolucaoParceiros

Solucoes_totvs_parceirosexptotvs

SolucaoParcsExpsTOTVS	TOTVS DMS

Linha de Produto:

Linhas_totvs

Linha	Linha Protheus

Segmento:

Segmentos_totvs

Segmento	Varejo

Lojas

Módulo:

Modulos_cross_segmentos

Modulos_framework

Modulos_totvs_construcao

Modulos_totvs_juridico

Modulos_totvs_logistica

Modulos_totvs_manufatura

Modulos_totvs_rh

Modulos_totvs_saude

TOTVS DMS (Linha Protheus) - Oficina (SIGAOFI)TOTVS DMS (Linha Protheus) - Veiculos (Veículos (SIGAVEI)

TOTVS DMS (Linha Protheus) - Auto-Peças (SIGAPEC)

Função:

Levantamento de Informações - Marcado Como Vendido (VEIA380)

País:

Brasil

Ticket:

Não se aplica 25390574

Requisito/Story/Issue (informe o requisito relacionado) :

DVARMIL-975612677

02. SITUAÇÃO/REQUISITO

A fabricante John Deere necessita ter a visibilidade e previsibilidade de quais equipamentos estão sendo negociados, a fim de melhorar o planejamento do ciclo produtivo: desde a fabricação até a entrega. Para isso é necessário implementar um processo que permita a obtenção de informações dos Atendimentos que estão em Aberto no DMS, que contenha o status de Marcado Vendido,através da Data informada no campo "Vendido em" (VQ0_DATVEN) para equipamentos Novos da marca.

03. SOLUÇÃO

Foi desenvolvida a rotina Levantamento de Informações - Marcado como Vendido (VEIA380), que tem como objetivo identificar diariamente e enviar ao sistema CIFT as informações relacionadas ao status "Marcado como Vendido", por meio dos Atendimentos de máquinas/veículos e da geração de um arquivo no formato .JSON, onde serão considerados todos os Atendimentos Faturados ou Cancelados nos últimos 15 dias, bem como todos os atendimentos Em Aberto, independentemente da datapara envio diário, conforme as diretrizes estabelecidas pela John Deere.

Essa rotina pode ser executada de forma automatizada por meio do agendador Agendamento (Schedule) do sistema.

Nota

title	Informativo

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.

Aviso

title	Pontos de Atenção!

Para o correto funcionamento dessa nova funcionalidade, deverá ser criado o novo campo e novo perguntenovos perguntes, conforme instrução da aba "Dicionário" e os patchs deverão ser aplicados seguindo a ordem 1ª Etapa e em seguida, 2ª Etapao patch de acordo com o release do ambiente deverá ser aplicado para garantir o funcionamento correto.
Quanto ao agendamento Agendamento (Schedule) do sistema, orientamos que tenha a recorrência de execução de uma vez ao dia e ressaltamos que o cadastro do scheduler deve ser feito apenas na Matriz, não sendo necessário realizar o cadastro em cada filial. A rotina irá considerar todos os dealers que estiverem liberados para geração do arquivo, conforme definidos previamente no parâmetro: MV_MIL0005 – Código do Concessionário no Portal de Garantia JD, durante a configuração da integração JDPrism.
- Obs.: Este parâmetro não requer manutenção, apenas a caráter informativo deve estar por filial, devendo conter o código do dealer correspondente à filial em questão, conforme definição da John Deere.
No caso de Empresa Combo (Linhas Verde e Amarela), deverá cadastrar um agendamento Agendamento para cada Matriz.
O botão "Agendar" só será exibido se o Scheduler estiver corretamente configurado e em execução no mesmo ambiente da aplicação. Certifique-se de que o serviço esteja ativo e funcional antes de tentar utilizar essa funcionalidade.
Para que os registros necessários para a gravação do log do Marcado Vendido sejam criados, é necessário apenas acessar a rotina Tabelas Genéricas DMS (OFIA560). Nenhuma outra ação é exigida do usuário, o simples acesso à rotina garante a criação automática desses registros.

Totvs custom tabs box

tabs	Dicionário, Configurações OKTA, Critérios e Lógica de Levantamento, Rotina Marcado Vendido (VEIA380), Consulta Status da Execução, DicionárioReenvio de Carga Inicial, Estrutura do Arquivo JSON
ids	passo4,passo1,levantamento,passo2,passo3,reinit,passo4json

Totvs custom tabs box items

default	yesno
referencia	passo1

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.

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	levantamento

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

Image Added

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 ser atendimento seja considerado na geração do arquivo, é necessário que contenha informados no atendimento, obrigatoriamente, as seguintes informações:
- O Cliente (SA1);
- Máquina/Veículo (VV1 (Ex. ) (por exemplo, um Pedido de MáquinaMáquina) ) devidamente cadastrados;
- ComarCode"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 não " 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 e Cancelados nos últimos 15 dias.
Todos os atendimentos Em Aberto, independentemente da data.

Execuções Posteriores (Recorrentes)

Executadas conforme agendador 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').

Aviso

title	Importante

Os Atendimentos fora da Data de Corte (ou seja, anteriores a D-15) e não marcados na execução inicial, não serão considerados em execuções futuras. Isso garante que registros antigos não fiquem sendo reprocessados indefinidamente.

Totvs custom tabs box items

default	no
referencia	passo2

A Rotina

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 agendador Agendamento e orientamos que tenha a recorrência de execução de uma vez ao dia.

Image Removed

Aviso

title	Importante

Orientamos que o agendamento Agendamento tenha a recorrência de execução de uma vez ao dia e ressaltamos que o cadastro do scheduler Scheduler deve ser feito apenas na Matriz, não sendo necessário realizar o cadastro em cada filial. A rotina irá considerar todos os dealers que estiverem liberados para geração do arquivo, conforme definidos no parâmetro MV_MIL0005.
No caso de Empresa Combo (Linhas Verde e Amarela), deverá cadastrar um agendamento Agendamento para cada Matriz.

Image Added

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

Image Added

Image Removed

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 a pasta informada no segundo parâmetro (Dir. arquivos enviados?), caso o retorno da API seja positivo, caso . Caso contrário, ele permanecerá no diretório de geração para que seja enviado numa na próxima execução posterior.

As informações relacionadas ao status de execução podem ser verificadas na aba "Consulta Status da Execução".

Image Modified

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

Image Modified

Totvs custom tabs box items

default	no
referencia	passo3

Consulta Log Rest (OFIA262)

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" (VK5_DATTYP) igual a CIFT e "Tabela Chave Ori." (VK5_ORIKEY) igual à "VEIA380".

Caso o envio não seja bem-sucedido, a mensagem de erro retornada será exibida nos campos "Resp. Cab". e "Resp. Body":

Image Modified

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

Image Modified

Totvs custom tabs box items

default	no
referencia	reinit

Reenvio de Carga Inicial:

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

Aviso

title	Atenção!

Destacamos que é de suma importância e responsabilidade tanto da fabricante John Deere quanto do Concessionário garantir o correto alinhamento deste processo.

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

Nota
Essa operação deverá ser executada exclusivamente de forma manual, caso seja feita através do Agendamento do Protheus (Scheduler), o sistema irá desconsiderar o conteúdo do parâmetro "Carga Inicial?".

Image Added

Totvs custom tabs box items

default	yes
referencia	passo4

Dicionário de Dados

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:

Help
Grupo	VEIA380	VEIA380	VEIA380
Ordem	01	02	03
Pergunta	Dir. geração de arquivos?	Dir. arquivos enviados?	Carga Inicial?
Tipo	C	C	C
Tamanho	99	99	1
Decimal
Var01	MV_PAR01	MV_PAR02	MV_PAR03
Formato
Validação
Objeto	G	G	Edit (C)
Consulta Padrão
Pré-Seleção (Combo)			1
Item 1			Não
Item 2			Sim
Item 3
Item 4
Item 5

04. DEMAIS INFORMAÇÕES

Pacotes Gerados (1ª Etapa):

12.1.2210: https://r.totvs.io/p/1198373

12.1.2310: https://r.totvs.io/p/1198374

12.1.2410: https://r.totvs.io/p/1198375

Totvs custom tabs box items

default	no
referencia	json

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

Bloco de código

language	yml
theme	Midnight
title	Marcado Vendido (JSON)
linenumbers	true

{
        "Chave": {
            "DEALER": "Codigo Dealer",
            "DATETIME": "xx/xx/xxxx-xx:xx:xx",
            "COMAR_NUMBER": "",
            "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"
            }
        ]
    }

04. DEMAIS INFORMAÇÕES

Pacotes Gerados

Pacotes Gerados (2ª Etapa)
:
12.1.2210: https://r.totvs.io/p/
1205163
1227469
12.1.2310: https://r.totvs.io/p/
1205164
1227470
12.1.2410: https://r.totvs.io/p/
1205165
1227471
12.1.2510: https://r.totvs.io/p/
1205166
1227472

Card documentos

Informacao	Essa atualização de dicionário estará disponível na próxima release 12.1.2610
Titulo	IMPORTANTE!

05. ASSUNTOS RELACIONADOS

9221943 MMIL-6082 DT - Implementação Autent. WebService JD OKTA (OFIA280) - Linha Microsiga Protheus - TDN
DVARMIL-12489 DT - Adição de novas tags no arquivo do Marcado Vendido (VEIA380) - Linha Microsiga Protheus - TDN

Templatedocumentos

Árvore de páginas

Versões comparadas

Versão antiga 58

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

Autent. Webservice Jd Okta (OFIA280)

Dados à serem gerados:

Regras para geração do arquivo:

Regras para envio dos atendimentos:

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 e Cancelados nos últimos 15 dias.
Todos os atendimentos Em Aberto, independentemente da data.

Execuções Posteriores (Recorrentes)

Marcado Vendido (VEIA380)

Consulta Log Rest (OFIA262)

Reenvio de Carga Inicial:

Para executar o processo:

Dicionário de Dados

04. DEMAIS INFORMAÇÕES

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 58

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

Autent. Webservice Jd Okta (OFIA280)

Dados à serem gerados:

Regras para geração do arquivo:

Regras para envio dos atendimentos:

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 e Cancelados nos últimos 15 dias.Todos os atendimentos Em Aberto, independentemente da data.

Execuções Posteriores (Recorrentes)

Marcado Vendido (VEIA380)

Consulta Log Rest (OFIA262)

Reenvio de Carga Inicial:

Para executar o processo:

Dicionário de Dados

04. DEMAIS INFORMAÇÕES

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

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 e Cancelados nos últimos 15 dias.
Todos os atendimentos Em Aberto, independentemente da data.