Este artículo tiene como finalidad explicar el funcionamiento de las integraciones de CRMs, ERPs y otras plataformas que administran inventario de proyectos inmobiliarios de modo tal que tu equipo de desarrollo comprenda los requerimientos necesarios para llevar a cabo con éxito una integración de una API REST.

1. Si lo que desean es integrar la API de hauzd, haz click aquí.
   
2. Si tu pregunta no se encuentra aquí, por favor, envía tus inquietudes por email a Gonzalo Abel Hourcade | Backend Lead Dev, o bien contacta a tu representante de ventas o Project Manager en hauzd.
   

Objetivo de la integración entre hauzd y el CRM/ERP:

El objetivo es evitar que el cliente deba mantener actualizada la misma lista de precios (el inventario del proyecto) en más de un sitio y que solo lo haga desde su propio CRM/ERP/Plataforma. Siendo capaz de sincronizar todos los campos y atributos de un apartamento/casa/lote/oficina que el cliente desee sincronizar. Ejemplo: metrajes, número de habitaciones, número de baños, Precio y status (disponible, reservado, vendido).

¿Cómo funciona la integración de inventario en hauzd?

Cuando un proyecto está integrado, se ejecuta un proceso cada 15 minutos. En este proceso se pide a la API/Webservice de la plataforma integrada el inventario (también conocido como lista de precios) para sincronizarla con las unidades creadas el Showroom 3D en hauzd, las cuales previamente son mapeadas en nuestro Admin Panel.

hauzd necesita obtener un listado JSON (vía Curl) con todas las unidades del proyecto y que cada unidad contenga todos los campos que el cliente desee sincronizar con el Showroom 3D de hauzd. El resto del trabajo corre por cuenta de hauzd (mapeo de campos, valores del campo de estado comercial, mapeo de unidades, etc.).

A modo ejemplo, el JSON debería tener la siguiente estructura:

Los nombres de las propiedades de cada objeto puede venir con cualquier nombre mientras sea correspondiente (descriptivo) al dato que va a traer. Ej: “baths” podría ser “banios” o “cant_banios”.

¿Qué se requiere para el desarrollo de esta integración?

Para sincronizar el inventario desde una plataforma custom o CRM/ERP necesitamos que dicha plataforma cuente con una API REST o Webservice que nos pueda brindar un listado JSON con todas las unidades por proyecto (Por ende, que se pueda filtrar de qué proyecto se solicita) y con todos los campos que el cliente quiera sincronizar (metrajes, precio, estado comercial, etc).

Es necesario que nos brinden de manera técnica y específica un ejemplo de cómo obtener el inventario en el cual se detallen las URLs y los parámetros a enviar. También necesitamos una lista de valores posibles para el campo de “status” o “estado comercial”, para así mapearlos con los nuestros (Unreleased, Sold, Available, Reserved).

¿Cómo se mapean los campos, valores de estado y las unidades?

Los campos y las unidades las mapeamos en nuestro Admin Panel con un campo llamado crmId, en el cual generalmente llenamos con la nomenclatura tal cual provenga desde el CRM/ERP a integrar.

Con el proyecto integrado, podemos ver cuántas unidades hay mapeadas y también configurar el mapeo de campos y el mapeo de valores de campos como status (estado comercial).

Las imágenes a continuación explican a modo de ejemplo como se visualiza en el Admin Panel:

La sincronización siempre se ejecutará cada intervalos de 15 minutos y no es posible reducir el intervalo. De igual modo, en el Admin Panel disponemos de un botón para ejecutar de forma manual la integración con solo hacer click en “Sync” ( botón amarillo que aparece en la imagen superior) en caso de ser necesario.

¿La integración es bi-direccional?

No, la sincronización del inventario es únicamente desde el CRM,ERP o plataforma hacía hauzd. Si usted realiza cambios en la lista de precios desde nuestro Admin Panel y el proyecto se encuentra integrado, todo lo que esté mapeado se sobreescribirá en la siguiente ejecución de la integración con la información proveniente de la plataforma integrada. Por el momento la integración NO es bi-direccional.