1. Primeros pasos XML

En esta página

Este servicio te permite sincronizar tus avisos con nuestros portales de forma masiva y programática. Solo necesitas proporcionarnos un archivo XML que contenga el listado completo de tus inmuebles disponibles.

Nuestro sistema se encargará de:

Crear avisos nuevos.
Actualizar avisos existentes.
Desactivar (poner offline) los avisos que ya no estén en tu listado XML.

¿Cómo empezar?

Para XML no hace falta autenticarte, solo necesitarás crear un XML con el formato de la documentación e indicarnos dónde podemos obtenerlo. Nuestro sistema se va a encargar de poner offline los avisos que no estén en el listado, crear los que no existen y actualizar o publicar los avisos que correspondan.

El servicio acepta dos protocolos:

HTTP: deberás indicar una URL donde puedan descargar el XML.
FTP: deberás proveer los datos de conexión al servidor FTP:
- Host
- Username (usuario)
- Password
- Path (ruta)
- Nombre del archivo
- Si el archivo debe eliminarse después de ser descargado (flag)

Además, se debe indicar si el XML va a estar comprimido (ZIP o GZIP) y si tiene contraseña.

Consideraciones técnicas

Descarga de archivos

Para que nuestro sistema descargue tus archivos, es necesario tener en cuenta las siguientes consideraciones:

Tipo de archivos XML

Desde nuestro sistema validamos que el archivo a descargar sea un XML. Para ello utilizamos el atributo Content-Type del header de la response**.** Para obtener este dato realizamos un request de tipo Header.

Es necesario que el integrador nos permita realizar el request de tipo Header y retorne un valor válido en el atributo Content-Type del header.

Valores válidos: text/xml y application/xml.

Multimedia de un aviso

Antes de agregar multimedia, se debe tener en cuenta lo siguiente:

Restricciones del archivo:

No debe superar la resolución máxima de 6000 × 6000 px.
No debe superar el tamaño máximo de 10 MB.

Recomendaciones y comportamientos del sistema:

Soporte de request HEAD: Se recomienda que las URLs de multimedia admitan requests de tipo HEAD, ya que esto facilita la identificación del E-Tag asociado a cada recurso multimedia.
Unicidad de E-Tag: El E-Tag debe ser único por cada recurso multimedia. Multimedias visualmente distintas que compartan el mismo E-Tag serán consideradas como iguales por nuestro sistema, por lo tanto no seran procesadas.
Identificación por URL: URLs iguales son identificadas como la misma multimedia. Esto significa que si una imagen ha sido modificada pero su URL sigue siendo la misma, la imagen no se procesará.
Cambio de recurso en una URL existente: Si se modifica el contenido de una multimedia (por ejemplo, una edición de tonos o la aplicación de una marca de agua) pero se conserva la misma URL utilizada con anterioridad, el cambio no será procesado. Para que el sistema descargue la nueva versión, es necesario actualizar la URL si la multimedia ya fue procesada previamente.
Cache-Breaker: El sistema no tendrá en cuenta si la URL contiene un Cache-Breaker.
Protocolos SSL/TLS aceptados

Nuestro sistema acepta los siguientes protocolos de seguridad para comunicarse con otros servicios en la red:

TLS 1.3
TLS 1.2
TLS 1.1
TLS 1.0

Listado de IPs

Nuestro sistema utiliza las siguientes direcciones IP para acceder a los archivos XML y multimedia del integrador. Es necesario que estas IPs estén habilitadas (whitelisted) en sus servidores para garantizar la correcta descarga de los recursos:

34.23.222.147
34.73.43.58
34.73.87.198
34.73.131.228
34.73.133.84
34.73.202.247
34.138.208.157
35.227.93.231
35.229.112.167
35.231.133.203
35.231.137.0
35.231.202.239
35.237.53.28