Pular para o conteúdo principal

Obtener entregas disponibles para seguimiento GPS

GET 
/deliveries/trackable

Este endpoint devuelve una lista de entregas en curso que pueden ser seguidas mediante GPS en tiempo real.

Características principales:

  • Solo incluye entregas en estado 'collected' (recogidas pero no entregadas)
  • Excluye entregas asociadas a subastas
  • Proporciona información esencial para seguimiento:
    • Código de servicio único
    • Estado actual de la entrega
    • Direcciones completas de carga (ETL) y descarga (ETD)
    • Coordenadas geográficas si están disponibles
    • Última posición conocida del vehículo (si está disponible)

Casos de uso típicos:

  • Visualizar todas las entregas activas en el mapa del transportista
  • Seleccionar una entrega específica para iniciar seguimiento GPS
  • Verificar qué entregas están actualmente en ruta
  • Planificar rutas múltiples cuando hay varias entregas activas
  • Monitorear progreso de entregas en curso

Validaciones y restricciones:

  • Requiere autenticación JWT válida de transportista
  • Solo muestra entregas asignadas al transportista autenticado
  • Las entregas deben estar en estado 'collected' para aparecer
  • No incluye entregas completadas o canceladas
  • Máxima frecuencia de consulta: 1 vez por minuto

Ejemplo de flujo:

  1. Transportista inicia sesión en la app móvil
  2. La app consulta este endpoint periódicamente (cada 2-5 minutos)
  3. Se muestran las entregas activas en el mapa con su última posición
  4. El transportista selecciona una para iniciar seguimiento detallado

Notas técnicas:

  • Las coordenadas se devuelven en formato [longitud, latitud] (GeoJSON)
  • El estado 'collected' indica que la carga ha sido recogida pero no entregada
  • Las direcciones incluyen ciudad, código postal y provincia
  • La respuesta incluye cabecera X-Total-Count con el número total de entregas

Responses​

Lista de entregas disponibles para seguimiento GPS

Response Headers
    X-Total-Count

    Número total de entregas trackeables

    Example: 2
    X-RateLimit-Remaining

    Número de consultas restantes en el período actual

    Example: 58