| Produto: | | Solucoes_totvs_parceirosexptotvs |
|---|
| SolucaoParcsExpsTOTVS | TOTVS DMS |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | TOTVS DMS (Linha Protheus) - Oficina (SIGAOFI) TOTVS DMS (Linha Protheus) - Veiculos (SIGAVEI) TOTVS DMS (Linha Protheus) - Auto-Peças (SIGAPECVeículos (SIGAVEI) |
|---|
| Função: | Levantamento de Informações - Marcado 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 sobre dos Atendimentos que estão em Aberto no DMS, que contenha o status de Marcado Vendidopara pedidos em aberto nos concessionários. Esse requisito se aplica exclusivamente a pedidos de ,através da Data informada no campo "Vendido em" (VQ0_DATVEN) para equipamentos Novos da marcaJohn Deere que ainda não foram faturados ao Cliente Final.
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 Foi desenvolvida a rotina LEVANTAMENTO DE INFORMAÇÕES - MARCADO COMO VENDIDO Levantamento de Informações - Marcado Vendido (VEIA380), que tem como objetivo identificar diariamente e enviar ao sistema CIFT as informações relacionadas ao status "Marcado Vendido", por meio dos Atendimentos de máquinas/veículos e da geração de um arquivo no formato .JSON, onde serão considerados os Atendimentos Faturados ou Cancelados, bem como os atendimentos Em Aberto, para 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 |
|---|
|
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 |
|---|
|
- Para o correto funcionamento dessa nova funcionalidade, deverá ser criado o novo campo e novos perguntes, conforme instrução da aba "Dicionário" e o patch de acordo com o release do ambiente deverá ser aplicado para garantir o funcionamento correto.
- Quanto ao 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 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, Dicionário), Consulta Status da Execução, Reenvio de Carga Inicial, Estrutura do Arquivo JSON |
|---|
| ids | passo4,passo1,levantamento,passo2,passo3,reinit,json |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yesno |
|---|
| referencia | passo1 |
|---|
| - Na rotina Integração John Deere - Configurações OKTA - John Deere (OFIA280) foi criada uma nova aba
()- , 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 - 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 |
|---|
| 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
- 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.
- 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.
- 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').
| Aviso |
|---|
| 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 |
|---|
| Essa Rotina tem por objetivo gerar e enviar as informações de A Rotina VEIA380 por objetivo efetuar o envio das 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- do Agendamento e orientamos que tenha a recorrência de execução de uma vez ao dia.
| Aviso |
|---|
| - Orientamos que o Agendamento 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 no parâmetro MV_MIL0005.
- No caso de Empresa Combo (Linhas Verde e Amarela), deverá cadastrar um Agendamento para cada Matriz.
|
 Image Modified
 Image Modified
- 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
importadosimportados :- 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".
 Image Added
importados 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 contrário, ele permanecerá no diretório de geração para que seja enviado na próxima execução. 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 |
|---|
| | Aviso |
|---|
| O status do processo pode ser conferido filtrando as colunas "Tipo de Dado" (VK5_DATTYP) igual a CIFT e "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 Added
- 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 Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | reinit |
|---|
| Caso seja necessário, é possível fazer o envio de uma nova carga inicial. | Aviso |
|---|
| Destacamos que é de suma importância e responsabilidade tanto da fabricante John Deere quanto do Concessionário garantir o correto alinhamento deste 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 |
|---|
| 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 | VEIA380 |
|---|
Ordem | 01 | 02 | 03 |
|---|
Pergunta | Dir. geração de arquivos? | Dir. arquivos |
|---|
importados| 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 |
|
|
|
|---|
| Help |
|---|
|
|
04. DEMAIS INFORMAÇÕES
| Totvs custom tabs box items |
|---|
|
| 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 (1º Etapa): | 12.1.2210: https://r.totvs.io/p/1198373 12.1.2310: https://r.totvs.io/p/119837412.1.2410: https://r.totvs.io/p/1198375 Pacotes gerados (2º Etapa)1205163120516412051651205166| Card documentos |
|---|
| Informacao | Essa atualização de dicionário estará disponível na próxima release 12.1.2610 |
|---|
| Titulo | IMPORTANTE! |
|---|
|
05. ASSUNTOS RELACIONADOS
