Integração Sisdia com Itaú_iCarros

INTEGRAÇÃO SISDIA x iCARROS
DMS Sisdia

Pré-requisitos
Para utilização do processo de Integração Sisdia x iCarros, deverão ser atendidos os seguintes pré-requisitos:

• O Sistema deverá estar atualizado com o pacote v06.20 de 12/12/2016 ou superior.

• A biblioteca Comunicação Sisdia x iCarros deverá ser atualizada da página.
• Deverão ser realizadas as configurações necessárias para suportar a comunicação entre o Sisdia e o iCarros (ver o roteiro desta configuração no final do documento).
• Deverão ser realizadas as configurações necessárias para utilização do processo de manipulação de fotos (ver o roteiro desta configuração no final do documento).
• Deverá ser realizada a programação do crontab para o envio automático das avaliações de crédito na geração das fichas de negócio pelo SVT (ver roteiro desta programação no final do documento).
• Deverá ser realizada a programação do crontab para importação automática das leads (ver roteiro desta programação no final do documento).
• Deverá ser assinado um contrato de utilização entre o concessionário e o iCarros, através do qual as filiais contempladas serão habilitadas para realização da integração. Neste momento serão disponibilizados os códigos, usuários e senhas de acesso ao iCarros e contratados os planos de anúncio.

Objetivo e características
O objetivo do processo de Integração Sisdia x iCarros é possibilitar a integração das informações referentes à venda de veículos novos e usados no Sisdia, com o site iCarros do Itaú.
A utilização desta integração não é obrigatória, podendo ser ativada/desativada para cada filial da empresa, através do processo de parametrização da integração.
As integrações serão realizadas on line, através de webservices (jason), e estarão presentes em diversos processos do sistema.
Composição
O processo de Integração Sisdia x iCarros possui a seguinte composição: (ver detalhes na documentação de programa de cada um dos processos):
1) Parâmetros da Integração Sisdia x iCarros: CADA9020
Através deste processo será ativada a utilização da integração Sisdia x iCarros para cada filial, e realizado o cadastramento, a alteração e a exclusão dos parâmetros a serem utilizados nesta integração.
Após o cadastramento ou a alteração dos parâmetros, deverá ser executada a opção Credenciais, para que estas informações sejam enviadas para o iCarros e a integração com a filial seja habilitada.

2) Correlação das informações do iCarros com o Sisdia: VEIC3080
Através deste processo serão realizados a importação das informações dos veículos disponibilizadas pelo iCarros (versões, opcionais, cores e combustíveis) e a correlação destas informações com o Sisdia.




Na opção de Importação, serão carregados automaticamente para o Sisdia, todos os tipos de informação de veículos disponibilizados pelo iCarros (versões, opcionais, cores e combustíveis). Neste caso, serão importadas somente as novas informações disponibilizadas ou as informações já disponibilizadas anteriormente mas ainda não correlacionadas.

Na opção de Correlação, serão correlacionados manualmente cada um dos tipos de informações disponibilizados pelo iCarros (versões, opcionais, cores e combustíveis). Neste caso, serão incluídas as correlações para as novas informações disponibilizadas pelo iCarros e/ou alteradas as correlações já incluídas anteriormente.

Na correlação de Versões, serão correlacionadas cada uma das versões de veículos disponibilizadas pelo iCarros com suas respectivas versões no Sisdia ("uma" versão iCarros para "n" versões Sisdia).

Na correlação de Opcionais, serão correlacionados cada um dos opcionais de veículos disponibilizadas pelo iCarros com seus respectivos opcionais no Sisdia ("um" opcional iCarros para "n" opcionais Sisdia).

Na correlação de Cores, serão correlacionadas cada uma das cores de veículos disponibilizadas pelo iCarros com suas respectivas cores no Sisdia ("uma" cor iCarros para "n" cores Sisdia).

Na correlação de Combustíveis, serão correlacionados cada um dos combustíveis de veículos disponibilizadas pelo iCarros com seus respectivos combustíveis no Sisdia ("um" combustível iCarros para "n" combustíveis Sisdia).

3) Entrada de Veículos no Estoque:
A entrada dos veículos novos e/ou usados no estoque, utilizando a integração com o iCarros, será realizada através dos seguintes processos:

1. 1. Avaliação de Veículos Usados: VEIC0040

Através deste processo será realizada a avaliação dos veículos usados que darão entrada no estoque. Caso o iCarros esteja ativo na filial onde está sendo realizada a avaliação, esta será obrigatória.
Neste caso, serão solicitados os dados do iCarros referentes a Marca, Modelo, Versão e Cor do veículo avaliado, para serem utilizadas na correlação das informações com o Sisdia.

Após a informação dos dados do veículo será disponibilizada uma opção para consulta dos preços mínimos, médios e máximos do veículo, tanto a nível de Brasil quanto a nível de UF da filial onde o veículo está sendo avaliado. Além disso será possível atualizar o preço de mercado do veículo na avaliação, utilizando o preço médio da UF ou o preço médio Brasil (quando o preço médio UF está zerado).

1. 1. Cadastramento de Opcionais: VEIC0050

Através deste processo será realizado o cadastramento dos opcionais dos veículos usados que darão entrada no estoque, para posteriormente serem utilizados no anúncio deste veículo.

1. 1. Emissão de Nota Fiscal de Compra: ORCA2000

Através deste processo será efetuada a emissão da nota fiscal de compra dos veículos usados que darão entrada no estoque, caso o fornecedor do veículo não emita nota fiscal (pessoa física). Neste caso, como as informações do iCarros já foram solicitadas anteriormente no processo de avaliação de usados, a correlação entre as informações do iCarros e do Sisdia, caso ainda não exista, será gravada automaticamente.

1. 1. Entrada de Nota Fiscal de Compra: ENTR1000

Através deste processo será efetuada a entrada da nota fiscal de compra dos veículos novos ou usados que darão entrada no estoque, caso o fornecedor do veículo já tenha emitido anteriormente a nota fiscal (pessoa jurídica). No caso de veículos usados, como as informações do iCarros já foram solicitadas anteriormente no processo de avaliação, a correlação entre as informações do iCarros e do Sisdia, caso ainda não exista, será gravada automaticamente.

1. 1. Entrada do Veículo no Estoque: VEIC0200

Através deste processo será efetuada a entrada dos veículos novos ou usados no estoque. No caso de veículos novos, a correlação entre as informações do iCarros e do Sisdia, caso ainda não exista, deverá ser obrigatoriamente cadastrada pelo usuário.

4) Anúncio dos Veículos: VEIC3070
Através deste processo será realizado o envio do anúncio dos veículos novos ou usados do estoque, permitindo a inclusão, alteração ou exclusão do anúncio do veículo.
Para isso, deverão ser selecionados os veículos do estoque a serem anunciados, informando a ação a ser realizada no anuncio:

• Inclusão: Inclusão de novos anúncios para veículos ainda não anunciados.
• Alteração: Alteração dos anúncios de veículos já anunciados.
• Exclusão: Exclusão dos anúncios de veículos já anunciados.
• Faturados: Exclusão dos anúncios de veículos já faturados.

Após a seleção dos anúncios, estes serão exibidos em um gerenciador para serem preparados para o envio:

Através da opção "Dados Veículos", os anúncios serão preparados para envio, informando ou alterando os detalhes do veículo no anúncio:

Nesta opção, através da sub-opção "Opcionais", serão informados ou alterados os opcionais do veículo no anúncio:

Nesta opção, através da sub-opção "Fotos", serão definidas as fotos do veículo que irão compor o anúncio. Para isso, através das opções abaixo, serão vinculadas e/ou desvinculadas ao veículo as fotos disponíveis na base de dados, definidas quais fotos do veículo serão incluídas ou excluídas do anúncio, e/ou alterada a ordem de exibição das fotos no anúncio:

• "+ Nova": Será vinculada uma nova foto ao chassi do veículo.
• "Excluir Foto": Será desvinculada determinada foto do chassi do veículo.
• "Usar em Anuncios: On / Off": Será incluída / excluída a foto do veículo no anúncio. As opções "On" / "Off" estão ativadas dependo se a foto posicionada já estiver ou não incluída no anuncio.

OBS: A alteração da ordenação das fotos no anúncio poderá ser feita clicando nas fotos e arrastando-as para a posição desejada.

Nesta opção, através da sub-opção "Envia", poderá ser enviado individualmente o anúncio que estiver sendo preparado:

Após a preparação dos anúncios, todos os anúncios já preparados serão marcados automaticamente com ""* para serem enviados. Caso não deseje enviar algum dos anúncios, estes deverão ser desmarcados teclando <Enter>.
Através da opção "Envia", todos os anúncios marcados com "*" serão automaticamente enviados:

5) Captura de Leads: VEIC9900
Através deste processo será realizada a consulta das leads disponibilizadas pelo iCarros, a importação manual ou automática das leads, e a geração das fichas de negócio a partir das leads importadas.
Para realizar a consulta das leads disponibilizadas pelo iCarros através dos anúncios enviados, deverão ser informados os seguintes campos de filtro:







Após a informação dos campos de filtro, as leads selecionadas serão exibidas em um gerenciador de leads:











Através da opção "Detalhe Proposta", serão consultados os detalhes da proposta gerada para cada lead:











Através da opção "Detalhe Financiamento", serão consultados os detalhes do financiamento simulado para cada lead, quando é realizada uma pré-análise da proposta:










Através da opção "Detalhe Lead", serão consultados os detalhes de cada lead:











Através da opção "Pré-Aprovado", serão consultadas as informações da análise financeira do cliente de cada lead:










Através da opção "Importa Lead", será realizada a importação manual das leads, onde poderá ser utilizado um período fixo de 90 dias ou especificada uma data inicial para importação:










Através da opção "Controle Importação", será disponibilizada uma tela para controle das importações automáticas das leads. A importação automática será realizada através da programação via cron (robô), onde é definida a periodicidade da importação. Neste caso serão importadas todas as leads disponibilizadas entre a data/hora da última importação e a data/hora atual:








Através da opção "Gera Ficha Negócio", serão geradas as fichas de negócio para as leads onde foram informados os agentes responsáveis pelas fichas:






6) Avaliação de Crédito do Cliente:
A avaliação de crédito dos clientes, utilizando a integração com o iCarros, será realizada através dos seguintes processos:

1. 1. Ficha de Negócios: VEIC0290

Na geração da ficha de negócios, caso a integração com o iCarros esteja ativa e o cliente possua crédito pré-aprovado, serão exibidas a logomarca do Itaú e uma mensagem de alerta da existência de credito pré-aprovado:





Caso o cliente não possua crédito pré-aprovado, não serão exibidas a logomarca do Itaú e a mensagem de alerta da existência de credito pré-aprovado, e neste caso a opção "Pré-Aprovado" não será disponibilizada:








Além disso, caso a integração com o iCarros esteja ativa, será disponibilizada a opção "Pré-Aprovado", através da qual serão consultados os detalhes da análise de crédito do cliente.
Ao ser acionada, caso o cliente possua crédito pré-aprovado, será disponibilizada a tela com os detalhes da análise de crédito:

Caso o cliente não possua crédito pré-aprovado, será exibida uma mensagem de consistência: Cliente não possui crédito pré-aprovado e não será exibida nenhuma tela.
OBS: No caso das fichas de negócio geradas pelo SVT, a avaliação de crédito será solicitada automaticamente e consultada posteriormente através do processo de Consulta Avulsa Análise Crédito descrito logo abaixo no item 6.3.

1. 1. Reserva de Veículos: CLIV3000

Na reserva de veículos, caso a integração com o iCarros esteja ativa e o cliente possua crédito pré-aprovado, serão exibidas a logomarca do Itaú e uma mensagem de alerta da existência de credito pré-aprovado:

Caso o cliente não possua crédito pré-aprovado, não serão exibidas a logomarca do Itaú e a mensagem de alerta da existência de credito pré-aprovado, e neste caso a opção "Pré-Aprovado" não será disponibilizada:








Além disso, caso a integração com o iCarros esteja ativa, será disponibilizada a opção "Pré-Aprovado", através da qual serão consultados os detalhes da análise de crédito do cliente.
Ao ser acionada, caso o cliente possua crédito pré-aprovado, será disponibilizada a tela com os detalhes da análise de crédito:

Caso o cliente não possua crédito pré-aprovado, será exibida uma mensagem de consistência: Cliente não possui crédito pré-aprovado e não será exibida nenhuma tela.

1. 1. Consulta Avulsa Análise Crédito: VEIC0291

Através deste processo será realizada a consulta avulsa da avaliação de crédito dos clientes. Poderá ser executada para qualquer cliente, a qualquer momento.
Para solicitação da avaliação de crédito deverá ser informado o código do cliente:







Após a solicitação, caso o cliente possua crédito pré-aprovado, serão exibidos os detalhes da análise de crédito do cliente:

Caso o cliente não possua crédito pré-aprovado, será exibida uma mensagem de consistência: Cliente não possui crédito pré-aprovado e não será exibida nenhuma tela.
OBS: No caso das fichas de negócio geradas pelo SVT, foi solicitada automaticamente uma avaliação de crédito, que será consultada por este processo.




Configurações
Para utilização do processo de Integração Sisdia x iCarros, deverão ser realizadas as seguintes configurações:
A - Configurações para a comunicação entre o Sisdia e o iCarros:

1. Copiar as bibliotecas baixadas da página (comunicacao_itau.sh, comunicacao_itau.jar, tarefa_itau.sh e tarefa_itau.jar) para as pastas de execução do Sisdia (ex: /sisdia). Todos os próximos passos são referentes a configuração dos arquivos comunicacao_itau.sh e tarefa_itau.sh. (Para download, clique aqui)

1. Na primeira linha do shell, acessar o diretório da instância do sisdia (ex: cd /sisdia/dqatmp01).

1. Se o diretório de instalação do java não for o padrão (/usr/local/jre1.6), deverá ser editado alterando o valor da variável JAVA_HOME (ex: export JAVA_HOME=/usr/java/ jdk1.7.0_71).

1. Se o usuário/senha para conexão ao banco de dados pelo tomcat não forem o padrão (tomcat/703kg7d14), deverá ser editado alterando o valor da variável STRING_CONEXAO.

1. Existem parametrizações que devemos configurá-las manualmente que são elas:

• HOST:
• SERVICO:
  Para ambos, conseguimos os valores através do sqlhosts executando o comando abaixo.
  
  Conforme exemplo abaixo, temos a coluna 3 com os valores de HOST e coluna 4 temos valores de SERVICO.
  
  Conforme exemplo abaixo:
  

1. Para testar se ficou OK, execute o seguinte comando na pasta de execução do sisdia: ./comunicacao_itau.sh –v / ./tarefa_itau.sh -v

Esse comando vai mostrar a versão do programa e em seguida vai tentar conectar ao banco de dados e ao webservice, ex:
./comunicacao_itau.sh -v
v1.0 13/09/2016)
testando conexao ao o banco de dados ...OK
testando conexao ao web service ...OK

B - Configurações para o processo de manipulação de fotos:

1. O programa para manipulação de fotos é disponibilizado dentro do contexto do Sisdia Evolution, e é instalado normalmente pelo instalador do evolution (genexus).

A pasta padrão para gravação das imagens é "/sisdia/imagens". Caso não tenhamos este diretório "/sisdia/imagens" deverá ser criado o diretório ou alterar o diretório padrão.

1. Para alterar o diretório padrão, deverá alterar o arquivo web.xml, que está dentro do contexto do sisdia evolution no tomcat.

Ex: "/usr/local/tomcat/webapps/sisdiaevolution/WEB-INF/web.xml".

• Alterar os trechos abaixo, substituindo a parte em negrito pela pasta desejada:

<servlet-mapping>
<servlet-name>Image Servlet</servlet-name>
<url-pattern>/sisdia/imagens/CHASSI/*</url-pattern>
</servlet-mapping>
<context-param>
<param-name>DIR_IMAGENS</param-name>
<param-value>/sisdia/imagens</param-value>
</context-param>

• Caso o nome do recurso do banco de dados do pool de conexões do tomcat (/usr/local/tomcat/conf/contexto.xml) não seja o padrão (sisdia), alterar também o seguinte trecho:

<context-param>
<param-name>BANCO_DADOS</param-name>
<param-value>sisdia</param-value>
</context-param>

1. Para manipulação de fotos será necessário realizar algumas parametrizações no CADA9000, que são elas:

• Criar os parâmetros IT1, IT2, IT3 e ISD para as filiais que utilizam o iCarros.
• IT1: Corresponde ao servidor.
• IT2: Corresponde a porta do servidor.
• IT3: Corresponde ao contexto do servidor.
• ISD: Corresponde a instância do servidor.
  
  C – Programação do crontab para envio automático das avaliações de crédito:

1. Conecte-se ao servidor SISDIA com o usuário root.

1. Vá até o diretório /root/bin e edite a biblioteca Run_VEIC0291.sh atualizada anteriormente da página.

1. Para editar digite: vi Run_VEIC0291.sh e proceda as seguintes alterações:

• Procure pelo texto INFORMIXSERVER=ol_standard e caso necessário substitua a variável ol_standard pelo nome da sua instância de produção.
• Procure pelo texto unset FGLGUI. Algumas linhas abaixo, você encontrará o comando: cd /sisdia/SisdiaEvolution, caso necessário deverá substituir por:

cd + o caminho do diretório de produção do SISDIA Evolution.

• Procure pelo texto export PATH=$PATH:/sisdia/SisdiaEvolution, caso necessário alterar pelo diretório de produção do SISDIA Evolution.
• Salve as alterações realizadas no arquivo Run_VEIC0291.sh e o feche. Para sair e salvar digite: <ESC> + :x

1. Execute no prompt do Linux o comando crontab –e

1. Programe o intervalo de dados desejado para a execução do processo, conforme descrito em http://pt.wikipedia.org/wiki/Crontab.

D – Programação do crontab para importação automática das leads:

1. Conecte-se ao servidor SISDIA com o usuário root.

1. Vá até o diretório /root/bin e edite a biblioteca Run_VEIC9901.sh atualizada anteriormente da página.

1. Para editar digite: vi Run_VEIC9901.sh e proceda as seguintes alterações:

• Procure pelo texto INFORMIXSERVER=ol_standard e caso necessário substitua a variável ol_standard pelo nome da sua instância de produção.
• Procure pelo texto unset FGLGUI. Algumas linhas abaixo, você encontrará o comando: cd /sisdia/SisdiaEvolution, caso necessário deverá substituir por:

cd + o caminho do diretório de produção do SISDIA Evolution.

• Procure pelo texto export PATH=$PATH:/sisdia/SisdiaEvolution, caso necessário alterar pelo diretório de produção do SISDIA Evolution.
• Salve as alterações realizadas no arquivo Run_VEIC9901.sh e o feche. Para sair e salvar digite: <ESC> + :x

1. Execute no prompt do Linux o comando crontab –e

1. Programe o intervalo de dados desejado para a execução do processo, conforme descrito em http://pt.wikipedia.org/wiki/Crontab.

Serviços
A – Chamadas:
Todas as chamadas do processo de Integração Sisdia x iCarros serão realizadas através de uma DLL (LinxiCarros.dll):
function DLL_Integra_iCarros (pCodigoServico:Integer; pJSONEnvio:string): string;
Onde:

• pCodigoServico: Indica o serviço desejado (conforme tabela abaixo)
• pJSONEnvio: JSON com os parâmetros de entrada (envio)
• Retorno: String contendo o JSON de retorno da chamada
  B – Código dos Serviços:
  0 = Configura endereço do proxy de destino;
  1 = Envia Credenciais: Registra credenciais da revenda no proxy;
  2 = Obtém Cores: Retorna as cores cadastradas no site iCarros;
  3 = Obtém Acessórios: Retorna os acessórios cadastrados no site iCarros;
  4 = Obtém Combustíveis: Retorna os combustíveis cadastrados no site iCarros;
  5 = Obtém Marcas: Retorna as marcas cadastradas no site iCarros;
  6 = Obtém Modelos: Retorna os modelos cadastrados no site iCarros;
  7 = Obtém Transmissões: Retorna as transmissões cadastradas no site iCarros;
  8 = Obtém Versões: Retorna as versões cadastradas no site iCarros;
  9 = Obtém Provedores Publicidade: Retorna provedores publicidade do site iCarros;
  10 = Obtém Preços de um determinado modelo/ano/km;
  11 = Obtém Dealers: Retorna aos quais a revenda possui acesso;
  12 = Obtém Anúncios: Retorna anúncios associados a um determinado Dealer;
  13 = Envia Anúncio: Envia anúncio para o site;
  14 = Exclui Anúncio: Exclui anúncio do site;
  15 = Informações Anúncio: Retorna informações do anúncio;
  16 = Atualiza Anúncio: Altera/Atualiza anúncio no site;
  17 = Envia Imagem Anúncio: Envia imagem de anúncio ao site;
  18 = Exclui Imagem de Anúncio: Exclui uma imagem do site;
  19 = Ordena Imagens: Ordena as imagens de anúncio no site;
  20 = Obtém Leads: Retorna leads de anúncios dos últimos 90 dias;
  21 = Obtém Leads Desde Data X: Retorna leads de anúncios desde a data informada;
  50 = Obtém transações: Retorna as transações financeiras relacionadas ao CNPJ;
  51 = Cria transação: Cria nova transação financeira, retornando o ID da transação;
  52 = Informações transação: Retorna todas as informações de uma transação;
  53 = Atualiza transação: Altera/Atualiza uma transação;
  54 = Obtém análise de crédito: Retorna análise de crédito de uma transação;
  C – Parâmetros e Retornos dos Serviços:
  Para cada número de serviço definido:
• EnvioServicoX.json (X = Número do serviço)
• RetornoServicoX.json (X = Número do serviço)
  Tabelas
  A – Tabelas do Sistema:
• Parâmetros:

coparisi

• Correlações:

cxmarita cxmarsis
cxmodita cxmodsis
cxverita cxversis
cxcorita cxcorsis
cxaceita cxacesis
cxcomita cxcomsis
cxtraita cxtrasis
cxcidita

• Entrada Veículos:

cxavaita

• Anúncios:

cxanuita cxopcanu cxfotita

• Leads:

cxcomlea cxleadan cxleadcp cxleaddt cxleadfi

• Avaliações Crédito:

cxcreita cxsvtita
B – Tabelas Intermediárias:

• Integrações:

iintegracoes itarefas

• Correlações:

imarcas imodelos iversoes icores
iacessorios icombustiveis itransmissoes icidades

• Entrada Veículos:

iprecos iprecos_uf

• Anúncios:

ianuncios iplanos

• Leads:

ileads ileads_anuncio ileads_financiamento ileads_telefone

• Avaliações Crédito:

ianalisis iresultado_analise ioperacoes ioperacoes_financiamento
icondicoes idados_profissionais idocumentos ienderecos