Si tienes un portal inmobiliario y quieres que tus anuncios salgan en nuroa, tan sólo tienes que seguir las indicaciones que vienen detalladas a continuación:
- Contacta con nosotros enviandonos un e-mail a partner@nuroa.com para conocer cual es la opción de integración que mejor se adapta a tus necesidades.
- Genera un archivo XML en el formato explicado abajo.
- Asegúrate de que no haya errores de sintaxis o fallos que imposibiliten el correcto procesamiento de la información utilizando cualquier validador de XML disponible en internet, como por ejemplo http://www.xml.com/pub/a/tools/ruwf/check.html.
- Comunícanos la URL donde está alojado el archivo XML. Si prefieres también puedes subir el archivo directamente a nuestro servidor FTP. Contacta con nosotros y te enviaremos los datos de acceso.
Una vez recibido el archivo procederemos con la indexación de tus anuncios.
XML e información facilitada
Aquí encontrarás las especificaciones y campos requeridos para la indexación de tus anuncios en nuroa. Es muy importante que el archivo XML tenga todos los campos obligatorios tal y como viene explicado a continuación para que podamos procesar la información correctamente.
Puntos importantes para el procesamiento del feed XML:
- Es importante incluir el ! [CDATA [ . . . ] ] en cada campo del XML para evitar errores de interpretación de los markup.
- Cuando un feed es procesado y un anuncio está ya presente en nuroa, sólo se actualizarán los siguientes campos del anuncio: <ad_type>, <category> e <price>. Un anuncio ya indexado en nuroa será actualizado totalmente (todos los campos del anuncio) sólo y cuando será modificado el campo <last_update>.
- La imagen del anuncio que se verá en nuroa será la primera de la serie de imágenes incluidas en el XML. No aceptamos imágenes corporativas con informaciones del tipo “Imagen no disponible”.
- Es imprescindible que para cada anuncio existe una URL única o dicho de otra manera no puede haber dos anuncios asociados a la misma URL.
- En caso de que el formato del archivo XML no cumpla con todos los requisitos mencionados en esta página, bajo ningún concepto podrá ser considerado responsable Nuroa Internet S.L. del mal procesamiento de la información facilitada. Asimismo Nuroa Internet S.L. se desvincula de cualquier responsabilidad respecto a la veracidad o inexactitud de los datos proporcionados. La actualización de la información contenida en el archivo XML correrá a cargo del anunciante.
Estructura del feed
La estructura general del documento aparece en el recuadro abajo. Los campos obligatorios están en negrita. Cuando un campo es obligatorio tiene que llevar dicha información, en caso contrario el anuncio no saldrá en nuestra base de datos. Cuando no se disponen de los datos para rellenar un campo opcional, se tiene que dejar el campo vacío.
<?XML version=“1.0” encoding=“UTF-8”?>
<feed>
<site>
<name><![CDATA[. . . ]]></name>
<url><![CDATA[ . . . ]]></url>
<type><![CDATA[ . . . ]]></type>
<contact_name><![CDATA[ . . . ]]></contact_name>
<contact_email><![CDATA[ . . . ]]></contact_email>
<contact_phone><![CDATA[ . . . ]]></contact_phone>
</site>
<property_list>
<property>
<id><![CDATA[ . . . ]]></id>
<link><![CDATA[ . . . ]]></link>
<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>
<agency_name><![CDATA[ . . . ]]></agency_name>
<agency_address><![CDATA[ . . . ]]></agency_address>
<ad_type><![CDATA[ . . . ]]></ad_type>
<category><![CDATA[ . . . ]]></category>
<title><![CDATA[ . . . ]]></title>
<description><![CDATA[ . . . ]]></description>
<european_energy_class><![CDATA[ . . . ]]></european_energy_class>
<european_energy_index><![CDATA[ . . . ]]></european_energy_index>
<rooms><![CDATA [ . . . ]]></rooms>
<bathrooms><![CDATA[ . . . ]]></bathrooms>
<square_meters><![CDATA [ . . . ]]></square_meters>
<floor_number><![CDATA[ . . . ]]></floor_number>
<furnished><![CDATA [ . . . ]]></furnished>
<is_new><![CDATA[ . . . ]]></is_new>
<condition><![CDATA[ . . . ]]></condition>
<year><![CDATA[ . . . ]]></year>
<owner><![CDATA[ . . . ]]></owner>
<bank><![CDATA[ . . . ]]></bank>
<foreclosure><![CDATA[ . . . ]]></foreclosure>
<price><![CDATA[ . . . ]]></price>
<price_day><![CDATA[ . . . ]]></price_day>
<price_week><![CDATA[ . . . ]]></price_week>
<city><![CDATA [ . . . ]]></city>
<country><![CDATA[ . . . ]]></country>
<location><![CDATA[ . . . ]]></location>
<postcode><![CDATA [ . . . ]]></postcode>
<neighbourhood><![CDATA[ . . . ]]></neighbourhood>
<longitude><![CDATA [ . . . ]]></longitude>
<latitude><![CDATA[ . . . ]]></latitude>
<orientation><![CDATA [ . . . ]]></orientation>
<insertion_date><![CDATA[ . . . ]]></insertion_date>
<last_update><![CDATA[ . . . ]]></last_update>
</property>
...
</property_list>
</feed>
Campos Obligatorios
name: El nombre de vuestra página web - Texto libre
url: La URL de vuestra página web. En caso de que vuestro portal tenga varios subdominios, tenéis que indicarnos la URL donde se encuentran los anuncios (por ej: http://www.miportal.com/casas)
id: id del anuncio en vuestra página web. Puede ser numérico o alfanumérico pero debe ser único - Campo numérico
link: URL del anuncio. Es imprescindible que se trate de una URL única para cada uno de los anuncios, o dicho de otra manera no puede haber dos anuncios asociados a la misma URL
ad_type: Tipo del bien inmobiliario - Campo cerrado, a elegir entre: buy | new development | rent | flatshare
category: Tipo de vivienda: piso| casa | oficina | parking | etc. - Texto libre
title: Encabezado del anuncio - Texto libre
description: Descripción del anuncio - Texto libre
price: Precio por defecto en la moneda local del país para venta, obra nueva y alquiler (mensual) (ej: EUR para Euro, MXN peso mexicano para México, ARS peso argentino para Argentina, CLP peso chileno para Chile, USD dólar estadounidense etc.)*. En el caso de alquiler por día o por semana, utilizar los demás campos específicos detallados a continuación – Campo numérico
price_day: Precio en moneda local (EUR para Euro, MXN peso mexicano para México, ARS peso argentino para Argentina, CLP peso chileno para Chile, USD dólar estadounidense)* por día a utilizar solo para propiedades en alquiler - Campo numérico
price_week: Precio en moneda local (EUR para Euro, MXN peso mexicano para México, ARS peso argentino para Argentina, CLP peso chileno para Chile, USD dólar estadounidense)* por semana a utilizar solo para propiedades en alquiler - Campo numérico
city: Población/Municipio del inmueble – Texto libre
country: País del inmueble – Texto libre
longitude: Longitud. Este es un campo importante para el posicionamiento de tus anuncios en los resultados de nuroa, sin embargo se aceptarán feed que no incluyan este campo – Campo numérico
latitude: Latitud. Este es un campo importante para el posicionamiento de tus anuncios en los resultados de nuroa, sin embargo se aceptarán feed que no incluyan este campo - Campo numérico
insertion_date: Fecha en la que el anuncio ha sido insertado en la web por primera vez – Formato fecha DD/MM/YYYY (ex. 01/01/2011).
last_update: Fecha de la última actualización del anuncio. Cuando este campo viene modificado todo los campos del anuncio serán actualizados en Nuroa - Formato fecha DD/MM/AAAA (ex. 24/01/2011).
*el precio de las propriedades en nuroa se visualizará en moneda local del país. Si en el mismo feed se utilizan mas de 1 moneda es necesario y obligatorio incluir el campo <currency>, como explicado abajo.
Campos recomendados para conseguir un mejor posicionamiento en el listado de resultados y optimizar la conversión
pictures: URLs de las imágenes de la propriedad. En Nuroa no permitimos la inclusión de imágenes corporativas con la escrita “imagen no disponible”.
picture: el elemento “property” puede contener varios campos “picture”. Una vez integrados tus anuncios en Nuroa, las imágenes de los anuncios no se podrán modificar. En caso de que nos facilitéis varias imágenes para un mismo anuncio, sólo se mostrará la primera imagen del grupo, así que asegúrate de que la primera imagen sea la mas atractiva.
picture_url: URL de la imagen
agency_name: Nombre de la agencia - Texto libre
agency_address: La dirección de la agencia (ex. c/ Casp 33 – 08010 Barcelona) - Texto libre
rooms: Número de habitaciones – Campo numérico
bathrooms: Número de baños – Campo numérico
square_meters: Superfice – Campo numérico
floor_number: Número de planta – Campo numérico
foreclosure: 1 = la propriedad pertenece a una subasta por embargo; 0 = la propriedad no pertenece a una subasta por embargo - Campo numérico
location: Dirección o barriodonde está ubicada la vivienda - Texto libre
postcode: Código postal - Campo numérico
neighbourhood: Barrio o distrito - Texto libre
Campos Opcionales
type:Tipo de la página (portal inmobiliario, clasificado, banco) - Texto libre
contact_name: Nombre de la persona de contacto encargada de la creación y exportación del archivo - Texto libre
contact_email: E –mail de contacto de la persona encargada de la creación y exportación del archivo - Texto libre
contact_phone: Telefono de contacto de la persona encargada de la creación y exportación del archivo - Campo numérico
picture_title: Titulo de la imagen - Texto libre
furnished: 1 = la propriedad está amueblada; 0 = la propriedad no está amueblada - Campo numérico
is_new: 1 = obra nueva; 0 = construcción antigua - Campo numérico
condition: Por ejemplo “recién renovado” “a reformar” - Texto libre
year: Año de construcción de la vivienda – Formato fecha AAAA (ex. 2009)
owner: 1 solo si la propriedad es ofrecida por un particular. Si la propriedad es ofrecida por una agencia el campo puede estar vacio - Campo numérico
bank: 1 solo si la propriedad es ofrecida por un banco. Si la propriedad es ofrecida por una agencia el campo puede estar vacio - Campo numérico
currency*: La moneda en la que los precios están publicados. Es obligatorio utilizar el estandard ISO 4217. - Texto en formato ISO 4217
orientation: La orientación de la vivienda: norte | sur | este | oeste - Texto libre
*el campo currency tiene que venir escrito utilizando los códigos internacionales definidos por el ISO 4217. Ejemplos: EUR para Euro, MXN para peso mexicano, ARS para peso argentino, CLP para peso chileno, USD para dólar estadounidense.
