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: Integração | Detalhamento | Consulta do estoque | O DDX VW consulta o estoque disponível no BRAVOS do DN selecionado pelo cliente. | Inclusão da reserva | O DDX VW, com base no veículo escolhido, envia a reserva para o BRAVOS. | Inclusão da negociação | O DDX VW, com base no veículo reservado, envia a negociação para o BRAVOS. |
![](/download/attachments/219138118/image2021-5-4_17-4-31.png?version=1&modificationDate=1620226814240&api=v2)
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
BRAVOSParâ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
![](/download/attachments/219138118/worddav7beda5b2816f771c555eed83515db444.png?version=1&modificationDate=1620226826471&api=v2) Figura 2: Parâmetros de Veículos
Condição de pagamentoMenu: 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)
- 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.
![](/download/attachments/219138118/worddavc481818ebb9b773a5da69d8c886f520a.png?version=1&modificationDate=1620226825831&api=v2) 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.
![](/download/attachments/219138118/worddav301fd19da9d9831b1a496bf7c1ff4e42.png?version=1&modificationDate=1620226825228&api=v2) 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âmetrosMenu: Fábrica VW > Parâmetros Acessar a aba DDX e preencher os campos solicitados.
![](/download/attachments/219138118/worddav866805e97a356ddcedbda727318af46b.png?version=1&modificationDate=1620226824615&api=v2) 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.
![](/download/attachments/219138118/worddavf0008c63c1e4987a50ee20a029a2396d.png?version=1&modificationDate=1620226823972&api=v2) Figura 6: Parâmetros VW – Situações de veículo
![](/download/attachments/219138118/worddav6f076ed6180ad89d72821c1d5b429cff.png?version=1&modificationDate=1620226823384&api=v2) 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: - 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.
- 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".
- 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
- Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
- Acesse o menu "Configuração > DDX VW";
- Na aba "Configuração", preencha os dados de acesso ao banco de dados;
![](/download/attachments/219138118/worddav0073dd75b0841ad304d2c9343ffe9629.png?version=1&modificationDate=1620226822782&api=v2) 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.
- 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. - Clique em "Next";
- Na tela DDX VW, clique em "Incluir";
![](/download/attachments/219138118/worddav48f2aecbb27d3de50e73719ee7b88a5b.png?version=1&modificationDate=1620226822087&api=v2) Figura 9: Tela de configuração da comunicação
- 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".
![](/download/attachments/219138118/worddav253278e68e4e4bd052182720cbe7bead.png?version=1&modificationDate=1620226821385&api=v2)
- Figura 10: Tela de conclusão das configurações
- Reinicie o serviço do integrador
- No Windows, pressione a tecla do logotipo do Windows + "R";
- Digite services.msc e clique em "Ok";
- Localize e clique sobre o serviço "Linx DMS Integrador";
- Clique em "Reiniciar o serviço";
- Após este procedimento, o status do serviço deve continuar como "Em Execução".
![](/download/attachments/219138118/worddav366edb94941d2529a19aa5e6e6a2db04.png?version=1&modificationDate=1620226820706&api=v2) 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.
![](/download/attachments/219138118/worddavdf29ebc95e96a2801953e12b84456f50.png?version=1&modificationDate=1620226819989&api=v2) 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.
![](/download/attachments/219138118/worddav80861439671bd42df0b1e22057477fb9.png?version=1&modificationDate=1620226819339&api=v2) 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:
![](/download/attachments/219138118/worddavdb224dfa00cdbad9acb07882580f52db.png?version=1&modificationDate=1620226818766&api=v2) 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.
![](/download/attachments/219138118/worddav09cdc6526f6e110534b96eeaa75ff748.png?version=1&modificationDate=1620226818173&api=v2) 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 EstoqueO 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 VendedoresO 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 financeirasO 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:
![](/download/attachments/219138118/worddavd4ec6a7d8318b4b3220c82d1145ad2dd.png?version=1&modificationDate=1620226817546&api=v2) Figura 15: Consulta Propostas A grade de resultado apresenta uma coluna com o número de negociação.
![](/download/attachments/219138118/worddav2a4e4853529c2e32c5dfe260a88af934.png?version=1&modificationDate=1620226816941&api=v2) 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.
![](/download/attachments/219138118/worddavc10775a2051ecfd4e3fc5fe9c12ef5ce.png?version=1&modificationDate=1620226816332&api=v2) 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:
![](/download/attachments/219138118/worddav7f664091bd6c4cb6f5148e22dd0fb171.png?version=1&modificationDate=1620226815589&api=v2) 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.
![](/download/attachments/219138118/worddav5644ab368164b86bd195e3d519fc87fc.png?version=1&modificationDate=1620226814935&api=v2) 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 | Nome do arquivo | Comentário |
---|
1 | BRAVOS.exe | Executável do Bravos.exe. | 2 | FabricaVW.exe | Executável de comunicação com a fábrica VW. | 3 | FluxoAtendimento.exe | Executável do Fluxo de Atendimento Avançado. | 4 | LinxDMSIntegrador.exe | Instalador do Linx DMS Integrador. | 5 | Linx DMS Integrador - Manual do DDX VW.pdf | Este documento. |
|