Ciclo de vida
Qué le pasa a una propiedad desde que la envía hasta que deja de estar publicada en Spot2.
Estados posibles
| Estado | Qué significa para usted |
|---|---|
| Nueva | La propiedad aparece por primera vez en su feed. |
| Modificada | La propiedad ya existe pero alguno de sus datos cambió (precio, descripción, fotos, etc.). |
| Sin cambios | La propiedad ya existe y no cambió ningún dato desde la última sincronización. |
| Desactivada | Su external_id apareció en el endpoint /properties/deleted. |
| Resucitada | La propiedad fue desactivada pero volvió a aparecer en el feed principal. |
Cuándo se publica una propiedad
Una propiedad se publica cuando:
- Es nueva y pasa todas las validaciones obligatorias.
- Es modificada y sigue pasando todas las validaciones.
Si la propiedad no pasa alguna validación, queda pendiente. Recibirá el detalle de los problemas en el webhook de retroalimentación.
Cuándo se desactiva una propiedad
Una propiedad se desactiva cuando su external_id aparece en el endpoint de eliminación (/properties/deleted). Esto indica que la propiedad fue dada de baja en su CRM y ya no debe estar publicada.
Spot2 consulta el endpoint de eliminación en cada ciclo de sincronización. La baja es inmediata: la propiedad se desactiva en el mismo ciclo.
La ausencia de una propiedad del feed principal nunca se interpreta como eliminación. Solo el endpoint de eliminados puede desactivar propiedades.
Más detalles en Protocolo de eliminación.
Cuándo se resucita una propiedad
Si una propiedad fue desactivada y luego vuelve a aparecer en su feed principal con el mismo external_id, se vuelve a publicar con los datos actuales. Pasa nuevamente por todas las validaciones antes de publicarse.
Si cambia el external_id, se trata como una propiedad nueva.
Seguridad ante fallos
El modelo incremental está diseñado para tolerar fallos:
- API devuelve vacío (bug temporal): Si Spot2 envía
updated_sincey su API responde con 0 items, no se elimina nada. La ausencia nunca es eliminación. - Timeout a mitad de paginación: El ciclo se marca como fallido. El próximo ciclo re-intenta desde la misma fecha — no se pierde información.
- Spot2 cae N días: Al volver, envía
updated_sincecon la fecha del último ciclo exitoso. Su API devuelve todos los cambios acumulados.