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 v07.10 de 02/02/2017 ou superior.
  • A biblioteca ”Comunicação Sisdia x iCarros”, contendo os arquivos: comunicacao_itau.sh, comunicacao_itau.jar, tarefa_itau.sh e tarefa_itau.jar, deverá estar atualizada.
  • Deverão ser realizadas as configurações necessárias para suportar a comunicação entre o Sisdia e o iCarros, conforme roteiro de configurações descrito no final do documento.
  • Deverão ser realizadas as configurações necessárias para utilização do processo de manipulação de fotos, conforme roteiro de configurações descrito 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, conforme roteiro de programação crontab descrito no final do documento.
  • Deverá ser realizada a programação do crontab para importação automática dos leads, conforme roteiro de programação crontab descrito no final do documento. Neste caso, para não sobrecarregar o servidor, deverá ser programada uma periodicidade de execução maior ou igual a 2 horas.
  • Deverá ser disponibilizado acesso ao IP público para os usuários que utilizarão a integração, evitando bloqueios por firewall.
  • Deverá ser assinado um contrato de utilização entre o concessionário e o Itaú, através do qual as filiais contempladas neste contrato serão habilitadas para realização da integração com o site iCarros e/ou com a financeira Itaú.
  • Na assinatura do contrato, serão disponibilizados os códigos e as senhas dos usuários para acesso às integrações com o site iCarros e/ou com a financeira Itaú.
  • Deverão ser contratados os planos de anúncio para envio de anúncios de veículos novos e/ou de veículos usados para o site iCarros.

Objetivo e características

O objetivo do processo de Integração Sisdia x iCarros é possibilitar a integração das vendas de veículos novos e/ou veículos usados realizadas no Sisdia com o site iCarros e/ou com a financeira Itaú.  
A utilização da Integração Sisdia x iCarros 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 são realizadas on line ou programadas (via crontab), utilizando webservices (jasons), e estão disponíveis em diversos processos do sistema relacionados a venda de veículos novos e/ou usados. 

As integrações são realizadas independentemente da bandeira da filial, estando disponíveis no Sisdia e no LinxMaq, nas versões BDS e Evolution.



Arquitetura
 


Composição

A Integração Sisdia x iCarros é composta pelos seguintes processos do sistema e com os seguintes tipos de integração:

  • Parâmetros da Integração Sisdia x iCarros    → Integração com iCarros Itaú
  • Correlação das Informações Sisdia x iCarros → Integração com iCarros Itaú
  • Anúncio dos Veículos                                     → Integração com iCarros Itaú
  • Importação das Leads                                    → Integração com iCarros Itaú
  • Avaliação de Crédito dos Clientes                  →Integração com Financeira Itaú
  • Entrada de Veículos no Estoque                     → Integração com iCarros Itaú

A seguir será detalhada a integração de cada um dos processos com o iCarros (para um maior detalhamento de cada um dos processos, poderá ser consultada a documentação dos respectivos programas referentes a cada processo):


1) Parâmetros da Integração Sisdia x iCarros: CADA9020

Através deste processo será realizada, para cada filial da empresa, a manutenção nos parâmetros da integração do Sisdia com o site iCarros e/ou com a financeira Itaú

       →Dados da Integração: Deverão ser informados o identificador de integração ativada/desativada, o identificador de correlação na entrada dos veículos no estoque, o CNPJ da filial para integração e o Cliente Padrão para geração de leads.

       →Credenciais iCarros: Deverão ser informadas as credencias para realização da integração com o site iCarros, através dos processos de Importação das Correlações, Envio de Anúncios, Importação das Leads e Avaliação dos Veículos.

Além disso, deverá ser realizado o envio das credenciais, através da opção “Envia Credenciais”, para que a integração 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 de veículos, disponibilizadas pelo iCarros, 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ções referentes a veículos que foram disponibilizados pelo iCarros: Marcas, Modelos, Versões, Opcionais, Cores e Combustíveis.  

Neste caso, serão importadas somente as novas informações disponibilizadas ou então as informações já disponibilizadas anteriormente e ainda não correlacionadas (as informações disponibilizadas anteriormente e já correlacionadas não serão importadas).



Na opção de Correlação, serão correlacionados manualmente cada um dos tipos de informações referentes aos veículos que foram importados do iCarros: Marcas, Modelos, Versões, Opcionais, Cores e Combustíveis com as informações utilizadas no Sisdia. 

Através desta opção poderão ser cadastradas as correlações para as novas informações importadas do iCarros ou alteradas as correlações já cadastradas anteriormente.


Na correlação de Versões, serão correlacionadas cada uma das marcas/modelos/versões utilizadas pelo iCarros com os modelos utilizados no Sisdia, adotando a seguinte regra: Uma única marca/modelo/versão iCarros para um ou mais modelos Sisdia.





Na correlação de Opcionais, serão correlacionados cada um dos códigos de opcionais utilizados pelo iCarros com seus respectivos códigos de opcionais utilizados no Sisdia, adotando a seguinte regra: Um único opcional iCarros para um ou mais opcionais Sisdia.




Na correlação de Cores, serão correlacionadas cada uma das cores utilizadas pelo iCarros com suas respectivas cores utilizadas no Sisdia, adotando a seguinte regra: Uma única cor iCarros para uma ou mais cores Sisdia.



Na correlação de Combustíveis, serão correlacionados cada um dos tipos de combustíveis utilizados pelo iCarros com seus respectivos tipos de combustíveis utilizados no Sisdia, adotando a seguinte regra: Um único tipo de combustível iCarros para um ou mais tipos de combustíveis Sisdia. 


3) 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 do concessionário, permitindo a inclusão, a alteração ou a exclusão do anúncio destes veículos.

Para isso, deverão ser selecionados os veículos do estoque a serem anunciados, informando a ação a ser realizada no anuncio:

Incluir Anúncios: Inclusão de anúncios para veículos ainda não anunciados.

Alterar Anúncios: Alteração dos anúncios de veículos já anunciados.

Excluir Anúncios: Exclusão dos anúncios de veículos já anunciados.

Excluir Faturados: Exclusão dos anúncios de veículos faturados já anunciados.

Para seleção dos veículos a serem anunciados, deverão ser informados os seguintes campos de filtro:


Após a informação dos campos de filtro, os anúncios selecionados serão exibidos em uma tela de gerenciamento dos anúncios, para que sejam preparados para o envio:

Através da opção “Dados Veículos”, que será disponibilizada para as ações “Incluir Anúncios” e “Alterar Anúncios”, os anúncios serão preparados para envio, incluindo ou alterando os detalhes do veículo no anúncio. Todas as informações do veículo são obrigatórias, com exceção dos opcionais e das fotos.
Neste momento será verificado se existem planos de anúncios contratados para o tipo de veículo a ser anunciado (novo ou usado), e caso não exista, não será permitido a preparação do anúncio para envio.
Será verificado também se as correlações de marca, modelo, versão, cores, opcionais e combustíveis do veículo a ser anunciado estão cadastradas, e caso não estejam, será solicitado o seu cadastro.


Nesta opção Dados Veículos, através da sub-opção “Opcionais”, poderão ser incluídos ou alterados os opcionais do veículo no anúncio:


Nesta opção Dados Veículos, através da sub-opção “Fotos”, poderão ser 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 Dados Veículos, através da sub-opção “Envia”, poderá ser enviado individualmente o anúncio que estiver sendo preparado:



Nesta opção Dados Veículos, através da sub-opção “iCarros”, o anúncio enviado individualmente poderá ser acessado no site iCarros para conferência:


Ao sair da opção Dados Veículos, retornando para a tela de gerenciamento dos anúncios, todos os anúncios já preparados serão marcados automaticamente com “*” para serem enviados.  

Para desmarcar um determinado anúncio já preparado para que não seja enviado, ou marca-lo novamente para envio, basta teclar <Enter> ou acionar a opção “Aceitar”.


Através da opção “Todos”, que será disponibilizada para as ações “Excluir Anúncios” e “Excluir Faturados”, todos os anúncios selecionados serão marcados/desmarcados para serem enviados para exclusão.

No caso das ações “Excluir Anúncios” e “Excluir Faturados”, como não é feita a preparação dos anúncios, poderá ser teclado <Enter> ou acionada a opção “Aceitar” para marcar/desmarcar individualmente os anúncios a serem enviados para exclusão.


Através da opção “Envia”, que será disponibilizada para as ações “Incluir Anúncios”, “Alterar Anúncios”, “Excluir Anúncios” e “Excluir Faturados”, todos os anúncios marcados com “*” serão automaticamente enviados para inclusão, alteração ou exclusão:


Através da opção “iCarros”, que será disponibilizada para as ações “Alterar Anúncios”, “Excluir Anúncios” e “Excluir Faturados”, os anúncios já incluídos poderão ser acessados no site iCarros para conferência.



Importante:

O anúncio dos veículos do estoque do concessionário poderá ser feito também através da utilização de ferramentas próprias ou diretamente no site iCarros. 

Em ambos os casos serão utilizados os mesmos planos de anúncios que são utilizados pelo processo de Anúncios do Sisdia, abatendo normalmente a quantidade de anúncios já realizados da quantidade de anúncios contratados. 


Entretanto, no processo de Anúncios do Sisdia, somente poderão ser alterados ou excluídos os anúncios que forem enviados através deste processo, não sendo possível a alteração ou exclusão de anúncios feitos através de ferramentas próprias ou diretamente no site iCarros.


4) Importação das LEADS: VEIC9900

 Através deste processo serão realizadas a importação e a consulta dos leads disponibilizados pelo iCarros, permitindo a geração opcional das fichas de negócio para os leads consultados.

Serão disponibilizadas pelo iCarros e importadas para o Sisdia os leads gerados a partir dos anúncios dos veículos novos ou usados do estoque do concessionário, enviados através dos seguintes processos:

→Processo de Envio de Anúncios do Sisdia (VEIC3070);

→Ferramenta Externa de Envio de Anúncios;

→Diretamente no site iCarros.     

Para realizar a consulta dos leads disponibilizados pelo iCarros e já importadas para o Sisdia, deverão ser informados os seguintes campos de filtro:


Após a informação dos campos de filtro, os leads selecionados serão exibidos em uma tela de gerenciamento dos leads, para que sejam consultadas e geradas as fichas de negócio. 

Para cada lead selecionada, poderá ser informado o código do agente, a ser utilizado na geração das fichas de negócio. Somente serão geradas as fichas de negócio para os leads que possuem o código do agente informado:

Através da opção “Detalhes”, serão consultados os detalhes de cada lead:


Através da opção “Propostas”, serão consultados os detalhes da proposta gerada para os leads do tipo P-Proposta:


Através da opção “Financiamentos”, serão consultados os detalhes do financiamento simulado para os leads do tipo F-Financiamento:


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


Através da opção “Pré-Aprovado”, serão consultadas as informações da análise de crédito do cliente para cada lead.

Caso o cliente possua crédito pré-aprovado (campo PA igual a “S”), serão exibidos os detalhes da análise de crédito do cliente:

Caso o cliente não possua crédito pré-aprovado (campo PA igual a “ ”), será exibida uma mensagem solicitando que seja consultado o Itaú:

Através da opção “Importa Leads”, será realizada a importação manual dos leads disponibilizados pelo iCarros, onde poderá ser utilizado um período fixo de 90 dias ou especificada uma data inicial para importação.

Serão importados os leads disponibilizadas no período anterior a 90 dias em relação a data atual ou então os leads disponibilizados entre a data inicial especificada e a data atual. 

Os leads já importados anteriormente para este período, para as quais ainda não tenha sido gerada fichas de negócio, serão importadas novamente:


Através da opção “Controle Imp.”, 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 será definida a periodicidade da importação. 

Serão importados os leads disponibilizadas entre a data/hora da última importação e a data/hora atual:

5) Avaliação de Crédito dos Clientes: 

A avaliação de crédito dos clientes será realizada utilizando a integração com a financeira Itaú. Esta consulta será atualizada em tempo real, uma vez ao dia para cada cliente, por cada empresa solicitante. Para as demais consultas realizadas no mesmo dia, para o mesmo cliente, pela mesma empresa solicitante, será exibido o resultado da última consulta realizada. Será realizada através dos seguintes processos: 

5.1) Ficha de Negócios: VEIC0290

Na inclusão e/ou alteração das fichas de negócio dos clientes, caso a integração com o iCarros esteja ativa, será processada automaticamente a avaliação de crédito do cliente e disponibilizada a opção “Pré-Analisado” para consulta dos detalhes da avaliação de crédito:

           →Caso o cliente possua crédito pré-analisado:


           Serão exibidas a logomarca do Itaú e a mensagem informativa sobre a existência de credito pré-aprovado:

Ao ser acionada a opção “Pré-Analisado” será disponibilizada a tela com os detalhes da análise de crédito:


       →Caso o cliente não possua crédito pré-analisado
       Não serão exibidas a logomarca do Itaú e a mensagem informativa da existência de credito pré-aprovado:
Ao ser acionada a opção “Pré-Analisado” será disponibilizada uma mensagem solicitando que seja consultado o Itaú:


Importante:

Para a bandeira TOY-Toyota, na inclusão e/ou alteração das fichas de negócio do SVT, a avaliação de crédito dos clientes será solicitada automaticamente (via triggers) e consultada posteriormente através do processo de Consulta Avulsa Análise Crédito descrito logo abaixo no item 5.3.

Filtro

Opção habilitada quando o usuário está posicionado no campo “Ficha”. Este botão abrirá uma tela para a seleção de fichas, conforme tela abaixo. O sistema irá listar as fichas que satisfazem os critérios de busca informados pelo usuário. Ao selecionar uma ficha no grid, a mesma será aberta na tela principal.


Consulta Lead

O botão “Lead” fica disponível dentro do contexto de “input” dos campos da tela principal, para exibir os dados do Lead que originou a ficha. Esta tela irá mostrar os dados carregados no programa VEIC9900. Para que esta tela seja chamada através do botão “Lead”, o usuário deverá ter selecionado uma ficha de negócio gravada.



5.2) Reserva de Veículos: CLIV3000

Na inclusão das reservas de veículos, caso a integração com o iCarros esteja ativa, será processada automaticamente a avaliação de crédito do cliente e disponibilizada a opção “Pré-Aprovado” para consulta dos detalhes da avaliação de crédito:

        →Caso o cliente possua crédito pré-aprovado:

        Serão exibidas a logomarca do Itaú e a mensagem informativa sobre a existência de credito pré-aprovado:




Ao ser acionada a opção “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


        Não serão exibidas a logomarca do Itaú e a mensagem informativa da existência de credito pré-aprovado:

Ao ser acionada a opção “Pré-Aprovado” será disponibilizada uma mensagem solicitando que seja consultado o Itaú:

5.3) 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 CNPJ/CPF do cliente:

Caso seja informado o CPF 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.

Caso o usuário não informe um CNPJ/CPF, então o campo “Período Consulta” será acessado. Nele o usuário informará um período, o qual será usado para consultar os clientes que tiveram o crédito pré-aprovado pelo Itaú. A origem desta consulta é feita automaticamente (via robô) quando uma ficha é aberta/alterada no SVT (no caso de bandeira Toyota) ou quando uma ficha é aberta/alterada no VEIC0290 (no caso de bandeira diferente de Toyota).

Após a seleção dos clientes, estes dados são exibidos em um grid, abaixo do campo Período Consulta, composto pelos seguintes campos: Data Consulta, CNPJ/CPF, Nome Cliente, PA; sendo que a coluna PA mostra o logo do Itaú no título e "SIM" ou "   " no conteúdo. 

No contexto da navegação do grid, é disponibilizado o botão “Pré-Analisado”, para que seja aberta a tela de consulta do crédito pré-aprovado deste cliente.

        →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á disponibilizada uma mensagem solicitando que seja consultado o Itaú:

Importante:


Para a bandeira TOY-Toyota, na inclusão e/ou alteração das fichas de negócio do SVT, as avaliações de crédito dos clientes solicitadas automaticamente (via triggers) poderão ser consultadas por este processo.

6) 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: 

6.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 entrada dos veículos usados, a utilização do processo de avaliação será obrigatória.

Na inclusão ou alteração de uma ficha de avaliação, será verificado o parâmetro Correlação do CADA9020 e efetuados os seguintes tratamentos:

→Sim: Após a informação do campo Ano Modelo, será verificado se o modelo informado está correlacionado a uma Marca/Modelo/Versão do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será obrigatória. Da mesma forma, após a informação do campo Cor, será verificado se a cor informada está correlacionada a uma Cor do iCarros e se não estiver será aberta uma tela para correlação deste campo, sendo que sua a informação será obrigatória.

→Opcional: Após a informação do campo Modelo, será verificado se o modelo informado está correlacionado a uma Marca/Modelo/Versão do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será opcional. Da mesma forma, após a informação do campo Cor, será verificado se a cor informada está correlacionada a uma Cor do iCarros e se não estiver será aberta uma tela para correlação deste campo, sendo que sua a informação será opcional.

→Não: Após a informação dos campos Modelo e Cor, não será verificada a existência da correlação destes campos com o iCarros e não serão solicitadas a informação destas correlações por este processo. 

Na inclusão ou alteração de uma ficha de avaliação, será disponibilizada a opção “Preços iCarros”, através da qual será realizada a consulta dos preços mínimos, médios e máximos do veículo, a nível de Brasil e 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 estiver zerado). 

Ao ser acionada a opção “Preços iCarros”,  caso o modelo do veículo não estiver correlacionado e o parâmetro Correlação do CADA9020 for igual  a Sim ou Opcional,   será permitido o cadastramento da correlação para o modelo, porém esta correlação não será obrigatória. Caso não seja cadastrada, o preço somente poderá ser consultado após o seu cadastramento.

6.2) Cadastramento de Opcionais para Veículos Usados: VEIC0050

Através deste processo serão cadastrados os opcionais dos veículos usados referentes às avaliações que foram incluídas anteriormente. 

Na inclusão ou alteração de um opcional para o veículo, será verificado o parâmetro Correlação do CADA9020 e efetuados os seguintes tratamentos:

→Sim: Após a informação do Opcional, será verificado se está correlacionado a um Opcional do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será obrigatória. 

→Opcional: Após a informação do Opcional, será verificado se está correlacionado a um Opcional do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será opcional.

→Não: Após a informação do Opcional, não será verificada a existência da correlação com o iCarros e nem solicitada a informação desta correlação.


6.3) Cadastro do Veículo: VEIC0200

Através deste processo será efetuado o cadastramento dos veículos.
No caso da entrada de veículos novos, que não passam pelo processo de avaliação, será verificado o parâmetro Correlação do CADA9020 e efetuados os seguintes tratamentos:
→Sim: Após a informação do campo Modelo, será verificado se o modelo informado está correlacionado a uma Marca/Modelo/Versão do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será obrigatória. Da mesma forma, após a informação do campo Cor Externa, será verificado se a cor informada está correlacionada a uma Cor do iCarros e se não estiver será aberta uma tela para correlação deste campo, sendo que sua a informação será obrigatória.
→Opcional: Após a informação do campo Modelo, será verificado se o modelo informado está correlacionado a uma Marca/Modelo/Versão do iCarros e se não estiver será aberta uma tela para correlação destes campos, sendo que sua a informação será opcional. Da mesma forma, após a informação do campo Cor Externa, será verificado se a cor informada está correlacionada a uma Cor do iCarros e se não estiver será aberta uma tela para correlação deste campo, sendo que sua a informação será opcional.
→Não: Após a informação dos campos Modelo e Cor Externa, não será verificada a existência da correlação destes campos com o iCarros e não serão solicitadas a informação destas correlações 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.

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

3) 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).

4) 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.

5) Para testar se ficou OK, execute os seguintes comandos na pasta de execução do sisdia:
./comunicacao_itau.sh –v /
./tarefa_itau.sh -v
Esses comandos vão mostrar a versão do programa e em seguida vai tentar conectar ao banco de dados e ao webservice.
Exemplo:
./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).

2) A pasta padrão para a gravação das imagens é a “/sisdia/imagens”. Caso não tenha este diretório “/sisdia/imagens” deverá ser criado o diretório ou alterar o diretório padrão.

3) 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”.

4) Será necessário realizar as seguintes parametrizações no CADA9000:
- Criar os tipos de servidores IT1, IT2, IT3 e ISD para as filiais que utilizam o iCarros, onde:.
- IT1: Corresponde ao servidor. Ex: http://192.168.10.229
- IT2: Corresponde a porta do servidor. Ex: “8080”
- IT3: Corresponde ao contexto do servidor. Ex: “se-alfa”
- ISD: Corresponde a instância do servidor. Ex: “/ext/sisdia/dpralfa/”

5) O web.xml liberado, deverá conter uma configuração padrão, e o cliente terá que altera-la somente se sua instalação não for padrão. Segue a configuração padrão com os pontos que podem ser alterados marcados em vermelho:

→Os trechos abaixo indicam para o tomcat qual é a servlet que vai tratar as requisições do JSF, e qual é o padrão(no caso .xhtml):
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.xhtml</url-pattern>
</servlet-mapping>

→Os trechos abaixo indicam para o tomcat qual é a servlet que vai tratar as imagens, e qual é o padrão(no caso /sisdia/imagens/CHASSI/*). Tudo que tiver dentro dessa pasta será tratado pela minha servlet de tratamento de imagens:
<servlet>
<servlet-name>Image Servlet</servlet-name>
<servlet-class>br.com.linx.icarros.controle.ImageServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Image Servlet</servlet-name>
<url-pattern>/sisdia/imagens/CHASSI/*</url-pattern>
</servlet-mapping>

→O trecho abaixo indica qual tema será usado:
<context-param>
<param-name>primefaces.THEME</param-name>
<param-value>aristo</param-value>
</context-param>

→Os trechos abaixo indicam qual classe vai tratar o upload de imagens:
<filter>
<filter-name>PrimeFaces FileUpload Filter</filter-name>
<filter-class>org.primefaces.webapp.filter.FileUploadFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>PrimeFaces FileUpload Filter</filter-name>
<servlet-name>Faces Servlet</servlet-name>
</filter-mapping>


→O trecho abaixo indica o nome do pool de conexões do tomcat que será usado pela aplicação. Tem que ter um pool configurado com esse nome dentro do conf/context.xml do tomcat. Não precisa colocar jdbc:
<context-param>
<param-name>BANCO_DADOS</param-name>
<param-value>sisdia</param-value>
</context-param>

→O trecho abaixo indica onde o programa vai buscar as imagens. Deve seguir o mesmo padrão do início do caminho configurado acima para a servlet de imagens:
<context-param>
<param-name>DIR_IMAGENS</param-name>
<param-value>/sisdia/imagens</param-value>
</context-param>


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.

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

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

4) Execute no prompt do Linux o comando crontab –e

5) 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 dos leads: 

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

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

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

4) Execute no prompt do Linux o comando crontab –e

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


Serviços

A – Chamada dos serviços: 

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;

80 = Envia Vendas: Envia as vendas financiadas de veículos;

81 = Envia Cancelamento Vendas: Envia o cancelamento das vendas financiadas;  


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

 →Anúncios:  cxanuita        cxopcanu         cxfotita 

 →Leads:  cxcomlea       cxleadan      cxleadcp      cxleaddt    cxleadfi

 →Avaliações Crédito:  cxcreita         cxsvtita

 →Vendas:  cxvenita

 →Entrada Veículos:  cxavaita


B – Tabelas Intermediárias: 

 →Parâmetros: iintegracoes    itarefas     

 →Correlações: imarcas         imodelos             iversoes             icores   

                        iacessorios   icombustiveis    itransmissoes    icidades

 →Anúncios:  ianuncios      iplanos 

 →Leads: ileads     ileads_anuncio      ileads_financiamento      ileads_telefone   

 →Avaliações Crédito:  ianalisis       iresultado_analise         ioperacoes  

 →Vendas:  ivendas

 →Entrada Veículos:  iprecos    iprecos_uf


  • Sem rótulos