Versão 63ESP3 - Instalação do ConnectLead x Gateway

De Dealernet Wiki | Portal de Soluo, Notas Tcnicas, Verses e Treinamentos da Ao Informtica

Edição feita às 18h46min de 25 de abril de 2016 por Thais.jatoba (disc | contribs)

Tabela de conteúdo

Introdução

  • ConnectLeadGateway é uma integração entre o sistema Dealernet e o sistema ConnectLead visando a manutenção de atendimentos na venda de veículos, juntamente com consulta de propostas e reservas.

Obs.:

• Antes da instalação, certifique-se de que o webservice não está instalado na máquina, indo no Painel de Controle do Windows e caso o programa “ConnectLeadGateway.Gateway.Setup” este instalado, desinstale-o;

• Verifique se ele está publicado no IIS do servidor. Caso esteja, remova-o.

Instalação

  • Na janela ConnectLeadGateway clique em Avançar.

Arquivo:Chamado501309_imagem1.jpg

  • No campo Diretório Virtual insira a palavra “ConnectLeadGateway”. Caso tenha criado algum site específico para esta publicação, o usuário pode seleciona-lo no campo Site. Em Pool de Aplicativos, o usuário deve selecionar um pool que utilize a versão 4.0 do .NET Framework. Por fim, clique no botão Avançar.

Arquivo:Chamado501309_imagem2.jpg

  • Na janela Confirmar Instalação, clique em Avançar para iniciar a instalação.

Arquivo:Chamado501309_imagem3.jpg

  • Instalação concluída. Clique em Fechar.

Arquivo:Chamado501309_imagem4.jpg

  • Na janela Configurações do ConnectLeadGateway / Webservice informe o Servidor (nome do servidor do banco de dados), Banco Matriz (banco de dados da matriz, que será atualizado e irá disponibilizar as informações), Login (login do banco de dados) e Senha (senha de acesso ao banco de dados).
  • Na Configuração do Webservice marque o campo Gerar Log se desejar a geração detalhada do log de execução, marque o campo Gerar XML se desejar gravar os dados transitados pela integração e por fim informe o caminho onde os arquivos de log devem ser salvos.

Arquivo:Chamado501309_imagem5.jpg

  • O pacote de instalação da solução ConnectLeadGateway está finalizado.

Obs.:

• Após a instalação padrão do webservice, o caminho para o webservice será http://(localhost)/ConnectLeadGateway/ConnectLead.asmx. Este caminho pode sofrer alteração se for criado um site específico para o webservice;

• Caso a janela de configuração do webservice não apareça durante a instalação ou o mesmo precise ser reconfigurado, vá na pasta C:\inetpub\wwwroot\ConnectLeadGateway e execute o arquivo ConnectLeadGateway.WebConfig como administrador. Será necessário reiniciar o site no IIS.

Configuração

  • Antes de seguir as indicações abaixo, certifique-se de que todos os scripts necessários para a instalação de serviço e da solução no sistema tenham sido executados no banco de dados.
  • Para cadastrar os atendimentos, é necessário informar o CPF do funcionário na integração. Este CPF deve ser igual ao cadastrado no Dealernet, na tela de cadastro de usuários. O funcionário não deve ter data de saída informada.

Arquivo:Chamado501309_imagem6.jpg

  • No cadastro de um atendimento, é necessário que informe o código do cliente ou o nome do mesmo, para a rotina ser realizada com sucesso.

Métodos

  • Atualizar Cliente - este método serve para atualização do cadastro de clientes no banco, envolvendo rotina de inclusão e atualização de clientes. A atualização será feita caso o campo “ClienteCPF” já possua um equivalente na tabela “ger_cg”, campo “cg_cpfcnpj”.

- O retorno será o código cadastrado ou atualizado do cliente, 0 (zero) caso ocorra um erro desconhecido, e um número negativo para erros tratados. Em todos os casos, uma mensagem será retornada em conjunto.

- Consulta

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<AtualizarCliente xmlns="http://tempuri.org/">

<Acesso>

<Usuario>string</Usuario>

<Senha>string</Senha>

<EmpresaId>string</EmpresaId>

</Acesso> <p align="justify"><Cliente>

<ClienteNome>string</ClienteNome>

<ClienteId>string</ClienteId>

<ClienteCPF>string</ClienteCPF>

<ClienteRGInscricao>string</ClienteRGInscricao>

<ClienteLogradouro>string</ClienteLogradouro>

<ClienteBairro>string</ClienteBairro>

<ClienteCidade>string</ClienteCidade>

<ClienteEstado>string</ClienteEstado>

<ClienteCEP>string</ClienteCEP>

<ClienteNumero>string</ClienteNumero>

<ClienteComplemento>string</ClienteComplemento>

<ClienteTipo>string</ClienteTipo>

<ClienteSexo>string</ClienteSexo>

<ClienteEstadoCivil>string</ClienteEstadoCivil>

<ClienteEscolariadade>string</ClienteEscolariadade>

<ClienteCNH>string</ClienteCNH>

<ClienteAniversarioFundacao>dateTime</ClienteAniversarioFundacao>

<ClienteEmail>string</ClienteEmail>

<Telefones>

<Telefone>

<TelefoneDDD>string</TelefoneDDD>

<TelefoneNumero>string</TelefoneNumero>

<TelefoneTipo>string</TelefoneTipo>

</Telefone>

<Telefone>

<TelefoneDDD>string</TelefoneDDD>

<TelefoneNumero>string</TelefoneNumero>

<TelefoneTipo>string</TelefoneTipo>

</Telefone>

</Telefones>

<Veiculos>

<Veiculo>

<VeiculoId>string</VeiculoId>

<VeiculoChassi>string</VeiculoChassi>

<VeiculoNotaFiscal>string</VeiculoNotaFiscal>

<VeiculoNotaSerie>string</VeiculoNotaSerie>

<VeiculoNotaDataEmissao>dateTime</VeiculoNotaDataEmissao>

</Veiculo>

<Veiculo>

<VeiculoId>string</VeiculoId>

<VeiculoChassi>string</VeiculoChassi>

<VeiculoNotaFiscal>string</VeiculoNotaFiscal>

<VeiculoNotaSerie>string</VeiculoNotaSerie>

<VeiculoNotaDataEmissao>dateTime</VeiculoNotaDataEmissao>

</Veiculo>

</Veiculos>

</Cliente>

</AtualizarCliente>

</soap:Body>

</soap:Envelope>

- Retorno

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<AtualizarClienteResponse xmlns="http://tempuri.org/">

<AtualizarClienteResult> <p align="justify"> <RetornoCod>int</RetornoCod>

<RetornoMensagem>string</RetornoMensagem>

</AtualizarClienteResult>

</AtualizarClienteResponse>

</soap:Body>

</soap:Envelope>

  • Atualizar Proposta- este método serve para atualização do cadastro de propostas no banco, envolvendo rotina de inclusão e atualização de propostas. A atualização será feita caso o código de proposta passada no objeto exista no banco ou se o veículo tiver proposta válida.

- O retorno será o código cadastrado ou atualizado da proposta, 0 (zero) caso ocorra um erro desconhecido, e um número negativo para erros tratados. Em todos os casos, uma mensagem será retornada em conjunto.

- Consulta

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<AtualizarProposta xmlns="http://tempuri.org/">

<Acesso>

<Usuario>string</Usuario>

<Senha>string</Senha>

<EmpresaId>string</EmpresaId>

</Acesso>

<Proposta>

<PropostaId>string</PropostaId>

<ClienteCPF>string</ClienteCPF>

<VendedorCPF>string</VendedorCPF>

<VeiculoChassi>string</VeiculoChassi>

<AtendimentoId>string</AtendimentoId>

<PropostaValor>double</PropostaValor>

<ServicosAdicionais>

<ServicoAdicional>

<ServicoAdicionadoId>string</ServicoAdicionadoId>

<ServicoAdicionadoValorUnitario>double</ServicoAdicionadoValorUnitario>

<ServicoAdicionadoQuantidade>double</ServicoAdicionadoQuantidade>

<ServicoAdicionadoFinanciado>string</ServicoAdicionadoFinanciado>

<ServicoAdicionadoCobrado>string</ServicoAdicionadoCobrado>

</ServicoAdicional>

<ServicoAdicional>

<ServicoAdicionadoId>string</ServicoAdicionadoId>

<ServicoAdicionadoValorUnitario>double</ServicoAdicionadoValorUnitario>

<ServicoAdicionadoQuantidade>double</ServicoAdicionadoQuantidade>

<ServicoAdicionadoFinanciado>string</ServicoAdicionadoFinanciado>

<ServicoAdicionadoCobrado>string</ServicoAdicionadoCobrado>

</ServicoAdicional>

</ServicosAdicionais>

<Pagamentos>

<PagamentoProposta>

<TipoPagamento>string</TipoPagamento>

<ValorPagamento>double</ValorPagamento>

<FinanciamentoId>string</FinanciamentoId>

<PlanoFinanciamentoId>string</PlanoFinanciamentoId>

<ParcelasPlano>int</ParcelasPlano>

</PagamentoProposta>

<PagamentoProposta>

<TipoPagamento>string</TipoPagamento>

<ValorPagamento>double</ValorPagamento>

<FinanciamentoId>string</FinanciamentoId>

<PlanoFinanciamentoId>string</PlanoFinanciamentoId>

<ParcelasPlano>int</ParcelasPlano>

</PagamentoProposta>

</Pagamentos>

</Proposta>

</AtualizarProposta>

</soap:Body>

</soap:Envelope>

- Retorno

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<AtualizarPropostaResponse xmlns="http://tempuri.org/">

<AtualizarPropostaResult>

<RetornoCod>int</RetornoCod>

<RetornoMensagem>string</RetornoMensagem>

</AtualizarPropostaResult>

</AtualizarPropostaResponse>

</soap:Body>

</soap:Envelope>

  • Cadastra Atendimento
- Consulta

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<CadastraAtendimento xmlns="http://tempuri.org/">

<ws_Atendimento>

<AtendimentoData>dateTime</AtendimentoData>

<AtendimentoVeiculoInteresse>string</AtendimentoVeiculoInteresse>

<AtendimentoMidia>string</AtendimentoMidia>

<ClienteNome>string</ClienteNome>

<ClienteCPF>string</ClienteCPF>

<ClienteId>string</ClienteId>

<ClienteEmail>string</ClienteEmail>

<ClienteTelefone>string</ClienteTelefone>

<ClienteCelular>string</ClienteCelular>

<VeiculoChassi>string</VeiculoChassi>

<VendedorCPF>string</VendedorCPF>

<EmpresaId>string</EmpresaId>

</ws_Atendimento>

</CadastraAtendimento>

</soap:Body>

</soap:Envelope>

- Retorno

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<CadastraAtendimentoResponse xmlns="http://tempuri.org/">

<CadastraAtendimentoResult>long</CadastraAtendimentoResult>

</CadastraAtendimentoResponse>

</soap:Body>

</soap:Envelope>

Obs.:

• Caso o retorno seja 0(zero), houve erro ao cadastrar o atendimento.

  • Consulta Cliente
- Consulta

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<ConsultaCliente xmlns="http://tempuri.org/">

<ws_ClienteCPF>string</ws_ClienteCPF>

<ws_ClienteTelefone>string</ws_ClienteTelefone>

<ws_ClienteEmail>string</ws_ClienteEmail>

</ConsultaCliente>

</soap:Body>

</soap:Envelope>

- Retorno

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<ConsultaClienteResponse xmlns="http://tempuri.org/">

<ConsultaClienteResult>

<Cliente>

<ClienteNome>string</ClienteNome>

<ClienteId>string</ClienteId>

<ClienteEndereco>string</ClienteEndereco>

<ClienteCPF>string</ClienteCPF>

<Telefones>

<Telefone xsi:nil="true" />

<Telefone xsi:nil="true" />

</Telefones>

<Veiculos>

<Veiculo xsi:nil="true" />

<Veiculo xsi:nil="true" />

</Veiculos>

</Cliente>

<Cliente>

<ClienteNome>string</ClienteNome>

<ClienteId>string</ClienteId>

<ClienteEndereco>string</ClienteEndereco>

<ClienteCPF>string</ClienteCPF>

<Telefones>

<Telefone xsi:nil="true" />

<Telefone xsi:nil="true" />

</Telefones>

<Veiculos>

<Veiculo xsi:nil="true" />

<Veiculo xsi:nil="true" />

</Veiculos>

</Cliente>

</ConsultaClienteResult>

</ConsultaClienteResponse>

</soap:Body>

</soap:Envelope>

  • Consulta Reserva ou Proposta
- Consulta

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<ConsultaReservaOuProposta xmlns="http://tempuri.org/">

<ws_AtendimentoId>string</ws_AtendimentoId>

</ConsultaReservaOuProposta>

</soap:Body>

</soap:Envelope>

- Retorno

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<ConsultaReservaOuPropostaResponse xmlns="http://tempuri.org/">

<ConsultaReservaOuPropostaResult>

<PropostaReservaExistente>

<Tipo>string</Tipo>

<VeiculoId>string</VeiculoId>

<ChassiPlaca>string</ChassiPlaca>

<Modelo>string</Modelo>

<FabricacaoModelo>string</FabricacaoModelo>

<Cor>string</Cor>

<Validade>dateTime</Validade>

<Valor>double</Valor>

<Opcionais>

<Opcional xsi:nil="true" />

<Opcional xsi:nil="true" />

</Opcionais>

</PropostaReservaExistente>

<PropostaReservaExistente>

<Tipo>string</Tipo>

<VeiculoId>string</VeiculoId>

<ChassiPlaca>string</ChassiPlaca>

<Modelo>string</Modelo>

<FabricacaoModelo>string</FabricacaoModelo>

<Cor>string</Cor>

<Validade>dateTime</Validade>

<Valor>double</Valor>

<Opcionais>

<Opcional xsi:nil="true" />

<Opcional xsi:nil="true" />

</Opcionais>

</PropostaReservaExistente>

</ConsultaReservaOuPropostaResult>

</ConsultaReservaOuPropostaResponse>

</soap:Body>

</soap:Envelope>

Obtido em "https://wiki.dealernet.com.br/index.php/Vers%C3%A3o_63ESP3_-_Instala%C3%A7%C3%A3o_do_ConnectLead_x_Gateway"