UPS - Rastrear Envio

Descripcion

Este modulo consulta el estado de rastreo de un envio en UPS utilizando el numero de seguimiento. Realiza una peticion GET al endpoint /api/track/v1/details/{tracking_number}. Procesa la respuesta para extraer el estado actual (descripcion, tipo y codigo), fecha estimada de entrega, servicio utilizado, peso y el historial completo de eventos con fecha, hora, descripcion, tipo de estado, codigo, ciudad, estado y pais.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial UPS (provider: ups)
tracking_number	text	Si	Numero de seguimiento del envio UPS

Credenciales

Se requiere una credencial de tipo ups con los siguientes campos:

client_id: Client ID de la API de UPS
client_secret: Client Secret de la API de UPS

Salida

{
  "success": true,
  "tracking_number": "1Z999AA10123456784",
  "status": "In Transit",
  "status_type": "I",
  "status_code": "IT",
  "estimated_delivery": "20260325",
  "service": "UPS Standard",
  "weight": "2.5",
  "events": [
    {
      "date": "20260323",
      "time": "103000",
      "event": "Pickup Scan",
      "status_type": "I",
      "status_code": "PU",
      "city": "Madrid",
      "state": "MD",
      "country": "ES"
    }
  ],
  "message": "Estado: In Transit"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_ups",
  "tracking_number": "1Z999AA10123456784"
}

API Utilizada

Endpoint: GET /api/track/v1/details/{tracking_number}
Base: UPS API (via helper _upsHelper)
Documentacion: https://developer.ups.com/api/reference

Notas

Se toma el primer envio y primer paquete de la respuesta
El ultimo evento (activity[0]) se usa como estado actual
Las fechas se devuelven en formato YYYYMMDD y las horas en HHMMSS