01. DADOS GERAIS

Produto:

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 (SIGAPEC)

Função:Não se aplica.
País:Brasil
Ticket:21002363
Requisito/Story/Issue (informe o requisito relacionado) :DVARMIL-5373


02. SITUAÇÃO/REQUISITO

Os serviços da API JD Quote da John Deere passarão a ser via arquitetura REST. Com isso, as rotinas utilizadas anteriormente precisam se adequar à esta nova arquitetura.

03. SOLUÇÃO

As rotinas que faziam comunicação com o JD Quote foram adaptadas para obedecerem a arquitetura REST implementada pela John Deere.


Características da Integração

A seguir seguem as principais características da integração desenvolvida no Protheus:


No arquivo appserver.ini, verifique se a tag maxstringsize está configurada com, no mínimo, o valor 10. A tag maxstringsize=10 deve estar dentro da seção GENERAL.

Configurações iniciais para utilização:

  • Configure a rotina Autent. Webservice JD OKTA (OFIA280) na aba "Geral" com as informações do usuário e na aba "JDQuote2" com os URL's corretos;
  • Parâmetro MV_MIL0133: Deve receber o código do dealer number principal na John Deere, ou seja, normalmente se trata do código do concessionário da matriz da concessão junto a John Deere;
  • Parâmetro MV_MIL0005: Verifique se está configurado corretamente para cada filial;
  •  Na rotina Equipe Técnica (), posicione sobre o usuário que irá trabalhar com as cotações John Deere no sistema e selecione alterar
    • Na aba "Veículos", verifique a configuração do campo Cot.Out.Vend (VAI_JDQOUT). 
    • Este campo define se o usuário poderá visualizar cotações de outros usuários, onde 1=SIM (Visualiza outras cotações) e 2=NÃO (Não visualiza outras cotações)

Importação de Cotações

No Veículos (SIGAVEI) acesse a rotina Cotações JDQuote (VEIA110)

  • Nesta rotina o usuário poderá importar e acompanhar as cotações importadas do JDQuote no Protheus.
  • Selecione a opção "Importar" para iniciar o processo de importação de cotações.
  • Será exibida uma janela para que sejam informados parâmetros a serem considerados no levantamento das cotações aptas a serem importadas:
    • Data Inicial e Data Final: informe o período de inclusão que deseja considerar no levantamento das cotações.
    • Exibir Vencidas: marque esta caixa para considerar cotações vencidas.
    • Exibir Expiradas: marque esta caixa para considerar cotações expiradas.
    • Cotação: caso já possua o número da cotação, informe o seu número neste campo para que seja considerada apenas esta cotação no levantamento.
  • Após preencher os parâmetros, clique no botão "Atualizar" para que seja iniciado o levantamento destas cotações no portal.
  • Será exibida uma listagem com todas as cotações aptas a serem importadas. Nesta listagem, o usuário poderá ordenar as informações utilizando qualquer uma das colunas existentes. Além disso, também poderá realizar filtros e pesquisas, facilitando a busca pela cotação que deseja importar.
  • Selecione uma ou mais cotações, e confirme para realizar a importação da cotação para o Protheus.
  • Após a confirmação, a cotação será exibida no browse principal da rotina.
  • Clique em Visualizar para exibir as informações da cotação recém importada. As informações da cotação são agrupadas em três abas denominadas Cotação, Equipamentos e Usados.


No Veículos (SIGAVEI) acesse a rotina Importação de Cotações (VEIA113)

  • Esta rotina tem como objetivo realizar a importação de novas cotações JDQuote para o Protheus e a sincronização de cotações já existentes no Protheus com as informações atualizadas no portal.
  • Clique em "Perguntas" para configurar a forma de realização da importação:
    • Dias a Processar: informe quantos dias retroativos serão considerados a partir da database do Protheus para realizar o processo.
    • Importar Vencidas: informe se as cotações vencidas deverão ser consideradas no processo.
    • Importar Expiradas: informe se as cotações expiradas deverão ser consideradas no processo.
  • Para iniciar o processo, clique em Executar.
  • Esta rotina pode ser configurada para ser executada periodicamente e automaticamente através da rotina Schedule (CFGA010).
  • Após a sincronização das cotações, as cotações que foram excluídas do Portal e que ainda possuem um registro no Protheus aparecerão na browse com a linha pintada de cinza.
  • ATENÇÃO! Só será permitida a exclusão de cotações no Protheus que foram excluídas anteriormente no Portal JDQuote.


Importação de Cotações Masters

No Veículos (SIGAVEI) acesse a rotina Cotações JDQuote (VEIA110)

  • Nesta rotina o usuário poderá importar e acompanhar as cotações importadas do JDQuote no Protheus.
  • Selecione "Outras Ações" e então selecione a opção "Importar Master" para iniciar o processo de importação de masters.
  • Será exibida uma janela para que sejam informados parâmetros a serem considerados no levantamento das cotações aptas a serem importadas:
    • Data Inicial e Data Final: informe o período de inclusão que deseja considerar no levantamento das cotações.
    • Exibir Vencidas: marque esta caixa para considerar cotações vencidas.
    • Criada Por: Informe para considerar cotações criadas pela concessionária. Opção 2=Concessionária
    • Cotação: caso já possua o número da cotação, informe o seu número neste campo para que seja considerada apenas esta cotação no levantamento.
  • Após preencher os parâmetros, clique no botão "Atualizar" para que seja iniciado o levantamento destas cotações masters no portal.
  • Será exibida uma listagem com todas as cotações aptas a serem importadas. Nesta listagem, o usuário poderá ordenar as informações utilizando qualquer uma das colunas existentes. Além disso, também poderá realizar filtros e pesquisas, facilitando a busca pela cotação que deseja importar.
  • Selecione uma ou mais cotações, e confirme para realizar a importação da cotação para o Protheus.
  • Após a confirmação, a cotação será exibida no browse principal da rotina e o "Tipo" estará como "Master"
  • Clique em Visualizar para exibir as informações da cotação recém importada. As informações da cotação são agrupadas em três abas denominadas Cotação, Equipamentos e Usados.


Dados de Clientes

No Veículos (SIGAVEI) acesse a rotina Clientes CKC John Deere (VEIA111).

  • No browse desta rotina serão exibidos todos os dados de clientes oriundos de importação de cotações JDQuote no Protheus.
  • Os clientes informados nas cotações serão cadastrados automaticamente na tabela de clientes CKC John Deere no Protheus.
  • Esta rotina utiliza dois tipos de classificação do cliente CKC em formato de legendas:
    • Primeira Coluna: a primeira coluna trata do status do cliente CKC com relação ao JDQuote, onde:
      • Cor Rosa: este cliente não está cadastrado no JDQuote, ou seja, ao realizar a cotação no JDQuote não foi informado um cliente cadastrado (sem código), apenas informações primordiais do mesmo.
      • Cor Amarela: este cliente possui cadastrado no JDQuote, ou seja, ao realizar a cotação no JDQuote foi informado um cliente cadastrado (com código).
    • Segunda Coluna: a segunda coluna trata do status do cliente CKC com relação ao cadastro de clientes do Protheus, onde:
      • Cor Vermelha: este cliente não está cadastrado no Protheus, ou seja, o mesmo não possui um cadastro no cadastro de clientes padrão do Protheus ou ainda não foi relacionado a este.

      • Cor Verde: este cliente está cadastrado no Protheus, ou seja, o mesmo possui um cadastro no cadastro de clientes padrão do Protheus.

  • Clique em Visualizar para consultar as informações do cliente.
  • No browse da rotina estão disponíveis duas opções para utilização do usuário.
  • A opção Relacionar Cliente permite ao usuário relacionar o cadastro de clientes CKC com um cadastro de clientes padrão já existente no Protheus.

  • Estando com o cliente posicionado no browse, ao clicar nesta opção uma nova janela será aberta.

  • Esta janela é dividida verticalmente em duas partes:

    • Parte Superior: serão exibidas as informações do cliente CKC posicionado no browse anteriormente.

    • Parte Inferior: o sistema tentará encontrar o cliente na base de dados de clientes utilizando a informação de CPF (pessoa física) e CNPJ (pessoa jurídica). Desta forma, na parte inferior serão exibidos um ou mais registros de clientes para que o relacionamento seja feito

    • ATENÇÃO! Caso nenhum cliente seja exibido na parte inferior, isto significa que não foi encontrado nenhum registro no cadastro de clientes com a informação de CPF (pessoa física) e CNPJ (pessoa jurídica).

  • Posicione no registro de clientes da parte inferior que deseja relacionar com o cliente CKC na parte superior e clique em Confirmar para realizar o relacionamento.

  • A opção Outras Ações \ Criar Cliente Protheus permite ao usuário criar um novo cadastro de clientes a partir dos dados do cliente CKC.

  • Estando com o cliente posicionado no browse, ao clicar nesta opção uma nova janela será aberta.

  • A janela exibirá as informações do cliente CKC na parte superior. Abaixo, serão exibidas as informações do cadastro de cliente para que o usuário realize a digitação.

  • As informações de cliente CKC serão aproveitadas, fazendo assim com que alguns campos do cadastro de clientes sejam preenchidos automaticamente.

  • Após preencher todos os campos, clique em Confirmar para realizar a inclusão deste novo cliente já com o relacionamento ao cliente CKC realizado.

  • ATENÇÃO! Todas as regras e validações de cadastro de clientes padrão do Protheus serão consideradas aqui, como campos obrigatórios e pontos de entrada.





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


  • Tabela VJK - JD - Itens da Cotação:
CampoVJK_PRICEVJK_LIST
Tamanho1212
Picture@E 9.999.999.999,99@E 9.999.999.999,99


04. DEMAIS INFORMAÇÕES

Outras ações/ações relacionadas 



05. ASSUNTOS RELACIONADOS