UPS tracking

UPS supports both tracking known shipment numbers and discovering shipments through Quantum View Data. Both integrations use the customer's own UPS OAuth application credentials.

Setup

1. In UPS Developer Portal, give the customer's application access to Tracking and Quantum View. Ensure its UPS account is associated with the application.
2. In Scope, open Data → Transporters → UPS → Settings. Save the Client ID and Client Secret and add the customer's UPS account number. Credentials are encrypted in the existing retailer credential store.
3. For known tracking numbers supplied by a WMS, use the normal order/shipment tracking API. UPS is polled through the existing tracking scheduler when the organization has no enabled Quantum View subscription. A saved but disabled subscription does not suppress polling.
4. For automatic discovery, first create a Quantum View Data subscription with UPS. API permissions alone do not create this subscription. In Scope, select the customer number and leave the subscription name blank to retrieve all subscriptions accessible to the saved credentials. Optionally enter an exact subscription name to restrict retrieval. No inbound/outbound selection is required.
5. Choose the reference field used for order matching, and the timezone for timestamps without a UPS offset. Save the subscription; it starts disabled. A Skrym administrator can enable it once the UPS-side setup is complete.

Choosing the event source

An enabled Quantum View subscription selects Quantum View for all UPS shipments in that organization, including shipments supplied by a WMS. The enabled feeds must cover the organization’s UPS accounts and required directions. These shipments are excluded when the scheduled polling job selects its next batch.

Disabling the last enabled Quantum View subscription restores normal polling eligibility for existing and new shipments.

Order references and shipment identity

The default order reference is the first shipment-level UPS reference. Choose package-level references or filter by UPS reference position and/or code when your WMS stores its order identifier elsewhere. If no matching reference exists, the package tracking number is used. For a manifest grouping multiple packages, the first package supplies the package-level order reference.