Chile - Feed Casas – Thribee

Si tienes una página web con avisos publicados, ¡puedes incluir tus avisos en Trovit, Mitula, Nestoria & Nuroa!. Es muy sencillo:

Crea un archivo XML siguiendo el formato especificado más abajo para el vertical casas.
Envía la URL donde se aloja (Ejemplo: http://www.tudominio.com.co/wp_feed.xml) a través de nuestro formulario de contacto.

A partir de ese momento, leeremos el feed periódicamente para insertar avisos nuevos, realizar las modificaciones pertinentes, y caducar aquellos avisos que ya no estén presentes en tu feed

Tus avisos serán introducidos en los resultados de búsqueda de Trovit lo antes posible!

En Trovit Casas sólo aceptamos feeds con avisos de casas en venta o alquiler. No incluimos habitaciones en renta, estacionamientos, terrenos, oficinas, etc.

Si tienes alguna consulta no dudes en ponerte en contacto con nosotros.

FORMATO DEL FEED XML

Estas son las instrucciones para generar un feed XML con el fin de incluir tus avisos en Trovit. Si necesitas más información sobre el formato XML te aconsejamos que consultes la Wikipedia.

La codificación del archivo debe ser en UTF-8

El archivo XML contendrá un tag ‘trovit’ y elementos ‘ad’. Cada uno de los ‘ad’ posee los campos:

CAMPOS OBLIGATORIOS

id: id del aviso en tu página web (puede ser numérico o alfanumérico, pero debe ser único, ya que lo utilizamos para evitar avisos duplicados)
url: la URL del aviso en tu página web
title: el título del aviso (debe ser completamente relacionado con el aviso, no puede contener ni el nombre ni la URL de tu web).
type: tipo de aviso:
- “For Rent”: Arriendo de inmueble
- “For Sale”: Venta de inmueble
- “Roommate”: Compartir departamento
- “Office For Rent”: Arriendo de oficina
- “Office For Sale”: Venta de oficina
- “Land For Sale”: Venta de terreno/lote
- “For Rent Local”: Arriendo de local
- “For Sale Local”: Venta de local
- “Warehouse For Rent”: Arriendo de bodega
- “Warehouse For Sale”: Venta de bodega
content: descripción del aviso (mínimo de 30 caracteres). Recuerda que cuanto más rica sea la descripción, ¡mayor será tu audiencia!

CAMPOS OPCIONALES

Los campos opcionales son justamente eso: opcionales!. Pero si dispones de estos campos en tu site, no dudes en incluirlos en tu feed! El algoritmo de ordenación de Trovit prioriza la calidad, y cuanto más rico sea el aviso, mayor será tu posicionamiento!

mobile_url: URL del aviso en tu página web cuando el usuario accede desde un dispositivo móvil. Útil cuando tu página web está preparada para dichos dispositivos.
price: Precio del aviso. Por defecto el precio se considera mensual pero se puede indicar explícitamente el periodo (monthly, daily o weekly) como atributo dentro de esta etiqueta.
```
<price period="weekly"><![CDATA[...]]></price>
```
Cuando el precio esté especificado en una moneda que no es la divisa oficial del país, se deberá usar el atributo ‘currency’. Los valores vendrán determinados por la norma ISO-4217. De este modo, Trovit podrá realizar la conversión a la moneda oficial.

La sintaxis para un ejemplo completo sería la siguiente:
```
<price period="weekly" currency="USD"><![CDATA[...]]></price>
```
Esto especificaría el precio semanal, en dólares. No se debe incluir el símbolo de la moneda junto al precio.

Cuando el precio esté especificado en una moneda que no es la divisa oficial del país, se deberá usar el atributo currency. De este modo, Trovit podrá realizar la conversión a la moneda oficial.

<price period="weekly" currency="USD"><![CDATA[...]]></price>

Esto especificaría el precio de un arriendo semanal, en dólares, en Chile. Trovit convertirá este precio a mensual y en pesos chilenos.

property_type: Tipo de propiedad (por ejemplo: departamento, casa, estudio, chalé, ático, etc.). Sólo aplicable si el aviso es de tipo “For Rent”, “For Sale”.
address: Dirección donde se encuentra el bien inmobiliario.
floor_number: Información textual con el número de planta del bien inmobiliario.
neighborhood: Barrio donde se encuentra el bien inmobiliario.
city_area: Área de la ciudad donde se encuentra el bien inmobiliario.
city: Ciudad donde se encuentra el bien inmobiliario.
region: Nombre de la región / provincia donde se encuentra el bien inmobiliario.
postcode: Código postal.
latitude: Latitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
longitude: Longitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
orientation: Información textual sobre la orientación del alojamiento (norte, sur, este, oeste, etc.).
agency: Nombre de la agencia. Ver campo by_owner para más información.
mls_database: Identificador único asignado a cada bien inmobiliario de una base de datos MLS (Multiple Listing Service).
floor_area: Superficie del bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’:
```
<floor_area unit="feet"><![CDATA[...]]></floor_area>
```
Los valores de ‘unit’ disponibles son: “meters” o “feet”.
plot_area: Superficie de la parcela dónde se ubica el bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’:
```
<plot_area unit="hectares"><![CDATA[...]]></plot_area>
```
Los valores de ‘unit’ disponibles son: “meters”, “feet”, “acres” o “hectares”.
rooms: Número de habitaciones del bien inmobiliario.
bathrooms: Número de baños del bien inmobiliario.
condition: Información textual sobre el estado del bien inmobiliario (por ejemplo: reformado recientemente).
year: Año de construcción del bien inmobiliario. El formato aceptado es AAAA.
virtual_tour: URL dónde se puede encontrar un paseo virtual del bien inmobiliario.

pictures: Esta etiqueta engloba las distintas imágenes del bien inmobiliario.El campo que define una imagen en particular es <picture>:
- picture: Esta etiqueta engloba los campos para especificar la URL y el título de la imagen (este último opcional). Se puede especificar si la imagen es la destacada con el atributo ‘featured’.
```
<picture featured="true">...</picture>
```
  Los valores de ‘featured’ disponibles son: “true” o “false”.
  
  Los campos a definir dentro del elemento <picture> son:
  - picture_url: URL de la imagen.
  - picture_title: Título de la imagen.
```
<pictures>

<picture>

<picture_url><![CDATA[...]]></picture_url>

<picture_title><![CDATA[...]]>/picture_title>

</picture>

<picture featured="true">

<picture_url><![CDATA[...]]></picture_url>

<picture_title><![CDATA[...]]>/picture_title>

</picture>

...

</pictures>
```
La imagen mostrada en Trovit de un aviso en particular será la primera del conjunto de imágenes del aviso, excepto si alguna de ellas es marcada como imagen destacada. Las imágenes deben ser de 186x186px como mínimo, con un peso máximo de 1MB.

Escoge la imagen más adecuada ya que ésta tiene una gran influencia sobre los clics del usuario.

Trovit no permite la inclusión de fotos corporativas con el mensaje “Imagen no disponible”.

Si se detectara este caso, Trovit se reserva el derecho de bloquear tus avisos.

Una vez se inserten tus avisos en Trovit, las imágenes asociadas a los avisos no se podrán modificar ni tan siquiera en la siguiente lectura de tu feed.

Asegúrate que los nuevos avisos que añadas a tu feed incluyen las imágenes correctas.
date: Fecha de publicación del avisos. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.
expiration_date: Fecha en la que caducará el avisos. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.

Los siguientes campos deben rellenarse según si son ciertos o falsos. Ver especificaciones técnicas para saber que valores representan cierto y que valores falso.

by_owner: Si el bien inmobiliario es ofrecido por un particular. En caso de ser falso se entenderá que es ofrecido por una agencia.
parking: Si el bien inmobiliario tiene parking o no.
foreclosure: Si el bien inmobiliario está bajo subasta por embargo.
is_furnished: Si el bien inmobiliario está amueblado o no.
is_new: Si el bien inmobiliario es de nueva construcción o no.

El feed XML quedará así:

<?xml version="1.0" encoding="utf-8"?>
<trovit>

<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>

    <agency><![CDATA[...]]></agency>
    <content><![CDATA[...]]></content>

    <price><![CDATA[...]]></price>

    <property_type><![CDATA[...]]></property_type>

    <floor_area unit="feet"><![CDATA[...]]></floor_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <parking><![CDATA[...]]></parking>

    <address><![CDATA[...]]></address>
    <city><![CDATA[...]]></city>
    <city_area><![CDATA[...]]></city_area>
    <postcode><![CDATA[...]]></postcode>

    <region><![CDATA[...]]></region>

    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>

    <pictures>

        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        <picture>

            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        ...
    </pictures>

    <virtual_tour><![CDATA[...]]></virtual_tour>

    <date><![CDATA[...]]></date>




</ad>

<ad>
    ....
</ad>

<ad>
    ....
</ad>

...

</trovit>

Ejemplo de feed XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
<id><![CDATA[7004578]]></id>
<url><![CDATA[http://www.tudominio.cl/ad/7004578]]></url>
<title><![CDATA[Departamento 2 habitaciones en Santiago]]></title>
<type><![CDATA[For rent]]></type>

<agency><![CDATA[Agencia Inmobiliaria]]></agency>
<content><![CDATA[Departamento en arriendo de 2 habitaciones en Vitacura, Santiago ]]></content>

<price><![CDATA[800000]]></price>

<property_type><![CDATA[Departamento]]></property_type>
<floor_area unit="meters"><![CDATA[200]]></floor_area>
<rooms><![CDATA[3]]></rooms>

<bathrooms><![CDATA[2]]></bathrooms>
<parking><![CDATA[1]]></parking>

<address><![CDATA[]]></address>
<city><![CDATA[Santiago]]></city>

<city_area><![CDATA[Vitacura]]></city_area>
<postcode><![CDATA[]]></postcode>
<region><![CDATA[Santiago]]></region>

<latitude><![CDATA[]]></latitude>

<longitude><![CDATA[]]></longitude>

<pictures>
<picture>
<picture_url><![CDATA[http://www.tudominio.cl/image.jpg]]></picture_url>
<picture_title><![CDATA[salón]]></picture_title>
</picture>
</pictures>

<date><![01/01/2011 18:30:25]]></date>



</ad>

<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.tudominio.cl/ad/332A53BC2]]></url>
<title><![CDATA[Departamento nuevo en Lo Barnechea]]></title>

<type><![CDATA[For sale]]></type>
<content><![CDATA[Departamento nuevo, tercera planta, muy luminoso]]></content>

<price><![CDATA[200009950]]></price>

<address><![CDATA[]]></address>
<city><![CDATA[Santiago]]></city>
<postcode><![CDATA[]]></postcode>
<region><![CDATA[Santiago]]></region>

<pictures>
<picture>
<picture_url><![CDATA[http://www.tudominio.cl/image.jpg]]></picture_url>
<picture_title><![CDATA[salón]]></picture_title>

</picture>
</pictures>

<date><![CDATA[01/01/2011 18:30:25]]></date>



</ad>
</trovit>

ESPECIFICACIONES TÉCNICAS

Para más información, haga click aquí: ver especificaciones técnicas.

Articles in this section

Chile - Feed Casas

FORMATO DEL FEED XML

CAMPOS OBLIGATORIOS

CAMPOS OPCIONALES

Ejemplo de feed XML

ESPECIFICACIONES TÉCNICAS

Comments