Formato do Arquivo XML - ImoX
Após a integração entre sistemas imobiliários e o Imohoo, o Imohoo 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 Imohoo atualize seu banco de dados.
A seguir, apresentamos o formato do arquivo XML utilizado para tal fim, juntamente com explicações de algumas tags.
Um exemplo de arquivo XML pode ser encontrado aqui para download.
Explicações sobre algumas tags:
- as tags <codigoreferencia> e <urlimovel> devem ser únicas (sem repetição).
- <titulo> deve ter no máximo 80 caracteres. S e 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 | 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)
- <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".
- <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 Imohoo.
- <anunciante><email>: o e-mail de contato será usado para identificar o anunciante. Caso o e-mail seja alterado, o novo e-mail deve aparecer em <anunciante><novoemail> para a atualização da conta no Imohoo.
- 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 (####)
- 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" ?>
<imohoo>
<language> Portuguese </language>
<imoveis>
<imovel>
<codigoreferencia></codigoreferencia>
<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>
<statusimovel>vendido | alugado </statusimovel>
<titulo></titulo>
<descricao></descricao>
<dormitorios>###</dormitorios>
<banheiros>###</banheiros>
<suites>###</suites>
<vagas>###</vagas>
<area>###</area>
<endereco></endereco>
<cidade></cidade>
<bairro></bairro>
<estado></estado>
<cep></cep>
<pais>Brasil</pais>
<latitude>##,######</latitude>
<longitude>##,######</longitude>
<preco>######## | consultar</preco>
<fotos>
<foto>
<foto_url></foto_url>
<foto_descricao></foto_descricao>
</foto>
<foto>
<foto_url></foto_url>
<foto_descricao></foto_descricao>
</foto>
</fotos>
<anunciante>
<tipoanunciante> imobiliaria | corretor | construtora </tipoanunciante>
<nomefantasia></nomefantasia>
<endereco></endereco>
<bairro></bairro>
<cidade></cidade>
<estado></estado>
<telefone></telefone>
<email></email>
<novoemail></novoemail>
<urlsite></urlsite>
<urllogo></urllogo>
</anunciante>
</imovel>
<imovel>
...
</imovel>
</imoveis>
</imohoo>
