Linx DMS Integrador | Manual do DDX VW

Implementação do projeto DDX On-line Sales da VW, referente às vendas on-line de veículos.

O DDX On-line Sales trata-se de uma plataforma de venda de veículos novos, onde o cliente pode selecionar um veículo em estoque na concessionária, efetuar a reserva e gerar uma negociação no BRAVOS.

BRAVOS Barramento Linx DDX VW

Estrutura de comunicação:

• Figura 1: Estrutura de comunicação

O Barramento Linx possui um webservice específico para este processo que é consumido pelo DDX VW e pelo BRAVOS, através do Linx DMS Integrador.
As seguintes integrações são efetuadas entre o DDX e o BRAVOS:

• Tabela 1: Integrações

Detalhamento das integrações:

• Consulta do estoque
  No DDX VW, o cliente seleciona modelo e cor opcionais do veículo desejado.
  Ao efetuar a consulta no BRAVOS, são retornados todos os veículos em estoque da mesma família. Caso algum dos veículos possuir todas as características informadas pelo cliente, será marcado como "best match" e virá em primeiro lugar na lista. Os demais serão ordenados por tempo em estoque.

• Inclusão da reserva
  Assim que o cliente seleciona o veículo no DDX VW, é enviada uma reserva para o BRAVOS.
  A reserva é incluída no sistema levando em consideração o parâmetro "Horas de reserva" informado no módulo de Veículos do BRAVOS.
  O parâmetro "Bloquear Veículo em negociação" também é levado em consideração neste processo.

• Inclusão da negociação
  Assim que o veículo é reservado, são solicitados os dados para pagamento (sinal, entrada e financiamento). O Sinal por definição deverá ser pago somente com cartão de crédito.
  Na confirmação dos dados é enviada uma negociação para o BRAVOS.
  Ao receber a negociação são geradas as seguintes informações:
  • Contato
    Utilizando o canal de acesso configurado nos parâmetros do Fábrica VW (este item será explicado em tópico específico)
  • Interesse
    Baseado no modelo enviado na negociação.
    Será gerado somente se a concessionária possuir o parâmetro "Interesse Obrigatório no Atendimento a Cliente" marcado no módulo de Veículos.
  • Formação de preço
    Dados do cliente, veículo e condições de pagamento.
  • Proposta
    Dados do cliente, veículo e condições de pagamento.
    Quando existir um sinal como forma de pagamento, serão gerados também os lançamentos de adiantamento e cartão de crédito. O título do adiantamento será vinculado à condição de pagamento gerada.
    
    

• A tela do DDX apresenta um número de negociação que será vinculado a proposta. A tela de consulta de proposta permite filtrar por este número de negociação (este item será explicado em tópico específico).

Configuração do processo

Parâmetros de Veículos

Menu: Veículos > Parâmetros

Na aba Financiamento, preencher os campos a seguir:

• Condição de Pagamento Utilizada em Pagamento de Veículos

Figura 2: Parâmetros de Veículos

Condição de pagamento

Menu: Faturamento > Cadastro > Condições Pagamento

Nas condições de pagamento de cartão de crédito, preencher os campos:

• Nro. Parcelas Cartão: (quando a concessionária utilizar condições diferentes para pagamento no rotativo e no parcelado)
  • Mínimo
  • Máximo
    
• Origem: (quando a concessionária utilizar origens diferentes para os cartões de crédito). Mais informações no campo "Origem do Pagamento (Cartão)" dos parâmetros do Fábrica VW.
• Tipo de Cartão: Crédito.
• Aba Bancos
  • Informar os bancos utilizados nesta forma de pagamento.

Figura 3: Condição de Pagamento

Banco

Menu: Financeiro > Cadastro > Bancos

Para os bancos referentes aos cartões, selecionar a aba Cartão de Crédito e preencher o campo "Bandeira" conforme o cartão selecionado.

Figura 4: Banco
Para auxiliar a identificação da condição de pagamento de cada cartão é interessante utilizar o nome do cartão na descrição. Ex.: Condição – "Cartão Master Crédito", Banco – "Cartão Master Crédito".

Fábrica VW
Manutenção de parâmetros

Menu: Fábrica VW > Parâmetros

Acessar a aba DDX e preencher os campos solicitados.

Figura 5: Parâmetros VW – DDX aba Geral

Campos:

• Utiliza DDX: Informa se a revenda utiliza a integração com o DDX VW. Esse parâmetro será verificado pelo Linx DMS Integrador para efetuar a comunicação.

• Aba Geral
  • Canal de Acesso para Contatos do DDX: Canal de acesso específico para o contato gerado na negociação (proposta) do DDX VW.
    • Obs.: O canal de acesso é cadastrado através do menu: "CRM Plus > Cadastro > Canal de Acesso".
  • Usuário para notificações da integração: Usuário para receber as notificações da integração. Além deste usuário, também serão enviadas mensagens para o usuário do vendedor que está acessando o DDX VW.
  • Tratar edição: Parâmetro utilizado para considerar ou não o campo Edição do modelo do veículo na consulta de estoque para efeito "BestMatch"
  • Condição de pagamento para veículo seminovo: Condição de pagamento referente ao valor do veículo usado na troca.
  • Situações de veículo que não serão enviados no processo: Parâmetro com as situações dos veículos que não serão enviados para o DDX VW.

Figura 6: Parâmetros VW – Situações de veículo

• Aba Valores de Pagamento

Figura 7: Parâmetros VW – DDX aba Valores de Pagamento

• • Valor de Entrada
    • Condição de Pagamento: Condição de pagamento referente à entrada.
  • Valor de Sinal (Adiantamento)
    • Condição de Pagamento: Condição de pagamento referente ao valor recebido de sinal.
    • Departamento: Departamento para o lançamento do adiantamento.
    • Origem do Pagamento: Origem do pagamento para o lançamento de adiantamento.

IMPORTANTE: São listadas somente as origens que possuam referência cruzada do financeiro com Tipo de Lançamento igual a "Adiantamento" e Operação igual a "Lançamento".

• Origem do Pagamento (Cartão): Origem do pagamento para o lançamento de cartão do adiantamento.

IMPORTANTE:

1. A informação deste campo é opcional. Se estiver em branco, será utilizada a Origem informada na condição de pagamento referente ao cartão de crédito utilizado.
2. São listadas somente as origens que possuam referência cruzada do financeiro com Tipo de Lançamento igual a "Cartão de Crédito" e Operação igual a "Lançamento".
3. Todos os bancos utilizados para os cartões de crédito devem possuir referência cruzada para esta origem.

OBSERVAÇÃO: Todas as condições de pagamento devem possuir referência cruzada de pagamento para a transação padrão de vendas de veículos novos.

• A transação padrão pode ser verificada no menu "Veículos > Parâmetros", aba Veículo.
• A referência cruzada de pagamento pode ser verificada no menu "Faturamento > Cadastros > Referência Cruzada Pagamento".

Linx DMS Integrador

1. Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
2. Acesse o menu "Configuração > DDX VW";
3. Na aba "Configuração", preencha os dados de acesso ao banco de dados;

Figura 8: Tela de configuração do banco de dados.

O campo "Permanência do log no Banco" controla a forma de gravação das informações do log.
Valores possíveis:

• -1: Mantém o log sem limite de data
• 0: Não grava log.
• >0: Mantém o log por "n" dias.

1. Clique em "Testar Conexão".

Prosseguir somente se for apresentada a mensagem "Conexão com o Banco de Dados realizada com sucesso! ". Caso não ocorra, verifique se os parâmetros informados são os mesmos utilizados pelo BRAVOS.

1. Clique em "Next";
2. Na tela DDX VW, clique em "Incluir";

Figura 9: Tela de configuração da comunicação

1. Preencha os dados para o acesso ao serviço.

Opções disponíveis:

• Nome: Nome do arquivo externo da configuração. Essa informação fica a critério da concessionária. Utilizar um nome que facilite a identificação;
• Descrição: Descrição da configuração;
• Log Detalhado: Indicativo para gravação do log detalhado no banco de dados;
• Log de XML: Indicativo para gravação dos XML's de comunicação no banco de dados;
• Log de SQL: Indicativo para gravação dos comandos executados no banco de dados;
• URL: Endereço para acesso ao servidor do DDX na Linx.

Informar: https://ddxvw.linx.com.br/DdxVW/DdxVW.dll

• Acesso:
  Usuário DDX: Usuário para acessar o servidor do DDX na Linx;

Informar: userDdxVW

• Senha DDX: Senha para acessar o servidor do DDX na Linx;
  
  

Informar: passDdxVW

• Agendamento:
  Intervalo: Tempo entre cada consulta das informações.

IMPORTANTE:

• O botão "Executar Manualmente" efetua a comunicação com o DDX sem a utilização do serviço do Linx DMS Integrador.
• Deve ser criada uma única configuração. Os DN's para comunicação serão obtidos através do parâmetro "Utiliza DDX" do Fábrica VW.

• Grave as informações, clicando em "Salvar";
• Finalize as configurações, clicando em "Next" e depois em "Finish".

• Figura 10: Tela de conclusão das configurações
  
  

1. Reinicie o serviço do integrador
2. No Windows, pressione a tecla do logotipo do Windows + "R";
3. Digite services.msc e clique em "Ok";
4. Localize e clique sobre o serviço "Linx DMS Integrador";
5. Clique em "Reiniciar o serviço";
6. Após este procedimento, o status do serviço deve continuar como "Em Execução".

Figura 11: Tela do serviço

IMPORTANTE:

No momento da Configuração, através do menu abaixo, que é acessado através do LDIConfig.exe na pasta C:\LinxDMSIntegrador.

Figura 11: Menu

Após a configuração, acesse a aba DDX VW, clique no botão "Executar Manualmente", que irá fazer o envio manual dos dados, onde pode ser verificado no log a existência de algum erro de parametrização ou comunicação.

Figura 12: DDX VW

O resultado da execução da função acima, pode ser monitorada através do menu Linx DMS Integrador > Configuração > Monitor Log de Execução:

Figura 13: Monitor Log de Execução


Ao acessar o menu, a seguinte tela será apresentada: Selecionar nos campos marcados conforme abaixo. Observação: Nessa tela podem ser consultados todos os logs de comunicação.

Figura 14: Monitor Log de Execução

• Os campos com Tipo XML podem ser acessados através de dois cliques, mostrando a requisição enviada.
  Para verificação de informações mais completas, poderá acessar o log que fica dentro da pasta Linx DMS Integrador, nomeado com a data conforme exemplo: "LDIServer_20200618.log".
  Como dica, para o momento da instalação, é importante que as dlls LDVeiculoCompartilhado01.dll, LDUtils01.dll, LDFuncoes01.dll e borlndmm.dll sejam incluídas na pasta "C: \ LinxDMSIntegrador \ Pacotes", pois elas são necessárias para a execução do eLDIDdxVW.exe.

Utilização do processo

O Linx DMS Integrador é responsável por efetuar a comunicação entre o BRAVOS e o Barramento Linx.
São realizadas as seguintes comunicações:

• Consulta de Reservas
  São consultadas as reservas pendentes de inclusão no BRAVOS.
  Toda reserva pendente é incluída no BRAVOS. Caso o cliente não exista, será cadastrado automaticamente como pessoa física, mas o cadastro do cliente de ser complementado para o faturamento da proposta.

• Consulta de Negociações
  São consultadas as negociações pendentes de inclusão no BRAVOS.
  Toda negociação pendente é incluída no BRAVOS levando em consideração as informações de vendedor, cliente, veículo e valores recebidas do DDX.
  A seguir, são indicados alguns campos que possuem um tratamento especial:

• • Contato
    Forma de Contato: Presencial ou Feirão.
    Para Presencial, é utilizada a forma de contato com o tipo "Pessoal (Showroom)" e para Feirão é utilizada a forma de contato com o tipo "Pessoal (Externo)".
  • Origem do Tráfego: De acordo com o padrão definido nos parâmetros do módulo de veículos (aba Geral).
  • Canal de Acesso: De acordo com o padrão definido nos parâmetros do Fábrica VW.

• Interesse
  • Modelo: Conforme o modelo recebido do DDX.
  • Possibilidade de Venda: Quente.
    
    
• Formação de Preço
  • Condições de Pagamento: São incluídas as condições referentes ao Sinal, Valor de veículo usado na troca e à Entrada.
    Importante:
    • O valor do sinal é descontado do valor da entrada.O valor do financiamento é apresentado no campo "Saldo a Financiar".
    • Observações: Conforme o campo "Comentários" recebido do DDX.

• Proposta
  • Condições de Pagamento: São incluídas as condições referentes ao sinal (adiantamento), ao valor da entrada, ao valor do veículo usado na troca e ao financiamento.
  • Com relação ao sinal, será gerado um adiantamento de cartão de crédito para o cliente conforme os parâmetros informados no Fábrica VW. Se ocorrer alguma inconsistência no lançamento do adiantamento, a condição de pagamento do sinal não será gravada.
    Importante: O valor do sinal é descontado do valor da entrada.
    Com relação ao financiamento, será gravada a financeira recebida na negociação gerada no DDX VW.
  • Observações: Conforme o campo "Comentários" recebido do DDX.
    Quando a concessionária utilizar os parâmetros de observação para a proposta (parâmetros de Veículos > aba Veículo), os comentários recebidos do DDX são incluídos após as observações.

Envio de Estoque

O estoque disponível na concessionária é transmitido para o DDX contendo informações do veículo e seus opcionais, levando em consideração o parâmetro "Situações de veículo que não serão enviados no processo".
Importante: A informação referente ao desconto máximo para um veículo é obtida no cadastro do modelo, aba Geral, campo "Desconto Máximo". Se estiver em branco, será enviado 100%, caso contrário, será enviado o valor existente no campo.

Envio de Vendedores

O cadastro de vendedores é enviado para o DDX.
São enviados todos os vendedores com cadastro ativo do departamento de veículos novos.
Importante: Para o vendedor consultar os veículos de todas as revendas no DDX, é preciso que tenha permissão 284 (ALTERAR CAMPO DE SELEÇÃO DE EMPRESA/REVENDA) do BRAVOS.

Envio das financeiras

O cadastro de financeiras é enviado para o DDX.
São enviadas todas as financeiras cadastradas como ativas no Bravos (menu Faturamento > Cadastro > Financeiras).
No BRAVOS, a tela de consulta de propostas (menu Veículos > Consultas / Relatórios > Consulta Proposta) permite o filtro por Número de Negociação, conforme a tela a seguir:

Figura 15: Consulta Propostas

A grade de resultado apresenta uma coluna com o número de negociação.

Figura 16: Consulta Propostas - Resultado

Caso a coluna não apareça para algum usuário, é possível incluí-la manualmente. Para isso, clique no canto superior esquerdo da grade e selecione o campo.

Figura 17: Manutenção de colunas

Para auxiliar a verificação de quais informações foram recebidas do DDX VW, acesse a aba DDX na tela de manutenção da Proposta.
Aba DDX > Geral:

Figura 18: Proposta – DDX Geral

O campo "Observação da Integração" estará preenchido quando ocorrer alguma situação inesperada na inclusão da negociação.

Figura 19: Proposta – DDX Valores

• Depois de gerada a proposta no BRAVOS, o processo segue conforme uma proposta normal do BRAVOS.

Conteúdo do pacote

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.