Á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

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

Modulos_totvs_prestadores_de_servicos

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:

  • Importação de cotações;
  • Importação de informações do cliente CKC;
  • Relacionamento de cliente CKC com o cliente padrão do Protheus;
  • Relacionamento de modelo da cotação do JDQuote no Protheus;
  • Relacionamento de cotações do JDQuote com Oportunidade de Negócios;
  • Importação de Pedidos (Purchase Orders);
  • Visualização de arquivo PDF do pedido diretamente no Protheus;
  • Relacionamento de cotações do JDQuote com Atendimento;
  • Criação de cliente padrão do Protheus a partir dos dados de cliente CKC;
  • Validação de campos obrigatórios na criação de clientes padrão a partir dos dados de cliente CKC;
  • Pesquisas e Filtros na listagem de cotações a serem importadas no Protheus;
  • Controle de Status de Clientes CKC no Protheus;
  • Importação automatizada de cotações através de agendamento;
  • Possibilidade de geração automática de registro de cadastro de clientes no Protheus através da importação de uma cotação de um cliente inexistente no Protheus;
  • Possibilidade de importação de cotações máster para visualização no Protheus;
  • Relacionamento de uma cotação a uma oportunidade/ interesse já existente no Protheus;
  • Definição de fase padrão da oportunidade de negócios no momento da criação da mesma a partir da importação de uma nova cotação;
  • Importação de uma cotação por meio de agendamento fazendo com que seja criado automaticamente uma oportunidade ou um atendimento relacionado a esta nova cotação;
  • Parametrização para cancelamento automático de oportunidade de negócios ou atendimento vinculado a cotação atualizada;
  • Relacionamento automático do registro de vendedor no Protheus (tabela SA3) com usuário XC da John Deere na integração da cotação.


Totvs custom tabs box
tabsPasso 01Parametrização, Passo 02, Passo 03, Passo 04Utilização,Alteração de Dicionário
idspasso1parametrizacao,utilizacao,passo2dicionario
Totvs custom tabs box items
passo1
defaultyes
referenciaparametrizacao

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:

  • 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 (OFIOA180), posicione sobre o usuário que irá trabalhar com as cotações John Deere no sistema e selecione alterar
    • Na aba "Oficina", verifique se está configurado o Usuário X do portal John Deere 
    • 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)
Totvs custom tabs box items
defaultno
referenciapasso2

04. DEMAIS INFORMAÇÕES

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!
utilizacao

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.Image Added
  • 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 Image Added
  • Para iniciar o processo, clique em Executar.
  • Esta rotina pode ser configurada para ser executada periodicamente e automaticamente através da rotina Schedule (CFGA010).Image Added
  • 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.Image Added
  • 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:
      • Image AddedCor 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.
      • Image AddedCor 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:
      • Image AddedCor 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.

      • Image AddedCor 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.Image Added
  • 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.Image Added

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

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


Importação de Pedidos (Purchase Orders)

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

  • No browse da rotina, posicione em uma cotação que foi gerado um pedido no portal e selecione a opção Outras Ações \ Atualizar.

  • Neste momento, o pedido desta cotação será importado para o Protheus. Sendo assim, ao importar uma cotação que já possua um pedido ou realizar a atualização da cotação com pedido, o mesmo será importado para o Protheus.

No Veículos (SIGAVEI) acesse a rotinaPO JDQuote (VEIA112).

  • Nesta rotina serão exibidos os pedidos de venda importados do JDQuote para o Protheus.

  • Através da opção Atualizar, é possível atualizar as informações deste pedido junto ao portal JDQuote.

  • Já a opção Visualizar exibirá ao usuário as informações do pedido para serem consultadas.

  • Em Outras Ações \ Visualizar PDF é possível visualizar diretamente do Protheus o arquivo PDF do pedido.Image Added

Relaciona Modelo

No Veículos (SIGAVEI) acesse a rotinaCotações JDQuote (VEIA110).

  • Posicione sobre uma cotação recém importada e selecione a opção Outras Ações \ Relaciona Modelo.

  • Para prosseguir com o processo do JDQuote no Protheus, nesta janela o usuário precisará relacionar qual modelo oriundo da cotação corresponde ao seu cadastro de modelos do Protheus.

  • Para isso, o mesmo deverá preencher os campos Marca e Modelo na parte inferior da janela.

  • Após informar estes campos, clique em Confirmar.Image Added

  • Agora a cotação está apta a ser relacionada.


Cria e Relaciona Oportunidade de Negócios

No Veículos (SIGAVEI) acesse a rotinaCotações JDQuote (VEIA110).

  • Dando continuidade ao processo, caso a concessão trabalhe com a rotina de oportunidade de negócios, será possível tomar duas ações.

  • Posicione sobre uma cotação e selecione a opção Criar Oportunidade.

  • Através desta opção, o sistema criará uma nova oportunidade de negócios e a relacionará a cotação posicionada.

  • Posicione sobre uma cotação e selecione a opção Outras Ações \ Relaciona Oportunidade.

  • Através desta opção, o sistema utilizará uma oportunidade de negócios existente no Protheus para relaciona-la a cotação posicionada.

  • Na janela aberta, o usuário poderá posicionar no item da cotação na parte superior da janela que deseja relacionar com uma cotação e na parte inferior posicionar na oportunidade que deseja relacionar com o item da cotação.

  • Conforme o posicionamento ocorre, os campos da cotação Marca, Cód. Modelo e Modelo serão preenchidos, caso a oportunidade já possua estas informações preenchidas.

  • Confirme para que o relacionamento seja realizado.

    Image Added


Cria e Relaciona Atendimento

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

  • Dando continuidade ao processo, caso a concessão não trabalhe com a rotina de oportunidade de negócios, será possível tomar duas ações.

  • Posicione sobre uma cotação e selecione a opção Outras Ações \ Criar Atendimento.

  • Através desta opção, o sistema criará um novo atendimento e o relacionará a cotação posicionada.

  • Posicione sobre uma cotação e selecione a opção Outras Ações \ Relaciona Atendimento.

  • Na janela aberta, o usuário poderá posicionar no item da cotação na parte superior da janela que deseja relacionar com um atendimento e na parte inferior posicionar no atendimento que deseja relacionar com o item da cotação.

  • Conforme o posicionamento ocorre, os campos da cotação Marca, Cód. Modelo e Modelo serão preenchidos, caso o atendimento já possua estas informações preenchidas.

  • Confirme para que o relacionamento seja realizado.Image Added



Totvs custom tabs box items
defaultno
referenciadicionario

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



Card documentos
InformacaoAs atualizações de dicionário estarão disponíveis na próxima release 1.12.2410
TituloIMPORTANTE!

05. ASSUNTOS RELACIONADOS

05. ASSUNTOS RELACIONADOS



Templatedocumentos