UPS - Rastrear Envío

Descripción

Este modulo consulta el estado de rastreo de un envío en UPS utilizando el número de seguimiento. Realiza una petición GET al endpoint /api/track/v1/details/{tracking_number}. Procesa la respuesta para extraer el estado actual (descripción, tipo y código), fecha estimada de entrega, servicio utilizado, peso y el historial completo de eventos con fecha, hora, descripción, tipo de estado, código, ciudad, estado y pais.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial UPS (provider: ups)
tracking_number	text	Si	Número de seguimiento del envío 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 básico

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

API Utilizada

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

Notas

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