Feeds Casafy

É possível publicar no Casafy imediatamente, se utilizar alguns dos sistemas a seguir:


Se não utiliza um dos sistemas acima, poderá publicar seus imóveis no Casafy facilmente.

Só é preciso que nos especifique o endereço da web de um feed XML com imóveis oferecidos que atenda aos requisitos de formato que constam neste documento.

Qualquer dúvida ou consulta, envie um email para feeds@casafy.com.br. As fichas dos imóveis mais completas, terão melhor ranking em nosso sistema!

Formato do Arquivo XML

  • O documento XML deve ser bem formado. Você pode usar o Serviço de Validação W3C para verificar.
  • O arquivo deve ser escrito em UTF-8.
  • O elemento raiz do documento é nomeado <ads> e cada anúncio é um elemento <ad>.
  • O documento XML deve ser validado com o nosso esquema XML. Você pode baixar o arquivo esquema aqui. Há muitas aplicações para validação de XML. Se você usa Linux, pode usar xmllint ou xmlstarlet. No Windows, você pode usar XML Notepad que possui uma utilidade de validação.

Campos obrigatórios

id
Seu código interno para este anúncio (ele deve ser único, á que usaremos este campo para rastrear duplicidades).
url
URL do anúncio atual
title
Título do anúncio/dd>
content
Descrição do imóvel (mínimo de 30 caracteres).
type
O tipo deve ser um dos seguintes (enviar sempre em inglês):
  • for rent
  • for sale
  • country house rentals
  • for rent local
  • for sale local
  • land for sale
  • office for rent
  • office for sale
  • overseas
  • parking for rent
  • parking for sale
  • roommate
  • short term rentals
  • transfer local
  • unlisted foreclosure
  • warehouse for rent
  • warehouse for sale
property_type
O tipo de imóvel deve ser um dos seguintes:
  • apartment
  • building
  • country
  • country house
  • farm
  • garage
  • hangar
  • hotel
  • house
  • lot
  • office
  • other
  • ph
  • share apartment
  • store
  • timeshare
address
Nome da rua e número (ou cruzamento, ou número aproximado do endereço).
country
Nome do país onde o anúncio está localizado.
region
Nome do Estado em que o anúncio está localizado.
agency

Informação sobre a imobiliária anunciante. Deve conter os seguintes elementos:

Obrigatório
id
Código interno da imobiliária. Deve ser um número ou sequência de caracteres únicos. Este código nunca deve mudar para uma imobiliária específica, caso contrário, os dados eu coletamos ao longo do tempo para esta imobiliária serão perdidos.
name
Nome da imobiliária.
phone
Número do Telefone
email
Endereço de e-mail para onde os contatos serão enviados.
Opcionais
address
Endereço do imóvel
city_area
Zona / Bairro
city
Cidade
region
Estado
country
País
logo_url
URL do logo da imobiliária

Campos opcionais

price
Preço do item. Use sempre números inteiros (sem decimais ou separadores de milhares). Não inclua símbolos, tais como $ ou €. Se o preço estiver especificado em uma moeda diferente da moeda local, por favor inclua no atributo currency usando ISO-4217. Você pode incluir o atributo período period também, com os seguintes valores possíveis: daily, weekly, monthly, yearly).
agent

Informação sobre o corretor/vendedor. Deve conter os seguintes elementos:

Obrigatório
email
Endereço de e-mail para onde os contatos devem ser enviados.
Opcionais
name
Nome do Corretor
phone
Núumero do telefone
photo_url
URL da foto do corretor
pictures

Este elemento inclui as diversas fotos do imóvel. dentro deste elemento, deve haver um elemento picture com os seguintes campos:

Obrigatório
picture_url
URL da foto
Opcionais
picture_title
Título da foto

Você poderá especificar se uma foto será a principal, com o atributo featured. Ela deve conter um valor boleano (true, false, 0 or 1). Somente a primeira foto com o atributo será selecionada como foto principal. Se nenhuma das fotos tiver o atributo, a primeira foto será selecionada. Escolha uma foto adequada, uma vez que isso influencia grandemente onde o usuário clicará.

XML modelo
<pictures>
  <picture featured="true">
    <picture_url><![CDATA[http://www.foo.com/123.jpg]]></picture_url>
    <picture_title><![CDATA[Front view of the X]]></picture_title>
  </picture>
  <picture>
    <picture_url><![CDATA[http://www.foo.com/124.jpg]]></picture_url>
    <picture_title><![CDATA[Rear view of the X]]></picture_title>
  </picture>
</pictures>
date
Use o formato YYYY-MM-DD format (YYYY indica o ano, MM mês e DD dia).
city_area
Nome do bairro ou zona em que o imóvel está localizado.
city
Nome da cidade onde o anúncio está localizado.
postcode
Código Postal - CEP.
floor_number
Número do andar/ pisos (números inteiros).
latitude
Latitude do imóvel (decimal, entre -90.0 e 90.0).
longitude
Longitude do imóvel (decimal, entre -180.0 e 180.0).
orientation
Orientação do imóvel (norte, sul, leste ou oeste).
floor_area
Área útil, em metros quadrados (números inteiros).
floor_area_open
Área descoberta do imóvel, em metros quadrados (números inteiros).
plot_area
Área total do terreno onde o imóvel está localizado, em metros quadrados (números inteiros). Você pode especificar diferentes unidades (“metros”, “pés”, “acres”) com o atributo unit.
rooms
Número de cômodos (números inteiros).
bedrooms
Número de quartos (números inteiros).
bathrooms
Número de banheiros (números inteiros).
condition
Condição do imóvel (Exemplo: “reformado” ou “apartamento de segunda mão”).
year
Ano de construção do imóvel, no formato AAAA.
blueprint_url
URL da planta do imóvel.
is_furnished
Se o imóvel é mobiliado ou não (formato boleano).
is_new
Se o imóvel é novo ou não (formato boleano).
parking
Se o imóvel possui garagem ou não (formato boleano).
patio
Se o imóvel possui pátio ou não (formato boleano).
terrace
Se o imóvel possui terraço ou não (formato boleano).
balcony
Se o imóvel possui varanda/sacada ou não (formato boleano).
expiration_date
Data de vencimento do anúncio. O formato válido é YYYY-MM-DD (igual <date>).
chat_url
URL de um chat com um vendedor para este anúncio. Os valores Se __NAME__, __EMAIL__, __PHONE__ serão substituídos pelo nome, email e telefone do comprador.
Por exemplo:
http://example.com/chat/ad123?full_name=__NAME__&email=__EMAIL__&phone_number=__PHONE__
se converterá em
http://example.com/chat/ad123?full_name=Juan+Perez&email=juanito@gmail.com&phone_number=5555-5555
group_id
Group id for this ad. Ads with the same group_id will be grouped. This value is opaque. (String)
features

Este elemento inclui uma lista de características do imóvel. Contém um ou mais sequência de caracteres <feature>. O elemento pode ter um atributo label para definir características de valor chave, nde a legenda é a chave o o valor da tag <feature> é o valor.

Exemplo 1
<features>
  <feature><![CDATA[Kitchen]]></feature>
  <feature><![CDATA[Living]]></feature>
  <feature><![CDATA[Dining]]></feature>
</features>
Exemplo 2
<features>
  <feature label="Kitchen"><![CDATA[yes]]></feature>
  <feature label="Status"><![CDATA[good]]></feature>
</features>

Exemplo de feed

<?xml version="1.0" encoding="utf-8"?>
<ads>
  <ad>
    <id><![CDATA[11aa]]></id>
    <url><![CDATA[http://www.foo.com/realestate/?id=11aa]]></url>
    <title><![CDATA[Beautiful apartment, near the sky!]]></title>
    <content><![CDATA[lorem ipsum tower. this must be at least 30 chars long.]]></content>
    <type><![CDATA[for sale]]></type>
    <property_type><![CDATA[apartment]]></property_type>
    <address><![CDATA[Pepito St 3211]]></address>
    <region><![CDATA[Buenos Aires]]></region>
    <agency>
      <id><![CDATA[1]]></id>
      <name><![CDATA[Inmo 123]]></name>
      <phone><![CDATA[011-444-4444]]></phone>
      <email><![CDATA[info@inmo123.com.ar]]></email>
      <address><![CDATA[Malabia 123]]></address>
      <city_area><![CDATA[Palermo]]></city_area>
      <city><![CDATA[Ciudad de Buenos Aires]]></city>
      <region><![CDATA[Ciudad de Buenos Aires]]></region>
      <country><![CDATA[Argentina]]></country>
      <logo_url><![CDATA[http://www.example.com/logos/logo.jpg]]></logo_url>
    </agency>
    <price currency="USD"><![CDATA[1220000]]></price>
    <pictures>
      <picture>
        <picture_url><![CDATA[http://www.foo.com/11aa/123.jpg]]></picture_url>
        <picture_title><![CDATA[View from the pool X]]></picture_title>
      </picture>
    </pictures>
    <date><![CDATA[2009-08-31]]></date>
    <city_area><![CDATA[Belgrano]]></city_area>
    <city><![CDATA[Ciudad de Buenos Aires]]></city>
    <postcode><![CDATA[1412]]></postcode>
    <floor_number><![CDATA[32]]></floor_number>
    <latitude><![CDATA[-34.58828009730246]]></latitude>
    <longitude><![CDATA[-58.42357635498047]]></longitude>
    <orientation><![CDATA[north]]></orientation>
    <floor_area><![CDATA[210]]></floor_area>
    <floor_area_open><![CDATA[40]]></floor_area_open>
    <plot_area><![CDATA[250]]></plot_area>
    <rooms><![CDATA[3]]></rooms>
    <bathrooms><![CDATA[1]]></bathrooms>
    <year><![CDATA[2001]]></year>
    <blueprint_url><![CDATA[http://foo.com/realestate/11aa/blueprint.png]]></blueprint_url>
    <is_furnished><![CDATA[0]]></is_furnished>
    <is_new><![CDATA[0]]></is_new>
    <parking><![CDATA[1]]></parking>
    <patio><![CDATA[0]]></patio>
    <terrace><![CDATA[0]]></terrace>
    <balcony><![CDATA[1]]></balcony>
    <expiration_date><![CDATA[2009-11-30]]></expiration_date>
    <features>
      <feature><![CDATA[Pool]]></feature>
      <feature><![CDATA[Spa]]></feature>
      <feature><![CDATA[Terrace with trees!]]></feature>
    </features>
  </ad>
</ads>