Retorna almacenes con conteo de zonas, slots totales y utilización general.

{
  "warehouses": [
    {
      "id": 1,
      "name": "Monterrey Hub",
      "location": { "lat": 25.6866, "lng": -100.3161 },
      "timezone": "America/Mexico_City",
      "zones": 5,
      "totalSlots": 120,
      "utilization": 72
    }
  ]
}

{
  "name": "Monterrey Hub",
  "location": { "lat": 25.6866, "lng": -100.3161 },
  "timezone": "America/Mexico_City",
  "floor_plan_image": "base64_or_url"
}

Retorna metadatos completos del almacén incluyendo todas las zonas, conteo de slots y desglose de utilización.

Actualizar nombre, ubicación, zona horaria o imagen del plano de planta.

Retorna zonas con conteo de slots, slots ocupados y utilización a nivel de zona.

{
  "zones": [
    {
      "id": 1,
      "name": "Zone A",
      "zone_type": "storage",
      "color": "#3b82f6",
      "warehouseId": 1,
      "totalSlots": 40,
      "occupiedSlots": 29,
      "utilization": 72.5
    }
  ]
}

{
  "name": "Zone A",
  "zone_type": "storage",
  "color": "#3b82f6",
  "warehouseId": 1
}

Retorna metadatos de la zona, todos los slots y analíticas a nivel de zona.

Actualizar nombre de la zona, tipo, color o asignación de almacén.

Retorna slots con estado de ocupación calculado desde el registro de eventos.

Retorna datos de series temporales para utilización de zona, eventos por hora y conteo de incidentes.

Soporta filtrado por zone, status (empty, occupied, verified) y paginación.

{
  "slot_id": "A-01-01",
  "zone": "A",
  "floor_plan_polygon": [
    { "x": 10, "y": 20 },
    { "x": 50, "y": 20 },
    { "x": 50, "y": 60 },
    { "x": 10, "y": 60 }
  ],
  "constraints": {
    "max_weight_kg": 5000,
    "max_height_m": 4.0,
    "allowed_types": ["pallet", "box"]
  }
}

Retorna metadatos del slot y estado derivado: isOccupied, assetBarcode, isVerified, lastEvent.

Actualizar polígono, restricciones o asignación de zona. No afecta el registro de eventos.

Retorna eventos cronológicos para un slot específico. Soporta paginación y filtrado por fecha.

Retorna activos con tipo, metadatos y ubicación actual (derivada de eventos).

{
  "asset_id": "PLT-2024-00042",
  "type": "pallet",
  "weight_kg": 1250,
  "dimensions": { "length": 120, "width": 100, "height": 15 }
}

Retorna metadatos del activo, ubicación actual e historial de colocación.

Retorna el slot actual donde el activo está colocado, derivado del registro de eventos.

Lista cronológica de todos los eventos de colocación y retiro para este activo.

{
  "event_type": "PLACED",
  "slot_id": 5,
  "asset_barcode": "PLT-2024-00042",
  "operator": "op-123",
  "photo_url": "https://cloud.example.com/evidence/photo.jpg",
  "scale_weight_kg": 1250,
  "cctv_clip_url": "https://cloud.example.com/clips/cam3-14h32.mp4",
  "work_order_ref": "WO-2025-001"
}

La respuesta incluye el evidence_hash SHA-256 del paquete de evidencias.

Soporta filtrado por slot_id, asset_barcode, event_type, operator, rango de fechas y paginación vía limit/offset.

Retorna el registro completo del evento incluyendo URLs de evidencia, hash y clips CCTV vinculados.

Retorna eventos dentro de una ventana temporal y límites de viewport. Selecciona automáticamente el modo de respuesta (crudo, agrupado o agregado) basándose en la densidad de datos.

{
  "totalSlots": 200,
  "occupiedSlots": 142,
  "utilizationPercent": 71,
  "pendingVerifications": 8,
  "byZone": [
    { "zone": "A", "occupied": 45, "total": 60, "utilization": 75 }
  ]
}

Retorna unidades procesadas por hora/día/semana con datos de tendencia.

Retorna incidentes abiertos agrupados por severidad y categoría.

Endpoint combinado que retorna utilización, rendimiento, incidentes y unidades de transporte activas.

Retorna todas las imágenes de planos de planta con conteo de slots por plano.

Acepta multipart/form-data con la imagen del plano y metadatos.

Retorna la URL de la imagen del plano y todas las definiciones de polígonos de slots asociados.

Soporta filtrado por status, stage, operator y priority.

Retorna el registro completo incluyendo historial de flujo de trabajo, elementos de evidencia y datos de peso.

{
  "type": "container",
  "operation": "import",
  "priority": "normal",
  "seal_number": "SEAL-2025-00042"
}

Valida que todos los requisitos de la etapa se cumplan antes de avanzar. Retorna errores de validación si está incompleto.