Especificações
Formato do Arquivo XML
Após a integração entre sistemas imobiliários e o PORTAL DE IMÓVEIS EM BRAGANÇA PAULISTA, o nosso sistema 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 Portal 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.
- <tipoimovel>:
apartamento | casa | casa condomínio | cobertura | flat | kitchenette | loft | sobrado | sítio | chácara | fazenda | galpão | loja | comercial | terreno | terreno em condomínio
- <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 ou aluguel.
- <preco> deve ser um número sem vígulas e pontos (somente caracteres númericos). Exemplo: 50000 (para 50 mil reais).
- <data> data de cadastro do anúncio. Exemplo: 2010-12-01 17:03:00
- <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 Portal de Imóveis em Braganca Paulista.
- <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 Portal de Imóveis em Braganca Paulista.
- 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" ?>
<informa>
<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>########</preco>
<data>AAAA-MM-DD HH:MM:SS</data>
<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>
</informa>