Panorama general

Spot2 Ingestion es el servicio que conecta su CRM con el marketplace de bienes raíces comerciales de Spot2. Nosotros consultamos su API, validamos sus datos, y publicamos las propiedades que cumplen con los requisitos de calidad.

---

Para quién es esto

CRM, portal inmobiliario, MLS, o plataforma de corredores que quiere publicar propiedades comerciales en Spot2. Propiedades residenciales no se publican.

Solo aceptamos estas 4 familias canónicas de property_type:

• office
• retail
• industrial
• terrain

Si su CRM maneja subtipos internos (por ejemplo edificios, bodegas, naves industriales o locales en centro comercial), debe normalizarlos a uno de esos 4 valores antes de exponer el feed.

---

Cómo funciona

Spot2 consulta su API en ciclos programados (típicamente cada hora):

1. Feed de propiedades — GET /properties?updated_since=.... Su CRM devuelve las publicaciones activas que el usuario marcó explícitamente para Spot2 y que fueron modificadas desde esa fecha.
2. Feed de eliminados — GET /properties/deleted?since=.... Su CRM devuelve los IDs de propiedades dadas de baja.
3. Validamos cada propiedad contra las reglas de calidad (severidades BLOCK, DRAFT, WARN; WARN solo aplica a amenidades faltantes).
4. Publicamos las que pasan en el marketplace de Spot2.
5. Le notificamos aceptación o rechazo vía webhook de Ingestion (si configuró uno).

Sin el endpoint de eliminados, las propiedades dadas de baja en su CRM seguirán publicadas. Todo el proceso es automático una vez integrado.

---

Qué necesita construir

#	Entregable	Obligatorio	Propósito
1	Endpoint GET /properties con updated_since	Sí	Exponer en JSON las publicaciones activas seleccionadas para Spot2, filtradas por fecha de modificación.
2	Endpoint GET /properties/deleted con since	Sí	Reportar IDs de propiedades eliminadas desde una fecha.
3	Endpoint POST /webhooks/spot2/feedback	No	Recibir notificaciones de aceptación para procesamiento y rechazo con mensajes en lenguaje natural.

Sin el webhook, sus propiedades se publican igual. Pero sin notificaciones de rechazo no sabe cuándo una propiedad falla ni por qué.

---

Documentos de referencia

• Inicio rápido: guía paso a paso.
• Esquema de propiedad: todos los campos, tipos y validaciones.
• Protocolo de sincronización: contrato de su endpoint de propiedades.
• Mecanismos de seguridad: protecciones contra feed vacío y eliminación masiva.
• Eliminación parcial: cómo manejar cambios de modalidad.
• Webhook de retroalimentación: cómo recibir notificaciones.
• Ciclo de vida: qué pasa con una propiedad a lo largo del tiempo.
• Protocolo de eliminación: contrato del endpoint de eliminados.
• Seguridad: autenticación, Bearer Token, TLS.
• Reglas de validación: reglas de calidad y sus mensajes.
• Ejemplos de integración: casos concretos.
• Changelog: cambios al contrato.