Protocolo de eliminación

El endpoint obligatorio para reportar propiedades eliminadas o retiradas de la selección para Spot2. Sin este endpoint, Spot2 no puede detectar bajas y las propiedades eliminadas o retiradas 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"
}

Si no hay bajas, puede devolver un conjunto vacío:

{
  "deleted_ids": [],
  "since": null,
  "generated_at": "2026-07-24T15:40:43.143Z"
}

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

También puede responder 204 No Content; Spot2 lo interpreta como un conjunto vacío de eliminados.

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.

Contrato

El contrato estándar usa ?since=<ISO-8601> y devuelve deleted_ids, since y generated_at. El parámetro debe llamarse siempre since.

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 o retirados de Spot2 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 operativo estándar: hasta 300 segundos. Rate limit recomendado: al menos 60 requests por minuto para la credencial de Spot2.