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.
Tipos de propiedad que aceptamos:
- Oficinas
- Locales comerciales
- Bodegas y naves industriales
- Terrenos comerciales e industriales
- Edificios completos
- Locales en centro comercial
Cómo funciona
Spot2 consulta su API en ciclos programados (típicamente cada hora):
- Feed de propiedades —
GET /properties?updated_since=.... Su CRM devuelve las propiedades activas modificadas desde esa fecha. - Feed de eliminados —
GET /properties/deleted?since=.... Su CRM devuelve los IDs de propiedades dadas de baja. - Validamos cada propiedad contra las reglas de calidad (severidades BLOCK, DRAFT, WARN).
- Publicamos las que pasan en el marketplace de Spot2.
- Le notificamos el resultado vía webhook (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 sus propiedades activas en JSON, 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 publicación y rechazo (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, HMAC, TLS.
- Reglas de validación: reglas de calidad y sus mensajes.
- Ejemplos: casos concretos.
- Changelog: cambios al contrato.