UPS Quantum View Integration: Account-Level Package Visibility

January 28, 2026 · 4 min read

Principal Software Engineer

This guide covers how to implement UPS Quantum View for account-level inbound package visibility, allowing you to see all packages being delivered to your locations without needing individual tracking numbers.

Overview

UPS offers two main services for inbound visibility, each with different trade-offs:

Service	Vendor Coordination	See ALL Packages	API Available
Quantum View Inbound	Required (must send LID)	Only packages with LID	Yes
UPS My Choice for Business	Not required	Yes	No (web only)

Quantum View Products

Quantum View Manage vs Quantum View Data

Feature	Quantum View Manage	Quantum View Data
Type	Web portal (interactive)	File-based data delivery
Access	Login to ups.com dashboard	Download files or API
Formats	Web UI	CSV, Flat File (TXT), XML, EDI
Updates	Real-time in portal	Hourly file updates
Automation	Manual viewing	Fully automatable
Cost	Free	Free

Location ID (LID) Setup

What is a Location ID?

A Location ID is a unique 3-10 alphanumeric identifier that you create and share with your vendors. When vendors include this LID in their shipments, UPS provides visibility to those packages in your Quantum View Inbound dashboard.

Creating a Location ID

Log in to UPS.com
Navigate to Company Administration → Manage Company Services
Click Create next to Inbound Location IDs
Enter a 3-10 alphanumeric value

API Integration

LocationID Field in Shipping API

The Location ID is included in the ShipTo element when creating shipments:

Path: ShipmentRequest → Shipment → ShipTo → LocationID

{
  "ShipmentRequest": {
    "Shipment": {
      "ShipTo": {
        "Name": "Store Name",
        "AttentionName": "Receiving Dept",
        "Address": {
          "AddressLine": ["123 Store St"],
          "City": "Chicago",
          "StateProvinceCode": "IL",
          "PostalCode": "60601",
          "CountryCode": "US"
        },
        "LocationID": "STORE001"
      }
    }
  }
}

Field Specifications

Aspect	Value
Parent Element	`ShipTo`
Field	`LocationID`
Required	Optional
Format	3-10 alphanumeric characters
Purpose	Enables Quantum View Inbound visibility

Quantum View API

The Quantum View API allows you to retrieve shipment events programmatically:

Aspect	Details
Endpoint	developer.ups.com/api/quantum-view
Auth	OAuth 2.0
Model	Pull (polling) - returns unread events
History	Up to 7 days
Data Limit	150KB per request, pagination via bookmarks

Event Types

UPS Event	Description
Manifest (M1/M2)	Label created
Origin Scan (O1)	Package picked up
Generic Activity (G1)	Voided packages
Exception (E1)	Delivery exceptions
Delivery (D1/D2)	Package delivered

Vendor Instructions

When communicating with vendors, provide the following information:

For UPS WorldShip / CampusShip / Internet Shipping Users

When shipping to our locations, enter our Location ID in the Location ID field of your UPS shipping system.

Location ID: [YOUR_LID_HERE]

This field is found in the recipient/ship-to section of your shipping interface.

For API Integration Users

Include the LocationID field in the ShipTo element of your ShipmentRequest:
"ShipTo": {
  "LocationID": "[YOUR_LID_HERE]"
}

Alternative Approaches

Consignee Billing Subscription

If packages are billed to the receiving location (consignee billing), you can use the Alternate Billing subscription to see those packages without requiring vendors to include a Location ID.

UPS Quantum View Integration: Account-Level Package Visibility

Overview