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 19h06min 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>

  • Bloquear Proposta - este método serve para bloquear uma proposta no sistema Dealernet, atualizando o campo “prop_fandi_bloqueada” para “S” da tabela “vec_prop”. O retorno será o código 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>

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

<ws_acesso>

<Usuario>string</Usuario>

<Senha>string</Senha>

<EmpresaId>string</EmpresaId>

</ws_acesso>

<ws_PropostaId>string</ws_PropostaId>

</BloquearProposta>

</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>

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

<BloquearPropostaResult>

<RetornoCod>int</RetornoCod>

<RetornoMensagem>string</RetornoMensagem>

</BloquearPropostaResult>

</BloquearPropostaResponse>

</soap:Body>

</soap:Envelope>


  • Cadastrar Atendimento- este método serve para cadastrar atendimentos no banco. Caso não seja passado informação no campo “ClienteId”, será necessário preencher pelo menos os campos “ClienteNome” e “ClienteTelefone”.

- O retorno será o código do atendimento cadastrado, 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>

<Cadastrar Atendimento xmlns="http://tempuri.org/">

<ws_acesso>

<Usuario>string</Usuario>

<Senha>string</Senha>

<EmpresaId>string</EmpresaId>

</ws_acesso>

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

</CadastrarAtendimento>

</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>

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

<CadastrarAtendimentoResult>

<RetornoCod>int</RetornoCod>

<RetornoMensagem>string</RetornoMensagem>

</CadastrarAtendimentoResult>

</CadastrarAtendimentoResponse>

</soap:Body>

</soap:Envelope>

  • Consultar Cliente- este método serve para consultar clientes no banco. O retorno será uma lista de clientes que se encaixam nos parâmetros passados.
- 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>

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

<Acesso>

<Usuario>string</Usuario>

<Senha>string</Senha>

<EmpresaId>string</EmpresaId>

</Acesso>

<ClienteCPF>string</ClienteCPF>

<ClienteTelefone>string</ClienteTelefone>

<ClienteEmail>string</ClienteEmail>

</ConsultarCliente>

</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>

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

<ConsultarClienteResult>

<Clientes>

<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 xsi:nil="true" />

<Veiculos xsi:nil="true" />

</Cliente>

<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 xsi:nil="true" />

<Veiculos xsi:nil="true" />

</Cliente>

</Clientes>

</ConsultarClienteResult>

</ConsultarClienteResponse>

</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"