Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVSTOTVS DMS

Linha de Produto:

Linhas_totvs
LinhaLinha 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 Vendido (VEIA380)
País:Brasil
Ticket:Não se aplica 25390574
Requisito/Story/Issue (informe o requisito relacionado) :DVARMIL-848412677

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.

03. SOLUÇÃO

Descreva aqui utilizando linguagem simples, porem contemplando o assunto relacionado a correção da issue com exemplo abaixo:

Alterado processo de validação de requisição de peças na rotina Requisição de Peças (OFIOM020), para que ao tentar realizar uma requisição utilizando uma "TES"(Tipo de Entrada/Saída) o sistema realize o bloqueio do processo, assim não permitindo que o usuário termine a operação.

Teste 3 usuários


Nota
titleInformativo

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
titlePontos de Atenção!
  • 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
tabsMacro: Totvs custo tabs box, Macro: Totvs custom tabs box itens, Estrutura documentação de DicionárioDicionário, Configurações OKTA, Critérios e Lógica de Levantamento, Rotina Marcado Vendido (VEIA380), Consulta Status da Execução, Reenvio de Carga Inicial, Estrutura do Arquivo JSON
idspasso4,passo1,levantamento,passo2,passo3,reinit,jsonidspasso1,passo2,passo3
Totvs custom tabs box items
defaultyesno
referenciapasso1

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:


Image Added


  • 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
defaultno
referencialevantamento

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


Aviso
titleImportante

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.

Explicação de funcionamento do "Box" (Macro: Totvs custo tabs box)

A box principal é utilizada para organizar a visualização da "Totvs custom tabs box itens" onde com ela podemos organizar as posições de cada aba e os títulos das mesmas.

Ao clicar  mouse encima no nome "Totvs custom tabs box" será apresentada as opções abaixo:

  • Alterar: utilizada para alterarmos as informações da macro
  • Eliminar: utilizada para excluirmos a macro

Ao clicar em alterar, será apresentada um tela com o seguintes campos:

  • Ids: Onde escolhemos os "IDS" que serão usados na "Referencia" das abas (sempre separado por "virgula" e na sequencia que o Totvs custom tabs box itens se encontra(Passo1→Aba 1,Passo2→Aba 2 e assim respectivamente)   ) caso os Ids ficarem foram de posição as abas não funcionaram.
  • Tabs: Onde escolhemos os "Titulos" de cada "Totvs custom tabs box itens", segue a mesma logica do funcionamento dos "Ids"

    Totvs custom tabs box items
    defaultno
    referenciapasso2

    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.


    Aviso
    titleImportante
    • 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 Added


    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

     

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


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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciapasso3

    Consulta Log Rest (OFIA262)

    Aviso
    titleAtenção!

    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
    defaultno
    referenciareinit

    Reenvio de Carga Inicial:

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

    Aviso
    titleAtençã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

    Explicação de funcionamento das Abas (Macro: Totvs custom tabs box itens)

    As abas, são utilizadas para melhor organização dos fatos relacionados a documentação, ou seja, conseguimos moldar os assuntos de maneira organizada e de visualização limpa, e de suma importância que utiliza-las para que as documentações fiquem limpas e de facil entendimento sobre as alterações/informações que estarão vinculadas a documentação.

    Funcionamento:

    Ao clicar com o mouse encima no nome "Totvs custom tabs box itens" será apresentada duas opções:

    • Alterar: utilizada para alterarmos as informações da macro
    • Eliminar: utilizada para excluirmos a macro

    Ao clicar em alterar, será apresentada um tela com o seguintes campos:

    • Referencia : Onde preenchemos com o "ID" de referencia da aba (Vindo como preenchido como padrão quando realizamos a criação do "Documento Tecnico NEW")
    • Defaut: Caso marcado com "yes" a aba em questão será apresentada primeiro em relação a outras abas, se estiverem marcadas com "no"

    As abas destinam-se para a criação de passo-a-passo operacional (Descrição de como utilizar as alterações/rotinas etc.... ), sempre lembrando que o passo-a-passo somente fazemos caso tenha algo "Visual" para mostrarmos para quem estiver lendo a documentação como:

    • Helps de rotinas
    • Funcionalidades novas
    • Campos novos (caso os mesmos sejam apresentados em tela)
    • etc...

    Sempre ao criar um passo-a-passo devemos colocar imagens com boa visualização e sempre lembrar de "Não" mostrar o usuário "Admin" em tela.

    Totvs custom tabs box items
    passo3
    defaultnoyes
    referenciapasso4

    Dicionário de Dados

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


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


    Campo

    VV9_ENVCFT

    TipoC
    Grupo de Campos
    Ordem40
    Tamanho1
    Decimal0
    Formato@!
    ContextoR
    PropriedadeV
    TítuloEnv. CIFT   
    DescriçãoEnviar ao CIFT           
    Val. SistemaPertence('01')
    Opções0=Sim;1=Não
    Inic. Padrão"0"
    Inic. Browse
    Cons. Padrão
    Nível
    UsadoNAO
    ObrigatórioNAO
    BrowseNAO
    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

    VEIA380VEIA380VEIA380

    Ordem

    010203

    Pergunta

    Dir. geração de arquivos?Dir. arquivos enviados?Carga Inicial?

    Tipo

    CCC
    Tamanho99991
    Decimal


    Var01MV_PAR01MV_PAR02MV_PAR03
    Formato


    Validação


    ObjetoGGEdit (C)
    Consulta Padrão


    Pré-Seleção (Combo)

    1
    Item 1

    Não
    Item 2

    Sim
    Item 3


    Item 4


    Item 5


    Help




    Totvs custom tabs box items
    defaultno
    referenciajson


    Bloco de código
    languageyml
    themeMidnight
    titleMarcado Vendido (JSON)
    linenumberstrue
    {
            "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


    Card documentos
    InformacaoUse esse box para destacar informações relevantes e/ou de destaque.Essa atualização de dicionário estará disponível na próxima release 12.1.2610
    TituloIMPORTANTE!

    05. ASSUNTOS RELACIONADOS



    Templatedocumentos