Documentação Técnica: Integração dos Imóveis no Website

Voltar

Informações gerais

O Vista.Imobi utiliza banco de dados MySQL. Este banco de dados fica hospedado em um provedor de internet. Desta forma, a integração do Vista.Imobi (banco de dados MySQL) e o Website pode ser desenvolvida por completo. Os arquivos das fotos dos imóveis ficam em uma pasta no FTP da hospedagem, disponíveis para serem exibidas.

Estrutura do banco de dados

A estrutura para a integração do Website na parte dos imóveis (imóveis em destaque, buscas, detalhes) é composta pelas seguintes tabelas:
   
CADIMO: Esta tabela representa o cadastro dos imóveis.
   
  Estrutura:
  CODIGO: Código sequencial numérico gerado pelo Vista.Imobi;
CODIGO_CS: Código da Agência do imóvel;
CODIGO_CT: Código do Tipo do imóvel;
CODIGO_M: Código da Moeda do imóvel;
PLACA: Codigo digitado pela imobiliária;
STATUS: Texto indentificando o Status do Imóvel. Exemplo: 'Ativo', 'Suspenso', 'Vendido';
VER_WEB: Campo de checagem para determinar se o Imovel deve ser exibido no site;
DETAQUE_WEB: Campo de checagem para determinar se o Imovel deve ser exibido em destaque;
GMAPS_LAT: Campo que contém a latitude da posição do imóvel no Google Maps;
GMAPS_LNG: Campo que contém a longitude da posição do imóvel no Google Maps;
ENDERECO
BAIRRO
CIDADE
DORMITORIO
VLR_VENDA
...

A tabela CADIMO é composta ainda por indeterminados outros campos, sendo possível criar novos campos. Desta forma deve-se verificar com a imobiliária quais campos devem ser utilizados.

CODIGO ou PLACA: Deve-se verificar com a imobiliária qual campo de Codigo, tanto para Exibição como para busca, deve ser utilizado. O CODIGO é gerado automaticamente pelo Vista.Imobi, e o campo PLACA (chamado de Referencia) é digitado pelo usuário.

STATUS e VER_WEB: Para o imóvel ser exibido no site deve ter o campo VER_WEB preenchido com "Sim". E o campo STATUS também deve ser validado, verificando com a imobiliária quais conteúdos representam imóveis Ativos (que devem aparecer no site).


Exemplo de consulta de todos os imóveis Ativos que devem aparecer no site:

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO
FROM CADIMO
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO'


Exemplo de consulta dos imóveis em Destaque:

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO
FROM CADIMO
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO' AND CADIMO.DESTAQUE_WEB='Sim'

   
CADCAT: Esta tabela representa o cadastro dos Tipos de imóveis.
   
  Estrutura:
  CODIGO: Codigo do Tipo de imóvel;
CATEGORIA: Tipo de imóvel; Exemplo: 'Apartamento', 'Casa';

Relacionamento com a tabela CADIMO:
CADCAT.CODIGO = CADIMO.CODIGO_CT

Exemplo de consulta de todos os imóveis Ativos que devem aparecer no site com o Tipo de imóvel:

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO, CADCAT.CATEGORIA
FROM CADIMO
LEFT JOIN CADCAT ON CADCAT.CODIGO = CADIMO.CODIGO_CT
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO'


Exemplo de consulta de todos os imóveis Ativos do Tipo 'Casa':

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO, CADCAT.CATEGORIA
FROM CADIMO
LEFT JOIN CADCAT ON CADCAT.CODIGO = CADIMO.CODIGO_CT
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO' AND CADCAT.CATEGORIA='Casa'

   
CATMON: Esta tabela representa o cadastro dos Tipos de moedas.
   
  Estrutura:
  CODIGO: Codigo da Moeda de imóvel;
CATEGORIA: Nome da Moeda. Exempos: 'Reais', 'Dolares', 'CUB';
SIMBOLO: Simbolo da Moeda. Exemplos: 'R$', 'U$', 'CUB';
INDICE: Índice da Moeda. Este campo deve ser multiplicado pelo campo CADIMO.VLR_VENDA que resultará no preço do imóvel.

Relacionamento com a tabela CADIMO:
CATMON.CODIGO = CADIMO.CODIGO_M


Exemplo de consulta de todos os imóveis Ativos com o preço do imóvel:

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO, CADCAT.CATEGORIA, CATMON.INDICE*CADIMO.VLR_VENDA AS PRECO
FROM CADIMO
LEFT JOIN CADCAT ON CADCAT.CODIGO = CADIMO.CODIGO_CT
LEFT JOIN CATMON ON CATMON.CODIGO = CADIMO.CODIGO_M
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO'

   
CMPN1: Esta tabela representa o cadastro das Agências da imobiliária.
   
  Estrutura:
  CODIGO: Código da Agencia;
CODIGO_EM: Código da Imobiliária;
NOME: Nome da Agencia;
ENDERECO
BAIRRO
CIDADE
FONE
EMAIL

Relacionamento com a tabela CADIMO:
CMPN1.CODIGO = CADIMO.CODIGO_CS


Exemplo de consulta de todos os imóveis Ativos com o nome e Telefone da Agência:

SELECT CADIMO.CODIGO, CADIMO.BAIRRO, CADIMO.DORMITORIO, CADCAT.CATEGORIA, CATMON.INDICE*CADIMO.VLR_VENDA AS PRECO, CMPN1.NOME, CMPN1.FONE
FROM CADIMO
LEFT JOIN CADCAT ON CADCAT.CODIGO = CADIMO.CODIGO_CT
LEFT JOIN CATMON ON CATMON.CODIGO = CADIMO.CODIGO_M
LEFT JOIN CMPN1 ON CMPN1.CODIGO = CADIMO.CODIGO_CS
WHERE CADIMO.VER_WEB='Sim' AND CADIMO.STATUS='ATIVO'

   
CMPN: Esta tabela representa o cadastro da(s) Imobiliária(s). Esta tabela terá mais registros em caso de versão Multi-empresa, quando mais de uma Imobiliária utiliza o mesmo banco de dados.
   
  Estrutura:
  CODIGO_EM: Código da Imobiliária;
IMOBILIARIA: Nome da Imobiliária;

Relacionamento com a tabela CMPN1:
CMPN.CODIGO_EM = CMPN1.CODIGO_EM
   
CDIMIM: Esta tabela representa o cadastro das Fotos dos imóveis (nomes dos arquivos).
   
  Estrutura:
  CODIGO: Codigo do imóvel;
CODIGO_I: Codigo sequencial da imagem;
DESCRICAO: Descricao da foto. Exemplos: 'Fachada', 'Vista';
DESTAQUE_WEB: campo de checagem quer determina qual foto é a principal do imóvel;
VER_WEB: Campo de checagem que determina se a foto deve ser exibida no site;
FILE_PATH: nome do arquivo da Foto;
FILE_PATH_P: nome do arquivo da Foto de tamanho pequena (thumbnail)

Relacionamento com a tabela CADIMO:
CDIMIM.CODIGO = CADIMO.CODIGO


Exemplo de consulta de todas as Fotos do Imovel de codigo '100' que deve ser exibidas no site:

SELECT CDIMIM.DESCRICAO, CDIMIM.FILE_PATH, CDIMIM.FILE_PATH_P
FROM CDIMIM
WHERE CDIMIM.VER_WEB='Sim' AND CDIMIM.CODIGO=100


Ordenamento das fotos

As fotos devem ser ordenadas da seguinte forma;
1. DESTAQUE_WEB: em ordem Descendente. Primeiro com conteúdo 'Sim', depois 'Nao';
2. DESCRICAO: Exemplos: '01 Fachada', '02 Vista', '03 Cozinha';
3. CODIGO_I: ordem de inserção das fotos


Exemplo de consulta de todas as fotos do Imovel de codigo '100' que deve ser exibidas no site na ordem correta:

SELECT CDIMIM.DESCRICAO, CDIMIM.FILE_PATH, CDIMIM.FILE_PATH_P
FROM CDIMIM
WHERE CDIMIM.VER_WEB='Sim' AND CDIMIM.CODIGO=100
ORDER BY CDIMIM.DESTAQUE_WEB DESC, CDIMIM.DESCRICAO, CDIMIM.CODIGO_I

Os campos FILE_PATH e FILE_PATH_P contem os nomes dos arquivos das fotos que ficam na pasta:
vista.imobi/fotos
   
CDIMVD: Esta tabela representa o cadastro dos vídeos dos imóveis (nomes dos arquivos).
   
  A Estrutura e a funcionalidade é igual à tabela CDIMIM acima.

Os campos FILE_PATH e FILE_PATH_P contem os nomes dos arquivos dos vídeos que ficam na pasta:
vista.imobi/videos
   
CADEMP: Esta tabela representa o cadastro dos Corretores, Agenciadores e Usuários do sistema.
   
  Estrutura:
  CODIGO_D: Código do usuário;
CODIGO_CS: Código da Agência do Usuário;
CODIGO_EQU: Código da Equipe do Usuário;
AGENCIADOR: Campo de checagem que determina se o Usuário é Agenciador de Imóveis;
CORRETOR: Campo de checagem que determina se o Usuário é Corretor e atende Clientes;
GERENTE: Campo de checagem que determina se o Usuário é Gerente de Equipe;
USUARIO: Campo de checagem que determina se o Usuário é Administrativo;
INATIVO: Campo de checagem que determina se o Usuário está Inativo;
EMAIL
FONE
CELULAR
...

Exemplo de consulta de todos Corretores Ativos:

SELECT CADEMP.CODIGO_D, CADEMP.NOME
FROM CADEMP
WHERE CADEMP.INATIVO='Nao' AND CADEMP.CORRETOR='Sim'


Exemplo de consulta de todos Corretores Ativos com o Nome e Telefone da Agência:

SELECT CADEMP.CODIGO_D, CADEMP.NOME, CMPN1.NOME AS AGENCIA, CMPN1.FONE AS AGENCIA_FONE
FROM CADEMP
LEFT JOIN CMPN1 ON CMPN1.CODIGO = CADEMP.CODIGO_CS
WHERE CADEMP.INATIVO='Nao' AND CADEMP.CORRETOR='Sim'
   
CADEQU: Esta tabela representa o cadastro das Equipes dos Corretores.
   
  Estrutura:
  CODIGO: Código da Equipe;
CODIGO_D: Código do Gerente da Equipe;
NOME: Nome da Equipe;


Exemplo de consulta de todos Corretores Ativos com o Nome da Equipe:

SELECT CADEMP.CODIGO_D, CADEMP.NOME, CADEQU.NOME AS EQUIPE
FROM CADEMP
LEFT JOIN CADEQU ON CADEQU.CODIGO = CADEMP.CODIGO_EQU
WHERE CADEMP.INATIVO='Nao' AND CADEMP.CORRETOR='Sim'


Exemplo de consulta de todos Corretores Ativos com o Nome da Equipe e o Nome do Gerente:

SELECT CADEMP.CODIGO_D, CADEMP.NOME, CADEQU.NOME AS EQUIPE, CADEMP2.NOME AS GERENTE
FROM CADEMP
LEFT JOIN CADEQU ON CADEQU.CODIGO = CADEMP.CODIGO_EQU
LEFT JOIN CADEMP CADEMP2 ON CADEMP2.CODIGO_D = CADEQU.CODIGO_D
WHERE CADEMP.INATIVO='Nao' AND CADEMP.CORRETOR='Sim'
   
CDIMAG: Esta tabela representa o relacionamento dos Agenciadores dos Imóveis.
   
  Estrutura:
  NUMERO: Código sequencial do agenciamento;
CODIGO_O: Código do imóvel;
CODIGO_D: Código do Agenciador;

Relacionamento com a tabela CADIMO:
CDIMAG.CODIGO_O = CADIMO.CODIGO

Relacionamento com a tabela CADEMP:
CDIMAG.CODIGO_D = CADEMP.CODIGO_D

Exemplo de consulta dos Agenciadores do Imovel de codigo '100':

SELECT CADEMP.CODIGO_D, CADEMP.NOME, CADEMP.EMAIL
FROM CDIMAG
LEFT JOIN CADEMP ON CADEMP.CODIGO_D = CDIMAG.CODIGO_D
WHERE CDIMAG.CODIGO_O = 100
ORDER BY CADEMP.NOME


   
CNFGSYS: Esta tabela contém campos de configurações do Sistema.
   
  Estrutura: aqui são listados alguns campos onde podem ser encontradas informações necessários para a integração.
  CODIGO_EM: Código da Empresa;
DIR_FOTOS: Pasta pública onde são hospedados os arquivos da Fotos dos imóveis;
DIR_VIDEOS: Pasta pública onde são hospedados os arquivos dos Vídeos dos imóveis;
DOWNLOAD_URL: URL do domínio onde os arquivos das Fotos e Vídeos ficam hospedados;
IMOVEIS_ATIVOS1_FIELD: Campo na tabela CADIMO que representa imóveis Ativos para Locação;
IMOVEIS_ATIVOS2_FIELD: Campo na tabela CADIMO que representa imóveis Ativos para Temporada;
IMOVEIS_ATIVOS3_FIELD: Campo na tabela CADIMO que representa imóveis Ativos para Venda;
IMOVEIS_ATIVOS1_VALUES: Conteúdos do campo IMOVEIS_ATIVOS1_FIELD que representam imóveis Ativos para Locação;
IMOVEIS_ATIVOS2_VALUES: Conteúdos do campo IMOVEIS_ATIVOS2_FIELD que representam imóveis Ativos para Temporada;
IMOVEIS_ATIVOS3_VALUES: Conteúdos do campo IMOVEIS_ATIVOS3_FIELD que representam imóveis Ativos para Venda;

Relacionamento com a tabela CMPN:
CNFGSYS.CODIGO_EM = CMPN.CODIGO_EM
   

Integração do Google Maps

Quando os campos GMAPS_LAT e GMAPS_LNG da tabela CADIMO estiverem preenchidos, significa que o imóvel foi posicionado no mapa no Vista.Imobi. São esses dois campos que devem ser utilizados para o posicionamento no Google Maps.

Para mais informações sobre o Google Maps acesse http://code.google.com/intl/pt-BR/apis/maps/documentation.
 

Demonstração da integração

Disponibilizamos um Website para download. Acesse www.vistasoft.com.br/demo e veja o funcionamento de uma integração.
 

Dúvidas ou Sugestões

Em caso de dúvidas ou para sugestões de melhorias entre em contato com o suporte através da página de Fale conosco.

Com mais de 13.000 usuários a Vista atua nas maiores imobiliárias do Brasil.
Quer saber mais ou acompanhar as novidades? Junte-se a nós em nossas comunidades!