# Configuración del Módulo de Integración con Portales

# ¿Cómo crear la integración con Finca Raiz?

En este instructivo encontrará los pasos necesarios para integrar su cuenta de nuby con el portal Fincaraíz, permitiéndole publicar automáticamente sus propiedades desde el sistema sin necesidad de cargar la información manualmente.

Esta integración le ayudará a ahorrar tiempo, mantener su inventario actualizado en ambos sistemas y aumentar la visibilidad de sus inmuebles en uno de los portales más reconocidos del sector inmobiliario.

##### **Requisitos mínimos para la integración de portales.**

1. <span style="font-weight: 400;"> Debe tener una cuenta con acceso al portal de Fincaraíz (usuario y contraseña).</span>
2. <span style="font-weight: 400;"> El usuario asignado por Fincaraíz debe tener habilitada la opción de “Integración”, en caso de no tener claro este estado consulte con su asesor, o la persona quien le entregó los datos de acceso al portal.</span>

##### **Paso 1:** Acceda a la información dando clic en **Herramientas** y luego en la opción **Configuraciones**.

[![2025-07-02 15_22_19-Greenshot.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/VxMGqSGiGo9Pnjds-2025-07-02-15-22-19-greenshot.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/VxMGqSGiGo9Pnjds-2025-07-02-15-22-19-greenshot.png)

##### **Paso 2:** <span style="font-weight: 400;">Seleccione la opción integración portales.  
  
</span>

[![2025-07-02 15_23_33-Greenshot.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/tyg0xLS2XIlj5Yyz-2025-07-02-15-23-33-greenshot.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/tyg0xLS2XIlj5Yyz-2025-07-02-15-23-33-greenshot.png)

##### **Paso 3:** <span style="font-weight: 400;">Active integración con portales.</span>

<span style="font-weight: 400;">Valide que la opción activar integración con portales esté en **SÍ**.</span>

[![2025-07-02 15_25_18-Greenshot.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/gB09wSiZXAPxRjq6-2025-07-02-15-25-18-greenshot.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/gB09wSiZXAPxRjq6-2025-07-02-15-25-18-greenshot.png)

##### **Paso 4:** <span style="font-weight: 400;">Configure la integración del portal.</span>

<span style="font-weight: 400;">De clic en la opción **configurar datos** del menú de Fincaraíz</span>

[![2025-07-02 15_29_00-Greenshot.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/L8UBU8XtI4An57F1-2025-07-02-15-29-00-greenshot.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/L8UBU8XtI4An57F1-2025-07-02-15-29-00-greenshot.png)

##### **Configuración de Integración con Finca Raíz**

A continuación, se detallan los campos requeridos para configurar correctamente la integración de publicaciones automáticas entre **nuby** y **Finca Raíz**:

<div class="markdown-table-wrapper" id="bkmrk-campo-descripci%C3%B3n-re"><table><thead><tr><th>**Campo**</th><th>**Descripción**</th><th>**Requisitos/Observaciones**</th></tr></thead><tbody><tr><td>**Activar Integración**</td><td>Habilita la sincronización automática de propiedades con el portal.</td><td>- Valor: **"Sí"** para activar.</td></tr><tr><td>**Publicación Automática**</td><td>Permite que las propiedades nuevas se publiquen automáticamente en Finca Raíz.</td><td>- Solo aplica si la integración está activada.</td></tr><tr><td>**ID de Cliente**</td><td>Credencial única proporcionada por Finca Raíz para la conexión.</td><td>- Obligatorio. Debe ser ingresado exactamente como lo proporcionó Finca Raíz.</td></tr><tr><td>**Teléfono1**</td><td>Número de contacto principal (fijo o celular).</td><td>- **Obligatorio**. Usado para publicaciones y contacto en el portal.</td></tr><tr><td>**Teléfono2** / **Teléfono3**</td><td>Números de contacto adicionales.</td><td>- Opcionales. Deben ser válidos.</td></tr><tr><td>**Teléfono WhatsApp**</td><td>Número asociado a WhatsApp para contacto.</td><td>- Debe coincidir con Teléfono1, Teléfono2 o Teléfono3.</td></tr><tr><td>**Teléfono ClickToCall**</td><td>Número principal para recibir llamadas desde el portal.</td><td>- Debe coincidir con Teléfono1, Teléfono2 o Teléfono3.</td></tr><tr><td>**Email1**</td><td>Correo electrónico del agente principal.</td><td>- **Obligatorio**. Debe estar registrado como asesor en la cuenta del cliente.</td></tr><tr><td>**Email2**</td><td>Correo electrónico secundario del agente.</td><td>- Opcional. También debe estar registrado como asesor.</td></tr><tr><td>**Guardar**</td><td>Finaliza la configuración.</td><td>- **Requerido** para aplicar los cambios.</td></tr></tbody></table>

</div>##### **Paso 5:** <span style="font-weight: 400;">Presione la opción homologación de datos del menú de Finca Raíz.</span>

[![2025-07-02 15_41_11-Greenshot.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/5I1OzADThBGnyAKn-2025-07-02-15-41-11-greenshot.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/5I1OzADThBGnyAKn-2025-07-02-15-41-11-greenshot.png)

<span style="font-weight: 400;">Configure la opción homologación de datos:</span>

- <span style="font-weight: 400;">A continuación, asocie los **departamentos y municipios** según corresponda.</span><span style="font-weight: 400;">  
      
    [![depart.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/w1ngWDdP2xL8ApDz-depart.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/w1ngWDdP2xL8ApDz-depart.png)  
    </span>
- <span style="font-weight: 400;">A continuación, asocie cada uno de los **tipos de inmuebles** según sea el caso: Seleccione de la lista de la columna izquierda el valor similar correspondiente al valor en nuby en la columna derecha.</span>

[![inm.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/89y9VUhKzer8lkof-inm.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/89y9VUhKzer8lkof-inm.png)

- <span style="font-weight: 400;">**Asocie las características de nuby con Finca Raíz**: Seleccione de la lista de la columna de nuby el campo que más se adecue a las características correspondientes a la columna de Finca Raíz.</span>

[![carac.png](https://docs.nuby.ai/uploads/images/gallery/2025-07/scaled-1680-/zYoaHLkcRoTi1UXG-carac.png)](https://docs.nuby.ai/uploads/images/gallery/2025-07/zYoaHLkcRoTi1UXG-carac.png)

1. <span style="font-weight: 400;">Configure los parámetros adiciones para la integración. </span>Relacione los valores definidos por Finca Raíz y compararlos con los posibles valores en Arrendasoft.

<span style="font-weight: 400;">  
![](https://clientes.interservicios.co/index.php?rp=/images/kb/439_image10.png)</span>

<span style="font-weight: 400;"> **NOTA:** Todo el listado de características disponibles en nuby pueden ser creadas y configuradas en el módulo de configuración de propiedades. Usted puede acceder a esta herramienta por medio de la siguiente ruta: **Herramientas &gt; Configuraciones &gt; Propiedades.**</span>

**Proceso para la publicación de las propiedades.**

<span style="font-weight: 400;">1. Acceda al módulo de propiedades.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/442_image2.png)</span>

<span style="font-weight: 400;">2. Seleccione la propiedad desde la casilla circular que se encuentra en el costado izquierdo de cada registro de la tabla y de clic en el botón editar propiedades.</span>

<span style="font-weight: 400;">**![](https://clientes.interservicios.co/index.php?rp=/images/kb/443_image7.png)**</span>

<span style="font-weight: 400;">3. Seleccione la opción integración con portales.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/444_image15.png)</span>

<span style="font-weight: 400;">4. En el formulario usted podrá observar que nuby completa de manera automática los campos utilizando la homologación de datos que usted ya configuró. Si usted lo desea puede modificar los valores de manera manual.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/445_image20.png)</span>

<span style="font-weight: 400;">5. Publicar la propiedad.</span>

<span style="font-weight: 400;">Para publicar la propiedad debe presionar el botón PUBLICAR EN FINCA RAÍZ, aunque en ocasiones no está de más presionar sobre el botón ACTUALIZAR DATOS, esta opción guarda la nueva configuración en la base de datos para futuras publicaciones. Tenga en cuenta que las modificaciones realizadas en este formulario pueden ser sobrescritas si la propiedad es actualizada. El sistema puede tardar unos minutos mientras se realiza la primera publicación.</span>

<span style="font-weight: 400;">Notaremos que al finalizar este proceso los textos de los botones se actualizarán y además contaremos con una nueva opción. Estos cambios se describen a </span><span style="font-weight: 400;">continuación:</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/446_image18.png)</span>

- **ACTUALIZAR DATOS:**<span style="font-weight: 400;"> Permite guardar las configuraciones predeterminadas del formulario de integración con portales, como se mencionó anteriormente estos valores pueden ser sobrescritos con la actualización de la propiedad.</span>
- **ACTUALIZAR EN FINCA RAÍZ:**<span style="font-weight: 400;"> Con esta opción usted puede manualmente actualizar los datos en el portal de Finca Raíz.</span>
- **ELIMINAR DE FINCA RAÍZ:** Como su nombre lo indica permite dar de baja la publicación del inmueble en Finca Raíz, este caso la propiedad simplemente es retirada pero no se elimina totalmente, en su lugar se guarda en la papelera y cuando es publicada nuevamente se recupera, este proceso puede tener diferentes datos, pero conserva el mismo ID de publicación.

**Nota:** <span style="font-weight: 400;">Debe recordar que a partir del punto 1.4 del presente documento se explica cómo se deben publicar las propiedades manualmente, cuyo proceso no es necesario realizar en caso de que el parámetro de publicación automática se encuentre habilitado.</span>

**Recomendaciones:**

1. <span style="font-weight: 400;">Si esta es su primera vez publicando propiedades en el portal de Finca Raíz abstenerse de realizar la publicación automática debido a que si no se establece una buena homologación de los datos puede tener problemas al momento de ver las propiedades en el portal e incluso la información publicada puede que no sea la que usted desea.</span>
2. <span style="font-weight: 400;">Finca Raíz posee un indicador de calidad que muestra en porcentaje la rentabilidad del aviso publicado, este se determina de acuerdo a la cantidad de información que usted publique del inmueble. Para ello a continuación indicamos las recomendaciones de características mínimas.</span>

<span style="font-weight: 400;">A). **Cantidad de fotografías.**</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/447_image19.png)

<span style="font-weight: 400;">B). </span>**Características (Interiores, Exteriores y del sector) (3)**

**![](https://clientes.interservicios.co/index.php?rp=/images/kb/448_image14.png)**

**![](https://clientes.interservicios.co/index.php?rp=/images/kb/449_image13.png)**

<span style="font-weight: 400;">C). </span>**Antigüedad (SI)**<span style="font-weight: 400;"> </span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/450_image22.png)</span>

<span style="font-weight: 400;">3. Tener una buena homologación de los datos es la base para tener éxito al momento de realizar las publicaciones, por ello le recomendamos tomarse su tiempo en realizar esta configuración.</span>

<span style="font-weight: 400;">4. Recuerde que el equipo de soporte de **Interservicios S.A.S.** está disponible para resolver cualquier duda o dificultad que se le presente en el proceso.</span>

# ¿Cómo crear integración con Mercado Libre?

**Integración con Mercado Libre.**

<span style="font-weight: 400;">A continuación explicaremos todos los pasos para integrar, configurar y usar el portal de </span><span style="font-weight: 400;">Mercado Libre desde el software de Arrendasoft ®, en este documento encontrará todo lo que usted necesita saber para el uso práctico del módulo de Mercado Libre, explicaremos detalladamente cómo debe configurar el sistema, homologar los datos para la sincronización con Mercado Libre y cómo debe hacer las publicaciones en dicho portal, al final daremos unas recomendaciones que le ayudarán a obtener el mayor provecho de este servicio.</span>

<span style="font-weight: 400;">Antes de continuar con la lectura tenga en cuenta que los siguientes requisitos son necesarios para el desarrollo de cada uno de los pasos indicados en el documento actual.</span>

**Requisitos mínimos para la integración de portales.**

1. <span style="font-weight: 400;">La integración con Mercado Libre solo está disponible a partir de la versión 2.4.1.</span>
2. <span style="font-weight: 400;">Debe tener una cuenta con acceso al portal de Mercado Libre (usuario y contraseña).</span>
3. Debe contar con un con Usuario y Clave de seguridad para la sincronización, si no conoce estos datos por favor contactar con el área de soporte de Interservicios S.A.S donde le brindaremos los datos correspondientes.

**Paso 1:** <span style="font-weight: 400;">Acceda a la información hacemos clic en Herramientas y luego en la opción Configuraciones.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/787_image10.png)</span>

**Paso 2:** <span style="font-weight: 400;">Seleccione la opción integración portales.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/788_IntegracionPortal.png)</span>

**Paso 3:** <span style="font-weight: 400;">Active integración con portales.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/789_activar.png)</span>

<span style="font-weight: 400;">Valide que la opción activar integración con portales esté en SÍ.</span>

**Paso 4:** <span style="font-weight: 400;">Configure Integración de portales.</span>

1. <span style="font-weight: 400;">Configurar datos.</span>

- <span style="font-weight: 400;">Haga clic en la opción configurar datos del menú de Mercado Libre ubicado en la parte lateral izquierda.  
    </span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/790_cofig.png)</span>

- <span style="font-weight: 400;">Configure los datos para la integración: para esto debemos diligencias los 3 primeros campos (Activar integración, App ID y Secret Key) y hacer clic en el botón “guardar cambios”, la con los datos guardados procedemos a hacer clic en el botón “pedir token” que se autenticará con la API y completará los campos faltantes.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/791_Configuracion.png)</span>

<span style="font-weight: 400;">Después de pedir el token, el formulario aparecerá de la siguiente manera:</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/792_token.png)</span>

<span style="font-weight: 400;">A partir de este momento la API de mercado libre mantendrá actualizado el token en el sistema y si en algún momento deseamos removerlo sólo es necesario hacer clic en el botón “remover token”.</span>

<span style="font-weight: 400;">**Nota importante:** los valores de **App ID** y **Secret Key** se generan en la plataforma de Mercado Libre, puede consultar esta [guía](https://developers.mercadolibre.com.ar/es_ar/crea-una-aplicacion-en-mercado-libre-es "Guía para creación de aplicaciones en Mercado Libre").</span>

<span style="font-weight: 400;">2. Datos de usuario.</span>

- <span style="font-weight: 400;">Haga clic en la opción datos de usuario del menú de Mercado Libre ubicado en la parte lateral izquierda.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/793_usuario.png)</span>

- <span style="font-weight: 400;">En esta sección el sistema nos muestra la información del usuario que tenemos configurado o estamos usando para la integración.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/794_datosUsuario.png)</span>

<span style="font-weight: 400;">3. Homologación de datos.</span>

- <span style="font-weight: 400;">Haga clic en la opción homologación de datos del menú de Mercado Libre ubicado en la parte lateral izquierda.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/795_homologacionDatos.png)</span>

- <span style="font-weight: 400;">En esta sección el sistema nos brinda la opción de realizar todas las homologaciones necesarias para poder realizar la integración con el portal, esta homologación se compone de las siguientes secciones:</span>

<span style="font-weight: 400;">1. Sincronización de base de datos: este botón que solo está habilitado para los usuarios de interservicios, permite sincronizar la información de tipos de propiedad, tipos de servicio, departamentos, municipios, barrios y características de propiedades. Es importante anotar que esta operación solo se hace eventualmente ya que la base de datos donde se almacena la información es única y es compartida para todas las instancias.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/796_sincronizar.png)</span>

<span style="font-weight: 400;">2. Tipos de inmuebles: en esta sección podremos mapear todos los tipos de propiedades de Arrendasoft con Mercado Libre; cuando seleccionamos una opción de mapeo, el sistema muestra en la tercera columna el servicio o servicios que tiene disponible dicho tipo de inmueble.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/797_tiposInmuebles.png)</span>

<span style="font-weight: 400;">3. Parámetros: el sistema cuenta con 2 parámetros que son homologación y publicación automática.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/798_parametrosSincronizacion.png)</span>

- <span style="font-weight: 400;">¿Homologación automática? Seleccionamos esta opción si queremos que el sistema homologue automáticamente las </span><span style="font-weight: 400;">características de las propiedades, de ser el caso, se ocultarán en el formulario de integración.</span>
- <span style="font-weight: 400;">¿Publicación automática? Seleccionamos esta opción si queremos que el sistema publique automáticamente las propiedades, de ser el caso, se ocultará los botones de acciones en el formulario de integración.</span>

<span style="font-weight: 400;">4. Datos de contacto: podremos gestionar la información de contacto que será enviada a la plataforma de Mercado Libre.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/799_Contacto.png)</span>

<span style="font-weight: 400;">5. Atributos: en esta sección contamos con una tabla en la que en las columnas de la izquierda tenemos la información de Mercado Libre, luego tenemos la columna para relacionar con Arrendasoft y por último una columna de opciones que solo aplica para las características del tipo “boolean” y “list”.  
Las características están agrupadas por tipo de inmueble y tipo de servicio, es por ello que pareciera que se repiten.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/800_asociar.png)</span>

<span style="font-weight: 400;">Cuando seleccionamos la característica en Arrendasoft y estamos hablando de una de tipo “boolean” o list”, el engranaje de opciones se habilita y muestra un cuadro así:</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/801_homologacionopciones.png)</span>

<span style="font-weight: 400;">Debemos indicar qué valor de Mercado Libre se va a enviar de acuerdo a una operación lógica y un valor en Arrendasoft.</span>

**Paso 5:** <span style="font-weight: 400;">Acciones sobre las propiedades.</span>

<span style="font-weight: 400;">Para el caso de este manual, vamos a trabajar con la homologación automática y publicación automática desactivadas con el fin de tener toda la información visible.</span>

<span style="font-weight: 400;">Primero debemos crear la propiedad con su respectiva información y a partir de ahí el sistema nos habilitará otras pestañas dentro del formulario de creación y edición.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/802_datosPropiedad.png)</span>

<span style="font-weight: 400;">Cuando ingresamos a editar propiedad, por defecto se ubica en la primera pestaña de datos de la propiedad, pero cuando hacemos clic en la pestaña “integración portales” que solo se activa cuando tenemos en “si” la integración de portales, se nos muestra por bloques cada una de las integraciones activas.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/803_caracteristicasPrincipales.png)

<span style="font-weight: 400;">Como podemos ver en la imagen, nos muestra un formulario con todas las variables que pueden ser enviadas al portal de acuerdo al tipo de propiedad y tipo de servicios, los campos son de tipo texto, numérico, lista de selección o caja de selección, y los requeridos tienen un asterisco rojo (</span><span style="font-weight: 400;">\*</span><span style="font-weight: 400;">).</span>

<span style="font-weight: 400;">Al final del formulario tendremos unos botones que dependen de los siguientes casos: cuando la propiedad aún no se ha publicado en el portal tenemos 2 botones: uno para guardar los datos homologados y otro para publicar la propiedad.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/804_guardarDatos.png)</span>

<span style="font-weight: 400;">Cuando ya la propiedad está publicada, nos muestra otros botones que son para guardar los datos homologados, actualizar la propiedad en el portal o finalizar (es algo así como despublicar o inactivar).</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/805_finalizar.png)</span>

<span style="font-weight: 400;">Es importante anotar que cada botón muestra sus respectivas alertas de éxito o de error con la información necesaria para el usuario.</span>

# ¿Cómo crear la integración con Metro cuadrado?

**Manual de uso de la integración con el portal Metro Cuadrado.**

  
**Introducción.**

<span style="font-weight: 400;">A continuación explicaremos todos los pasos para integrar, configurar y usar el portal de Metro Cuadrado desde el software de Arrendasoft ®, en este documento encontrará todo lo que usted necesita saber para el uso práctico del módulo, explicaremos detalladamente cómo debe configurar el sistema, homologar los datos para la sincronización con el portal y cómo debe hacer las publicaciones, al final daremos unas recomendaciones que le ayudarán a obtener el mayor provecho de este servicio. Antes de continuar con la lectura tenga en cuenta que los siguientes requisitos son necesarios para el desarrollo de cada uno de los pasos indicados en el documento actual.</span>

<span style="font-weight: 400;">Requisitos mínimos para la integración de portales.</span>

1. <span style="font-weight: 400;"> Debe tener una cuenta con acceso al portal de Metro Cuadrado (usuario y contraseña).</span>
2. <span style="font-weight: 400;"> El usuario asignado por Metro Cuadrado debe tener habilitada la opción de “Integración”, en caso de no tener claro este estado consulte con su asesor, o la persona quien le entregó los datos de acceso al portal.</span>
3. <span style="font-weight: 400;"> Debe contar con nombre de usuario, contraseña, identificación y API KEY de seguridad para la sincronización, si no conoce estos datos por favor contacte con el asesor de Metro Cuadrado quien será el encargado de compartir dicha información. </span>

**Proceso de configuración.**

**Paso 1:** <span style="font-weight: 400;">Acceda a la sección haciendo clic en Herramientas y luego en la opción Configuraciones.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1315_ingresoherramientas.png)</span>

  
**Paso 2:** <span style="font-weight: 400;">Seleccione la opción integración portales.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1316_ingreso2herra.png)

**Paso 3:** <span style="font-weight: 400;">Busque y ubique en el menú lateral izquierdo la integración con Metro Cuadrado.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1317_submenu.png)</span>

**Paso 4:** <span style="font-weight: 400;">Active integración con portales.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1318_4.png)</span>

<span style="font-weight: 400;">Para realizar este paso debemos ir al elemento de menú “configurar datos” de la integración.</span>

<span style="font-weight: 400;">Cuando accedemos a la sección de “configurar datos” nos muestra un formulario con las variables a configurar para el portal.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1319_5.png)</span>

<span style="font-weight: 400;">Después de diligenciar la información necesaria en el formulario, procedemos a hacer clic en el botón “guardar” para guardar la información de configuración de la integración.</span>

<span style="font-weight: 400;">Las variables del formulario son:</span>

- *<span style="font-weight: 400;">Activar integración:</span>*<span style="font-weight: 400;"> solo cuando esta se activa, se puede usar desde la sección de propiedades para publicarlas en el portal.</span>
- *<span style="font-weight: 400;">Modo pruebas:</span>*<span style="font-weight: 400;"> cuando activamos esta opción es para usar la instancia de pruebas del portal, cuando está inactiva se usa la instancia de producción.</span>
- *<span style="font-weight: 400;">Publicación automática:</span>*<span style="font-weight: 400;"> cuando se activa esta opción, el sistema trata de hacer la publicación de las propiedades de forma automática, de lo contrario, los usuarios lo deben hacer de forma manual.</span>
- *<span style="font-weight: 400;">Nombre de usuario: </span>*<span style="font-weight: 400;">nombre de usuario para loguearse en el portal.</span>
- *<span style="font-weight: 400;">Contraseña: </span>*<span style="font-weight: 400;">contraseña para loguearse en el portal.</span>
- *<span style="font-weight: 400;">Identificación:</span>*<span style="font-weight: 400;"> Identificación del usuario para loguearse en el portal, suele ser el NIT de la inmobiliaria.</span>
- *<span style="font-weight: 400;">API Key:</span>*<span style="font-weight: 400;"> clave de seguridad para poder realizar la conexión con el portal.</span>

**Paso 5:** <span style="font-weight: 400;">Configure los agentes inmobiliarios.</span>

<span style="font-weight: 400;">Para acceder a esta sección, damos clic al elemento “agentes inmobiliarios” del menú lateral izquierdo de la integración.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1320_6.png)</span>

<span style="font-weight: 400;">Cuando accedemos al menú de agentes inmobiliarios nos carga un listado de usuarios del sistema con la opción de indicar una sucursal en el caso de ser necesario y un botón al final que realiza la acción de registrar.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1321_7.png)</span>

  
**Paso 6:** <span style="font-weight: 400;">Realice la homologación de datos.</span>

<span style="font-weight: 400;">Para acceder a esta sección debemos dar clic al elemento “homologación de datos” del menú lateral izquierdo de la integración.</span>

<span style="font-weight: 400;">Cuando accedemos a la sección, nos muestra 3 pestañas donde podremos realizar la homologación de departamentos y municipios, tipos de inmuebles y características de propiedades.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1322_8.png)</span>

  
  
**Homologación de departamentos y municipios.**

<span style="font-weight: 400;">Nos muestra 2 columnas, una de homologación (departamentos) y otra de subhomologación (municipios); el sistema inicialmente trata de hacer la homologación de forma automática aplicando algunos algoritmos de comparación e indica el porcentaje de similitud encontrado, ya el usuario manualmente puede terminar los que el sistema no pudo realizar o modificar si así lo requiere.</span>

<span style="font-weight: 400;">Es importante indicar que en cada una de las columnas la parte izquierda corresponde a valores de Arrendasoft y la derecha a campos tipo lista de selección para seleccionar los elementos o variables del portal con el cuál homologar.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1324_10.png)

**Homologación de tipos de inmuebles.**

<span style="font-weight: 400;">Nos muestra la homologación de tipos de inmuebles, donde inicialmente el sistema preselecciona las opciones que más se acercan y el usuario las puede complementar o ajustar.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1325_11.png)

**Homologación de características.**

<span style="font-weight: 400;">Para esta homologación contamos con un bloque de características donde para cada elemento de Arrendasoft se selecciona la opción o característica del portal con la que corresponde y, al hacer clic en cada elemento de Arrendasoft se muestra en el otro bloque de correspondencias la configuración para convertir los datos.</span>

<span style="font-weight: 400;">Para el caso de la imagen de ejemplo tenemos que para la característica “terraza” se indica que será homologada con el atributo “terrazaBalcon” del portal “metro cuadrado”, este atributo permite las opciones: ninguno, terraza o balcón, y por lo tanto se define una correspondencia donde si en Arrendasoft el campo es igual a “0” se enviará “ninguno” y si es igual a “1” se enviará Terraza.</span>

<span style="font-weight: 400;">Para la correspondencia contamos con los operadores más usados, como lo es igual, mayor, menor, entre.</span>

<span style="font-weight: 400;">Justo debajo de los campos de correspondencia hay un botón de “guardar” para guardar la información configurada.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1329_21.png)

**Nota importante:**<span style="font-weight: 400;"> después de hacer la homologación de las variables correspondientes, procedemos a hacer clic en el botón “guardar homologación” que se encuentra justo al final para guardar toda la configuración en la base de datos del sistema.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1328_13.png)

**Paso 7:** <span style="font-weight: 400;">Realice la asignación de parámetros. </span><span style="font-weight: 400;">Para acceder a esta sección debemos dar clic al elemento “asignación de parámetros” del menú lateral izquierdo de la integración.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1330_14.png)</span>

<span style="font-weight: 400;">Luego de acceder a la sección se mostrará un botón llamado “cargar parámetros” que al hacer clic sobre él, nos cargará toda la información de parámetros agrupada por pestañas.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1331_15.png)</span>

<span style="font-weight: 400;">Al cargar los parámetros la información viene agrupada por pestañas, al seleccionar cada pestaña podemos ver una tabla con las columnas: parámetro, valor, formato, obligatorio y guardar.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1332_16.png)

**Parámetro:**<span style="font-weight: 400;"> corresponde a una variable de Arrendasoft.</span>

**Valor:**<span style="font-weight: 400;"> es una variable del portal con la cuál se homologa el respectivo parámetro.</span>

**Formato:**<span style="font-weight: 400;"> corresponde al formato de la variable, texto, numérico, booleano (falso o verdadero), decimal, arreglo (vector con varios elementos, por ejemplo, el listado de imágenes).</span>

**Obligatorio:**<span style="font-weight: 400;"> indica si este parámetro es obligatorio.</span>

**Guardar:**<span style="font-weight: 400;"> botón para guardar toda la información configurada para el parámetro, es decir, para la fila.</span>

**Proceso de publicación.**

<span style="font-weight: 400;">Para el caso de este manual, vamos a trabajar con la publicación automática desactivada con el fin de tener toda la información visible.</span><span style="font-weight: 400;">Primero debemos crear la propiedad con su respectiva información y a partir de ahí el sistema nos habilitará otras pestañas dentro del formulario de creación y edición.</span><span style="font-weight: 400;">  
</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1334_17.png)

<span style="font-weight: 400;">Cuando ingresamos a editar propiedad, por defecto se ubica en la primera pestaña de datos de la propiedad, pero cuando hacemos clic en la pestaña “integración portales” que solo se activa cuando tenemos en “si” la integración de portales, se nos muestra por bloques cada una de las integraciones activas.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1335_18.png)</span>

<span style="font-weight: 400;">Como podemos ver en la imagen, nos muestra unos botones que dependen de los siguientes casos: cuando la propiedad aún no se ha publicado en el portal tenemos 1 botón: para publicar la propiedad.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1337_19.png)</span>

<span style="font-weight: 400;">Cuando ya la propiedad está publicada, nos muestra otros botones que son para actualizar la propiedad en el portal y despublicar.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1338_20.png)</span>

<span style="font-weight: 400;">Es importante anotar que cada botón muestra sus respectivas alertas de éxito o de error con la información necesaria para el usuario.</span>

# ¿Cómo crear la integración con Ciencuadras?

##### **Introducción**

<span style="font-weight: 400;">A continuación explicaremos todos los pasos para integrar, configurar y usar el portal de Ciencuadras desde el software de nuby®, en este documento encontrará todo lo que usted necesita saber para el uso práctico del módulo, explicaremos detalladamente cómo debe configurar el sistema, homologar los datos para la sincronización con el portal y cómo debe hacer las publicaciones, al final daremos unas recomendaciones que le ayudarán a obtener el mayor provecho de este servicio. Antes de continuar con la lectura tenga en cuenta que los siguientes requisitos son necesarios para el desarrollo de cada uno de los pasos indicados en el documento actual.</span>

##### **Requisitos mínimos para la integración de portales**

1. <span style="font-weight: 400;"> Debe tener una cuenta con acceso al portal de Ciencuadras (usuario y contraseña).</span>
2. <span style="font-weight: 400;"> El usuario asignado por Ciencuadras debe tener habilitada la opción de “Integración”, en caso de no tener claro este estado consulte con su asesor, o la persona quien le entregó los datos de acceso al portal.</span>
3. <span style="font-weight: 400;"> Debe contar con nombre de usuario y contraseña para la sincronización, si no conoce estos datos por favor contacte con el asesor de Ciencuadras o genérela siguiendo las instrucciones que se dan a continuación. </span>

##### **Proceso de generación de datos de integración**

Para que el sistema nuby se pueda conectar al portal Ciencuadras para publicar, despublicar y actualizar propiedades es necesario contar con un usuario y una contraseña de integración, el usuario es el mismo con el que la inmobiliaria ingresa al portal, y la contraseña se debe generar en esta misma plataforma.

A continuación se explica la generación de dicha contraseña:

1. Acceder al sitio web [https://ciencuadras.com](https://ciencuadras.com "Portal ciencuadras"), hacer clic en el botón ingresar, registrar los datos de acceso (correo electrónico y contraseña) y por último hacer clic en el botón "Iniciar sesión".  
      
    [![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/yLJ3wRP2q3G2W3o8-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/yLJ3wRP2q3G2W3o8-image.png)
2. Luego de loguearse, hacer clic en el ícono del usuario y luego en el menú "**Mis datos**".  
      
    [![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/grrpJlSIXn1Z651C-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/grrpJlSIXn1Z651C-image.png)
3. Estando en mi zona privada, nos encontramos con el botón "**Generar accesos integrador WS3**", el cual nos permitirá generar la contraseña de integración que necesitamos.  
      
    [![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/EbW24CVpDjhOhPBs-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/EbW24CVpDjhOhPBs-image.png)
4. Se nos abre un cuadro que nos muestra una corta notificación y un botón llamado "**Continuar**" que procedemos a hacerle clic.  
      
    [![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/AUqWYTpmzZjWfbFP-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/AUqWYTpmzZjWfbFP-image.png)
5. Al hacer clic en continuar nos mostrará la contraseña generada que deberá ser guardada de forma segura ya que no existe forma de consultarla en otro momento.

##### **Proceso de configuración**

**Paso 1:** <span style="font-weight: 400;">Acceda a la sección haciendo clic en Herramientas y luego en la opción Configuraciones.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1315_ingresoherramientas.png)</span>

  
**Paso 2:** <span style="font-weight: 400;">Seleccione la opción integración portales.</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1316_ingreso2herra.png)

**Paso 3:** <span style="font-weight: 400;">Busque y ubique en el menú lateral izquierdo la integración con Ciencuadras.</span>

[![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/5MAsP7JIOpAkl03F-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/5MAsP7JIOpAkl03F-image.png)

**Paso 4:** <span style="font-weight: 400;">Active integración con portales.</span>

[![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/Ns2WzCW1cjESPm2D-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/Ns2WzCW1cjESPm2D-image.png)

<span style="font-weight: 400;">Para realizar este paso debemos ir al elemento de menú “**Configurar datos**” de la integración.</span>

<span style="font-weight: 400;">Cuando accedemos a la sección de “**Configurar datos**” nos muestra un formulario con las variables a configurar para el portal.</span>

[![image.png](https://docs.nuby.ai/uploads/images/gallery/2025-04/scaled-1680-/KkoSCUYETdyDrrmJ-image.png)](https://docs.nuby.ai/uploads/images/gallery/2025-04/KkoSCUYETdyDrrmJ-image.png)

<span style="font-weight: 400;">Después de diligenciar la información necesaria en el formulario, procedemos a hacer clic en el botón “**Guardar**” para guardar la información de configuración de la integración.</span>

<span style="font-weight: 400;">Las variables del formulario son:</span>

- ***Activar integración:***<span style="font-weight: 400;"> solo cuando esta se activa, se puede usar desde la sección de propiedades para publicarlas en el portal.</span>
- ***Modo pruebas:***<span style="font-weight: 400;"> cuando activamos esta opción es para usar la instancia de pruebas del portal, cuando está inactiva se usa la instancia de producción.</span>
- ***Publicación automática:***<span style="font-weight: 400;"> cuando se activa esta opción, el sistema trata de hacer la publicación de las propiedades de forma automática, de lo contrario, los usuarios lo deben hacer de forma manual.</span>
- *<span style="font-weight: 400;">**Nombre de usuario:** </span>*<span style="font-weight: 400;">nombre de usuario para loguearse en el portal.</span>
- *<span style="font-weight: 400;">**Contraseña:** </span>*<span style="font-weight: 400;">contraseña para loguearse en el portal.</span>

**Paso 5:** <span style="font-weight: 400;">Realice la homologación de datos.</span>

<span style="font-weight: 400;">Esta homologación se hace exactamente igual a como lo hacemos con el portal Metrocuadrado, para consultarlo podemos hacer clic [aquí](https://docs.nuby.ai/books/herramientas/page/como-crear-la-integracion-con-metro-cuadrado "¿Cómo crear la integración con Metro cuadrado?").</span>

**Paso 6:** <span style="font-weight: 400;">Realice la asignación de parámetros.</span>

<span style="font-weight: 400;">Esta asignación se hace exactamente igual a como lo hacemos con el portal Metrocuadrado, para consultarlo podemos hacer clic [aquí](https://docs.nuby.ai/books/herramientas/page/como-crear-la-integracion-con-metro-cuadrado "¿Cómo crear la integración con Metro cuadrado?").</span>

##### **Proceso de publicación**

<span style="font-weight: 400;">Para el caso de este manual, vamos a trabajar con la publicación automática desactivada con el fin de tener toda la información visible. </span><span style="font-weight: 400;">Primero debemos crear la propiedad con su respectiva información y a partir de ahí el sistema nos habilitará otras pestañas dentro del formulario de creación y edición.</span><span style="font-weight: 400;">  
</span>

![](https://clientes.interservicios.co/index.php?rp=/images/kb/1334_17.png)

<span style="font-weight: 400;">Cuando ingresamos a editar propiedad, por defecto se ubica en la primera pestaña de datos de la propiedad, pero cuando hacemos clic en la pestaña “**Integración portales**” que solo se activa cuando tenemos activa en “**SI**” la integración de portales, se nos muestra por bloques cada una de las integraciones activas.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1335_18.png)</span>

<span style="font-weight: 400;">Como podemos ver en la imagen, nos muestra unos botones que dependen de los siguientes casos: cuando la propiedad aún no se ha publicado en el portal tenemos un botón para publicar la propiedad.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1337_19.png)</span>

<span style="font-weight: 400;">Cuando ya la propiedad está publicada, nos muestra otros botones que son para actualizar la propiedad en el portal y despublicar.</span>

<span style="font-weight: 400;">![](https://clientes.interservicios.co/index.php?rp=/images/kb/1338_20.png)</span>

<span style="font-weight: 400;">Es importante anotar que cada botón muestra sus respectivas alertas de éxito o de error con la información necesaria para el usuario.</span>