Integração XML com outros sites ou softwares imobiliários


O anúncio de imóveis no Imofox é feita automaticamente por meio de integração do Imofox com sistemas de software para imobiliárias e corretores de imóveis ou ainda portais imobiliários. Essa integração ocorrerá através da utilização do formato XML para transferência dos dados dos anúncios de imóveis e das imobiliárias para o Imofox. Para solicitar a integração, proceda para o formulário de contato.


Como funciona?


Após a integração entre sistemas imobiliários e o Imofox, o Imofox realizará diariamente o download de um arquivo (feed) XML por HTTP ou FTP, fornecido pela empresa administradora do sistema imobiliário. Neste arquivo ou feed, encontram-se todos os imóveis a serem anunciados. Imóveis que forem vendidos ou alugados devem ser removidos deste arquivo para que, desta maneira, o Imofox atualize seu banco de dados.
A seguir, apresentamos o formato do arquivo XML utilizado para tal fim, juntamente com explicações de algumas tags.


Exemplo de feed XML


Um exemplo de arquivo XML pode ser encontrado aqui e aqui para download.


Validar o feed XML


Valide o feed XML para que siga o formato exigido: Validar feed


Explicações sobre algumas tags do feed XML


  • as tags <codigoimovel>, <referencia> e <urlimovel> devem ser únicas (sem repetição) para os imóveis de um mesmo anunciante. <referencia> é o código de referência do imóvel inserida pelo anunciante. <codigoimovel> é um código interno único referente ao imóvel. Precisa-se de pelo menos <referencia> ou <codigoimovel>.
  • a tag <matricula>, é o número da matrícula do imóvel no Registro de Imóveis, caso a transação seja de venda. Essa informação é obrigatória para imóveis à venda.
  • <titulo> deve ter no máximo 80 caracteres. Se a tag <titulo> não existir, o título do anúncio será criado automaticamente (recomendado).
  • <tipoimovel>: (os tipos entre parênteses devem ser preferencialmente mapeados para seus equivalentes (exemplo: "chácara" deve ser escrito como "rural")
    apartamento | casa | casa condomínio | cobertura | flat (apart hotel) | kitchenette (loft) | sobrado | rural (sítio/chácara/fazenda) | galpão (armazém/depósito) | loja | comercial (escritório/conj. comercial/prédio comercial) | terreno (lote/loteamento) | hotel (pousada).
    Veja mais informações aqui.
  • <tipoimovellivre>: deve ser o tipo de imóvel original de seu software imobiliário. Será utilizado como categoria adicional se esta for diferente de <tipoimovel>
  • <finalidade> deve ser somente um dos seguintes termos: venda, aluguel, ou temporada.
  • <preco> deve ser um número sem vígulas e pontos (somente caracteres númericos). Exemplo: 50000 (para 50 mil reais). Se o preço não estiver indicado (somente sob consulta), deve-se ter "consultar".
  • a tag <anunciante><codigoanunciante> será necessária se houver vários anunciantes de um mesmo sistema/software imobiliário.
  • <anunciante><nomefantasia>: nome da imobiliária ou do corretor de imóveis. Será utilizado como nome de usuário e nome da empresa no perfil no Imofox. 
  • <anunciante><email>: o e-mail de contato será usado para identificar o anunciante.
  • imóveis do tipo residencial devem ter necessariamente pelo menos 1 dormitório
  • imóveis do tipo rural e terreno devem listar necessariamente a área dos mesmos, e esta deve ser em m2 (metros quadrados).
  • <anunciante><tipoanunciante>: deve ser somente um dos seguintes termos (sem acento): imobiliaria, corretor, ou construtora
  • dormitórios, banheiros, etc. devem ser do tipo número (####)
  • <bairro> deve ser o nome de um bairro e conter no máximo 40 caracteres
  • Dentro de <fotos>, pode existir todas as fotos do imóvel (pelo menos 3 fotos). <numero_total_fotos> indica o número total de fotos no anúncio original caso o XML não conter todas as fotos do imóvel (serve para redirecionar o usuário para a página com mais fotos, se for o caso).
  • os campos (tags) em negrito listados abaixo (em Formato do Arquivo XML) são obrigatórios

Formato do Arquivo XML:


<?xml version="1.0" encoding="utf-8" ?>
<imofox version="2.0">
<imoveis>
 <imovel>

   <codigoimovel></codigoimovel>
   <referencia></referencia>
   <matricula></matricula>
   <urlimovel></urlimovel>

   <finalidade>venda | aluguel | temporada</finalidade>
   <tipoimovel>apartamento | casa | casa condomínio | cobertura | flat | kitchenette | sobrado | rural | galpão | loja | comercial | terreno | hotel </tipoimovel>

   <tipoimovellivre></tipoimovellivre>

   <lancamento>sim | nao</lancamento>


   <titulo></titulo>
   <descricao></descricao>
   <dormitorios>###</dormitorios>  
   <banheiros>###</banheiros>
   <suites>###</suites>
   <vagas>###</vagas>
   <area>###</area>
   <area_util>###</area_util>

   <endereco></endereco>
   <cidade></cidade>
   <bairro></bairro>
   <estado></estado>

   <cep></cep>

   <latitude>##.######</latitude>  
   <longitude>##.######</longitude>  

   <preco>######## | consultar</preco>  

   <fotos>
     <foto>
       <foto_url></foto_url>
     </foto>
    
     <foto>
       <foto_url></foto_url>
     </foto>
    
     <foto>
       <foto_url></foto_url>
     </foto>
   </fotos>
   <numero_total_fotos> ## <numero_total_fotos>

   <anunciante> 
     <codigoanunciante></codigoanunciante>
     <tipoanunciante> imobiliaria | corretor | construtora </tipoanunciante>    
     <nomefantasia></nomefantasia>
     <endereco></endereco>
     <bairro></bairro>
     <cidade></cidade>
     <estado></estado>

     <telefone></telefone>
     <email></email>
     <urlsite></urlsite>
     <urllogo></urllogo>    
   </anunciante>


 </imovel>

 <imovel>
  ...

 </imovel>


</imoveis>
</imofox>

 

Exemplo de Mapeamento para <tipoimovel>

<tipoimovelllivre>
<tipoimovel>
apartamento
apartamento
casa
casa
casa em condomínio
casa condominio
cobertura
cobertura
apart hotel, flat
flat
kitchenette, loft
kitchenette
sobrado
sobrado
imóveis rurais, sítio/chácara/fazenda
rural
galpão, armazém, depósito
galpão
loja
loja
escritório/conj. comercial/prédio comercial, outros imóveis comerciais
comercial
terreno/lote/loteamento
terreno
hotel/pousada e similares
hotel
O que é a matrícula do imóvel?

A matrícula é o documento que identifica o imóvel. Cada matrícula possui um número e pode ser composta por várias folhas. Além de dados sobre a localização e metragem, informa a origem do imóvel e todos os fatos relevantes na história do imóvel, como: compras e vendas, hipotecas, penhoras, empréstimos, transmissões a herdeiros, arrematações, adjudicações etc.

Clique aqui e promova seus anúncios no Imofox