UPS - Track Shipment

Description

This module queries the tracking status of a shipment in UPS using the tracking number. It makes a GET request to the /api/track/v1/details/{tracking_number} endpoint. It processes the response to extract the current status (description, type, and code), estimated delivery date, service used, weight, and the complete event history with date, time, description, status type, code, city, state, and country.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	UPS credential (provider: ups)
tracking_number	text	Yes	UPS shipment tracking number

Credentials

A ups type credential is required with the following fields:

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

Output

{
  "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"
}

Usage Example

Basic case

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

API Used

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

Notes

The first shipment and first package from the response are used
The last event (activity[0]) is used as the current status
Dates are returned in YYYYMMDD format and times in HHMMSS format