Protocolo de eliminación

El endpoint obligatorio para reportar propiedades eliminadas. Sin este endpoint, Spot2 no puede detectar bajas y las propiedades eliminadas seguirán publicadas.

---

Endpoint

GET https://su-crm.com/api/v1/spot2/properties/deleted?since=2026-06-29T14:00:00Z

Parámetro	Obligatorio	Descripción
since	Sí (excepto primer ciclo)	ISO 8601. Devuelve IDs eliminados desde esta fecha. En el primer ciclo Spot2 no lo envía.

Autenticación

La misma que el endpoint principal de propiedades.

Formato de respuesta

{
  "deleted_ids": ["prop-001", "prop-002", "prop-005"],
  "since": "2026-06-29T14:00:00Z",
  "generated_at": "2026-06-30T10:00:00Z"
}

Campo	Tipo	Descripción
deleted_ids	string[]	external_id de propiedades eliminadas. Array vacío si no hay bajas.
since	ISO 8601	Eco del parámetro recibido.
generated_at	ISO 8601 opcional	Cuándo se generó la respuesta.

Retención

Su CRM debe retener el historial de eliminaciones al menos 30 días. Si since es más antiguo que su ventana de retención, devuelva todos los IDs eliminados que tenga disponibles.

Variantes del endpoint

El parámetro canónico es ?since=<ISO-8601>, pero otros nombres son aceptados. Spot2 se adapta al que su API use:

CRM / Estándar	Formato	Ejemplo
Canónico	?since=<ISO-8601>	GET /properties/deleted?since=2026-06-27T00:00:00Z
Tokko	?filter=deleted&date_from=<ISO-8601>	GET /properties?filter=deleted&date_from=2026-06-27T00:00:00Z
Otros	Configurable	Su propio formato

Variantes del endpoint

El parámetro canónico es ?since=<ISO-8601>, pero otros nombres son aceptados. Spot2 se adapta al que su API use:

CRM / Estándar	Formato	Ejemplo
Canónico	?since=<ISO-8601>	GET /properties/deleted?since=2026-06-27T00:00:00Z
Tokko	?filter=deleted&date_from=<ISO-8601>	GET /properties?filter=deleted&date_from=2026-06-27T00:00:00Z
Otros	Configurable	Su propio formato

Frecuencia

Spot2 consulta este endpoint en cada ciclo programado, con la misma frecuencia que el endpoint principal.

---

Flujo de un ciclo

1. Spot2 envía GET /properties/deleted?since=<último_ciclo_exitoso>.
2. Su API devuelve los external_id eliminados desde esa fecha.
3. Spot2 procesa la lista y desactiva esas propiedades.
4. Si el ciclo falla (timeout, 500), Spot2 no actualiza el since. El próximo ciclo re-intenta desde la misma fecha — no se pierde información.
5. Si su API devuelve "deleted_ids": [], no hay bajas. Spot2 guarda el timestamp actual como since para el próximo ciclo.

Eliminación parcial

Si una propiedad tiene renta y venta, y solo se elimina una operación:

• No la reporte en deleted_ids.
• Actualice la propiedad en el feed principal con la modalidad corregida (ej: de rent_and_sale a sale).
• Spot2 actualiza la modalidad sin desactivar la propiedad.

---

Timeout y rate limits

Timeout: 30 segundos. Rate limit: respetamos Retry-After.