Actualmente Mobilia tiene la posibilidad de hacer integración con portales comerciales vía API. En el momento se cuenta con las siguientes integraciones:
Integración con Mercado Libre
Todos los aspectos técnicos sobre acceso y autorización a la API, publicación, actualización o eliminación de inmuebles en el portal, o aspectos puntuales sobre la información de los inmuebles contenida en las publicaciones, puede ser consultada en la documentación oficial de la API de Mercado Libre para inmuebles.
Atributos requeridos para publicar un inmueble en el portal de Mercado Libre
En el siguiente listado se encuentran los atributos del inmueble que son obligatorios, y sin los cuales no será publicado el inmueble en el portal:
Dirección
Latitud y Longitud
Código de la ciudad (dado por Mercado Libre. Este dato no es modificable por el usuario)
Distribución de pisos (número de plantas)
Número de baños
Número de habitaciones
Cómo publicar un inmueble en Mercado Libre desde Mobilia
Para publicar un inmueble, se debe buscar un inmueble activo (que se encuentre en venta o en arriendo) desde la ruta inmuebles/inmuebles en Mobilia. Tras obtener los resultados de la búsqueda, se debe seleccionar alguno, y navegar hacia la vista de consignación, señalada a continuación:
Al final de esta página, se encuentra la sección titulada “Códigos Externos”. En esta, es posible encontrar un checkbox mediante el cual señalar el portal externo en el que se desea publicar el inmueble, en este caso, Mercado Libre:
Una vez marcada la opción Mercado Libre, se debe presionar el botón “Publicar en portales externos“, en donde se mostrará, mediante un aviso emergente o popUp, el resultado de la publicación. Los posibles resultados son:
Inmueble publicado: se mostrará en caso de que la petición para publicar el inmueble en el portal haya sido enviada con éxito. Después de esto, aún es necesario esperar que Mercado Libre procese la petición para poder visualizar el inmueble en el portal.
Mensaje de error informando que el inmueble no cuenta con uno de los atributos obligatorios:
Nota: Es posible seleccionar más de un portal a la vez, en cuyo caso se mostrará en el popUp el resultado de la publicación en cada uno de los portales, de forma independiente (Aplicable por el momento para Mercado Libre y Finca Raíz).
Actualización de la publicación en Mercado Libre
Una vez el inmueble se encuentre publicado en el portal, se le asignará un código (dado por Mercado Libre) que será visible en lugar del checkbox utilizado previamente para publicarlo, en la sección de Códigos Externos de la vista de consignación del inmueble:
A partir de este punto, no es necesario hacer republicación o actualización alguna por parte del usuario, pues mientras el inmueble se mantenga publicado en el portal, éste se actualizará automáticamente para reflejar los cambios aplicados desde Mobilia.
Cómo consultar los resultados de la publicación (Logs de integración) en Mobilia
Los resultados de las peticiones enviadas para publicar un inmueble en el portal se pueden consultar desde la vista Parámetros/Integraciones, en donde se deben aplicar los filtros necesarios para consultar la información del inmueble y del portal deseado. A continuación se muestran las opciones disponibles para el filtro de búsqueda:
Dentro de los campos utilizados con mayor frecuencia se encuentran:
Propiedad: código del inmueble a consultar
Desde: fecha desde la cual se quieren incluir resultados.
Hasta: fecha hasta la cual se quieren incluir resultados
Catálogo: portal externo que se quiere consultar, en este caso, Mercado Libre.
¿Cómo despublicar un inmueble de Mercado Libre desde Mobilia?
La despublicación del inmueble consiste en eliminar la publicación del portal, y limpiar el código externo asignado por Mercado Libre. Existen tres escenarios bajo los cuales se despublica un inmueble
Inactivación del inmueble : sucede cuando el inmueble es marcado como inactivo desde la vista de editar inmueble en Mobilia.
Venta del inmueble
Arriendo del inmueble
En cualquiera de estos casos, el inmueble quedará marcado como inhabilitado para integraciones, por lo que no será posible volverlo a publicar hasta que nuevamente esté en activo, arriendo o en venta, si es el caso.
Actualización del canon para inmuebles en arriendo
Valor mínimo de canon para la publicación de inmuebles en portales externos
Las sucursales en Mobilia establecen un valor mínimo del canon de arrendamiento que limita los inmuebles en arriendo que pueden ser publicados en los portales externos dependiendo de la empresa inmobiliaria. Este valor se encuentra en el campo minimumRentValueToPublishProperties de la tabla mob_branch.
Reglas de publicación de inmuebles basados en el canon de arrendamiento
Las integraciones con portales externos se rigen bajo las siguientes reglas:
No se publicarán inmuebles en arriendo cuyo valor de canon de arrendamiento se encuentre por debajo del valor mínimo establecido para cada sucursal.
Si un inmueble se encuentra publicado en un portal, y su valor de canon de arrendamiento es actualizado, de modo que el nuevo valor quede por debajo del mínimo establecido en la sucursal a la que pertenece, entonces automáticamente el inmueble será eliminado del portal de Mercado Libre, y su código externo será eliminado.
El inmueble sólo podrá ser publicado de nuevo si su valor de canon es actualizado por un valor por encima del valor mínimo de la sucursal o si es puesto sólo en venta y no en arriendo.
Es importante mencionar que Mercado Libre define un valor mínimo en el precio de venta de inmuebles, dependiendo de su categoría. Si un inmueble en venta no puede ser publicado debido a que tiene un valor de venta muy bajo, un mensaje expresando este motivo puede ser visto en los logs de integración del inmueble.
PUBLICACIÓN MASIVA: Mercado Libre no cuenta con la opción automatizada para publicar masivamente los inmuebles registrados en Mobilia.
Integración con Metro Cuadrado
Documentación oficial API Metrocuadrado
El detalle del consumo de la API y el uso de sus servicios se puede ver en detalle en la siguiente dirección.
Funcionamiento técnico
Mobilia integra (publica, despublica o actualiza) inmuebles a Metrocuadrado bajo la ejecución del Job de propiedades (PropertiesUpdateRoboto). Este Job consulta los inmuebles disponibles para integrar y simplemente los envía al portal por medio del uso de la API.
Un intento de integracion genera una transacción. Esta transacción debe consultarse al portal para conocer el resultado de la integracion. De esta manera se puede tener la información al día del inmueble en el portal dentro de mobilia. Este procesamiento de sincronización lo realiza el job de transacciones de M2 (M2PropertiesTransactionsProcessingJob):
Requisitos mínimos para la publicación y actualización de inmuebles
Un inmueble que se desea publicar desde cero o actualizar en Metrocuadrado debe cumplir con tener la siguiente información:
Tipo de inmueble
Valor
Tipo de publicación (Arriendo o venta)
Ciudad
Imágenes (entre 1 y 20)
Nombre del barrio
Información general
Características del inmueble
La obligatoriedad de estas se puede ver con mas detalle (según tipo de inmueble y posibles valores) en esta documentación: nueva integracion metro cuadrado.xls
La publicación de los inmuebles funciona igual a la Mercado Libre.
Integración con Finca Raíz
Todos los aspectos técnicos sobre acceso y autorización a la API, publicación, actualización o eliminación de inmuebles en el portal, o aspectos puntuales sobre la información de los inmuebles contenida en las publicaciones, puede ser consultada en la documentación oficial de la API de Finca Raiz.
Atributos requeridos para publicar un inmueble en el portal
En el siguiente listado se encuentran los atributos del inmueble que son obligatorios, y sin los cuales no será publicado el inmueble en el portal:
Dirección.
Latitud y Longitud.
Descripción.
Número de habitaciones.
Información de contacto de la sucursal del inmueble (email y teléfono).
¿Cómo publicar un inmueble?
Para publicar un inmueble, se debe buscar un inmueble activo (que se encuentre en venta o en arriendo) desde la ruta inmuebles/inmuebles en Mobilia. Tras obtener los resultados de la búsqueda, se debe seleccionar alguno, y navegar hacia la vista de consignación, señalada a continuación:
Al final de esta página, se encuentra la sección titulada “Códigos Externos”. En esta, es posible encontrar un checkbox mediante el cual señalar el portal externo en el que se desea publicar el inmueble, en este caso, Finca Raíz:
Una vez marcada la opción Finca Raíz, se debe presionar el botón “Publicar en portales externos“, en donde se mostrará, mediante un aviso emergente o popUp, el resultado de la publicación. Los posibles resultados son:
Inmueble publicado: se mostrará en caso de que la petición para publicar el inmueble en el portal haya sido enviada con éxito. Después de esto, aún es necesario esperar que Finca Raíz procese la petición para poder visualizar el inmueble en el portal:
Mensaje de error informando que el inmueble no cuenta con uno de los atributos obligatorios:
Nota: Es posible seleccionar más de un portal a la vez, en cuyo caso se mostrará en el popUp el resultado de la publicación en cada uno de los portales, de forma independiente.
Actualización de la publicación en Finca Raíz
Una vez el inmueble se encuentre publicado en el portal, se le asignará un código (dado por Finca Raíz) que será visible en lugar del checkbox utilizado previamente para publicarlo, en la sección de Códigos Externos de la vista de consignación del inmueble:
A partir de este punto, no es necesario hacer republicación o actualización alguna por parte del usuario, pues mientras el inmueble se mantenga publicado en el portal, éste se actualizará automáticamente para reflejar los cambios aplicados desde Mobilia.
Cómo consultar los resultados de la publicación (Logs de integración) en Mobilia
Los resultados de las peticiones enviadas para publicar un inmueble en el portal se pueden consultar desde la vista Parámetros/Integraciones, en donde se deben aplicar los filtros necesarios para consultar la información del inmueble y del portal deseado. A continuación se muestran las opciones disponibles para el filtro de búsqueda:
Dentro de los campos utilizados con mayor frecuencia se encuentran:
Propiedad: código del inmueble a consultar
Desde: fecha desde la cual se quieren incluir resultados.
Hasta: fecha hasta la cual se quieren incluir resultados
Catálogo: portal externo que se quiere consultar, en este caso, Finca Raíz.
Cómo des publicar un inmueble de Finca Raíz desde Mobilia
La des publicación del inmueble consiste en marcar la publicación del portal como inactiva. Existen tres escenarios bajo los cuales se des publica un inmueble
Inactivación del inmueble : sucede cuando el inmueble es marcado como inactivo desde la vista de editar inmueble en Mobilia.
Venta del inmueble.
Arriendo del inmueble.
En cualquiera de estos casos, el inmueble quedará marcado como inhabilitado para integraciones, por lo que no será posible volverlo a publicar hasta que nuevamente esté en activo, arriendo o en venta, si es el caso.
Actualización del canon para inmuebles en arriendo
Valor mínimo de canon para la publicación de inmuebles en portales externos
Las sucursales en Mobilia establecen un valor mínimo del canon de arrendamiento que limita los inmuebles en arriendo que pueden ser publicados en los portales externos dependiendo de la empresa inmobiliaria. Este valor se encuentra en el campo minimumRentValueToPublishProperties de la tabla mob_branch.
Reglas de publicación de inmuebles basados en el canon de arrendamiento
Las integraciones con portales externos se rigen bajo las siguientes reglas:
No se publicarán inmuebles en arriendo cuyo valor de canon de arrendamiento se encuentre por debajo del valor mínimo establecido para cada sucursal.
Si un inmueble se encuentra publicado en un portal, y su valor de canon de arrendamiento es actualizado, de modo que el nuevo valor quede por debajo del mínimo establecido en la sucursal a la que pertenece, entonces automáticamente el inmueble será eliminado del portal de Mercado Libre, y su código externo será eliminado.
El inmueble sólo podrá ser publicado de nuevo si su valor de canon es actualizado por un valor por encima del valor mínimo de la sucursal o si es puesto sólo en venta y no en arriendo.
Es importante mencionar que Mercado Libre define un valor mínimo en el precio de venta de inmuebles, dependiendo de su categoría. Si un inmueble en venta no puede ser publicado debido a que tiene un valor de venta muy bajo, un mensaje expresando este motivo puede ser visto en los logs de integración del inmueble.
Publicación Masiva
La publicación masiva de inmuebles en Finca Raíz se hace desde la ruta inmuebles/inmuebles, en donde se encuentra en la parte inferior de la vista una sección desplegable con un botón que permitirá realizar esta acción:
Segundos después de presionar este botón, se verá un mensaje indicando que el proceso de publicación de los inmuebles comenzó.
A partir de este momento, es posible consultar los logs de integración o las publicaciones del portal, las cuales irán aumentando paulatinamente.
Generalidades
Variables de entorno a tener en cuenta para la Integración
Este permiso se debe solicitar al área encargada de la parametrización en Mobilia dentro de su organización.
Integración con Cien cuadras.
En el adjunto se puede visualizar la documentación.
¿Le ha sido útil este artículo?
¡Qué bien!
Gracias por sus comentarios
¡Sentimos mucho no haber sido de ayuda!
Gracias por sus comentarios
Sus comentarios se han enviado
Agradecemos su esfuerzo e intentaremos corregir el artículo