Este artículo pretende servir de introducción al uso de los feeds XML incrementales de ReSales-Online y proporcionar el concepto básico de un procedimiento complejo para utilizar nuestros feeds XML incrementales y los pasos básicos a seguir.
Contenido
Introducción
La documentación técnica del uso de los feeds XML incrementales sólo está en inglés, por lo que hemos escrito este artículo en castellano para explicar por encima el proceso, pero para más detalles o asistencia consulte la documentación técnica o con nuestro equipo técnico
⚠️ Sólo hablaremos a continuación sobre los feeds XML incrementales de RESALES y RENTAL (venta y alquiler). Estos dos tipos de feed contienen todas las propiedades compartidas en el Network de agentes.
En términos generales, un feed XML es una URL (se parece a un enlace largo a un sitio web) que, cuando se ejecuta, devuelve datos brutos de propiedades (tipo de inmueble, detalles, URL de imágenes, descripciones...etc) que puedes descargar y utilizar para mostrar las propiedades en tu web.
Feed XML incremental: ¿qué significa?
En términos básicos, esto significa que después de la configuración inicial, sólo se incluirán en la siguiente descarga las propiedades que se hayan añadido al sistema o se hayan actualizado.
Cualquier propiedad que no se haya modificado desde la última descarga del feed se omitirá y no se incluirá en los resultados de la siguiente ejecución.
Cualquier propiedad que se elimine se incluirá como estado VENDIDA o RETIRADO DEL MERCADO, lo que significa que puede eliminarse de tu base de datos.
Cualquier propiedad que haya sido modificada o subida se incluirá como Disponible en los resultados del feed.
Si la referencia del inmueble ya existe, puedes sobrescribir la información existente con la nueva.
Si no existe ningún registro previo de esta referencia, puede considerarse como una nueva propiedad.
⚠️ Sí necesitan un feed XML no incrementál/estático - por favor, leer el artículo siguiente:
NUEVO feed XML estático para propiedades compartidas de reventa
Una pregunta habitual que recibimos es "¿Por qué obtengo 0 resultados en el feed (o sólo un número reducido)?"
La respuesta a esto es porque ReSales Online mantiene un registro de las propiedades que ya se han descargado por tu parte, si ves 0 resultados, significa que no se ha actualizado ninguna propiedad, ni subido desde la última ejecución.
Concepto
Antes de informar sobre el procedimiento a seguir, el concepto general de utilizar este feed incremental es descargar las propiedades en tandas más pequeñas, (esto se debe a que hay miles de propiedades que descargar y demasiadas a la vez, puede resultar que la conexión se corte y no las recibieras todas correctamente) ReSales-Online llevará un registro de qué propiedades se han descargado ya. Más adelante en este artículo se enumerarán los parámetros exactos que debes utilizar, pero el ejemplo a continuación utiliza tandas de 500 propiedades:
Por ejemplo:
La primera ejecución descargará las propiedades 1 - 500
La segunda ejecución descargará las propiedades 501 - 1001
La tercera ejecución descargará las propiedades 1002 - 1502
...etc.
Hasta que llegues a 0 resultados.
Esto significa que se han descargado todas las propiedades.
Procedimiento
A continuación repasaremos el procedimiento básico, desde cómo solicitar el feed a ReSales-Online, dónde localizarlo en tu cuenta, las primeras cosas que hay que comprobar y cómo utilizar los parámetros y descargar todas las propiedades, además de algunas buenas prácticas.
Cómo solicitar el feed XML
 |
Puedes encontrar nuestro icono de chat en la esquina inferior derecha de tu sistema ReSales-Online, o en nuestra página web. |
Inicia un chat con nuestro equipo de Soporte (debes ser administrador de una cuenta ReSales Online) y solicita un feed(s) incremental(es). Hemos separado las propiedades en Venta y en Alquiler en dos feeds distintos:
RESALES - sólo para propiedades de venta
RENTALS - sólo para propiedades de alquiler
** Nota: Las propiedades de obra nueva pueden incluirse en el feed de RESALES (en venta) combinados con las propiedades de segunda mano.
El equipo de Soporte creará el feed en tu cuenta y te responderá una vez completado con más instrucciones. Los parámetros de Desarrollo estarán activados por defecto durante 5 días laborables, lo que significa que el feed puede descargarse durante horario de oficina. Después tendrás que programar el feed para que se ejecute fuera del horario de oficina.
Dónde localizar el feed una vez creado
⚠️ Importante: sólo los administradores de cuenta pueden solicitar y acceder a los feeds XML de la cuenta.
Las URL de los feeds se encuentran desde el menú de la izquierda.
Haz clic en [Propiedades]
Haz clic en el desplegable de [Feed de exportación]
Seleccione "XML feeds"
Debería ver una página como la siguiente:
Puede que aquí haya varios feeds XML, aqui nos centraremos en la categoría RED y los feeds nombrados RESALES y RENTALS, cada feed XML tendrá un URL correspondiente a su lado.
Lo primero que hay que comprobar y preparar
Si copias y pegas el URL del feed en un navegado web, debería aparecer información al cabo de unos segundos, esto es una prueba rápida de que el feed está funcionando.
Al final de la URL hay un parámetro Sandbox, "&Sandbox=true", que te permite comprobar de forma segura el feed con un número limitado de propiedades. Hay que eliminarlo más adelante, en el siguiente paso, cuando realizas la primera ejecución.
Es hora de preparar los parámetros que queremos utilizar
Los parámetros se pueden utilizar para controlar de cierta forma qué información se quiere incluir en el feed, antes hemos mencionado algunos, pero otros que pueden ser útiles son:
Parametro | Descripción |
&Language=x,y,z | Idiomas Si quieres descargar los datos del inmueble en varios idiomas, utiliza este parámetro con una combinación de números para determinar qué idiomas deseas, por ejemplo: &Idioma=1,2 incluirá los datos en inglés y en español. |
&FV=2 | Versión del feed Utiliza la última versión del feed XML más información aquí |
&PA=TRUE | Agentes preferidos Si sólo quieres mostrar propiedades de determinados agentes, puedes elegir los agentes dentro de tu cuenta de ReSales Online y utilizar este parámetro - haz clic aquí para leer cómo establecer agentes preferidos |
&n=xx | Número de resultados por ejecución Como ya se ha dicho, es el número de propiedades incluidas en cada ejecución para descargar las propiedades en tandas. |
⚠️ Tenemos más parámetros disponibles, haz clic aquí para ver la lista completa de parámetros disponibles.
Para utilizar todos los parámetros de la lista anterior en el feed, agregalos al final de la URL de esta forma:
https://ejemplofeedurl.com/...etc&Sandbox=TRUE&Language=1,2&FV=2&PA=True&n=500
Descargar todas las propiedades por primera vez
En la primera ejecución (sólo la primera) se requiere un parámetro adicional que nos permitirá descargar TODAS las propiedades, o, dicho con otras palabras: pone a 0 el contador/puntero interno que te permitirte realizar una carga limpia: &i=True
⚠️ Este parámetro debe ser eliminado de la segunda y ejecución y posteriores, sí no, estarás descargando las mismos propiedades una y otra vez.
Ahora es necesario eliminar el parámetro Sandbox.
Con la lista de parámetros anterior más estos, la primera ejecución sería algo así:
https://ejemplofeedurl.com/...etc&Language=1,2&FV=2&PA=True&n=500&i=True
La segunda ejecución y posteriores serían así:
https://ejemplofeedurl.com/...etc&Language=1,2&FV=2&PA=True&n=500
Continúa ejecutando la el feed hasta que obtengas 0 resultados.
Esto significa que has descargado todas las propiedades.
Programar el feed para que se ejecute automáticamente fuera del horario de oficina.
Normalmente, los feeds se programan para que se ejecuten todas las noches después de las 19:00h y antes de las 8:00h del día siguiente.
Buenas prácticas
Evitar enviar la URL completa del feed en los mensajes.
Ya sea a tu desarrollador o a nuestro equipo de soporte, algunos proveedores de correo electrónico, plataformas o servicios de mensajería intentarán generar una vista previa de la URL al enviarla, lo que puede provocar que el contador interno se actualice y tu sitio web quede desincronizado.
En su lugar, corte la URL añadiendo un espacio en la parte primera, o envía sólo la cadena de parámetros.
Esperar a que la ejecucción se haya completado antes de ejecutarlo de nuevo.
Si realizas la segunda ejecución antes de que se haya completado la anterior, obtendrás un mensaje de error pidiéndote que esperes unos minutos, esto es común cuando no se utiliza el parámetro &N=, o, si el valor se establece demasiado alto y la conexión se interrumpe.
Si alguna vez tienes algún problema o tu sitio web se desincroniza
Inicia un chat con nuestro equipo de soporte solicitando que se habiliten los parámetros de desarrollo.
Realiza una carga limpia - haz clic aquí para leer la documentación (solo en inglés), o, sigue el Procedimiento anterior.