Set up UPS Unlock
-
Contact Zonos support - Before enabling UPS Unlock, reach out to Zonos Support to ensure your UPS account is configured correctly. This process typically takes 24-48 hours to complete.
-
Enable UPS Unlock in Dashboard - Go to Zonos Dashboard → Settings → Rates → UPS and toggle UPS Unlock to Enable
-
Configure your reference numbers - To enable UPS Unlock, your shipping platform must support adding reference numbers with the zx prefix and must include a Zonos order ID or account order number in the UPS reference fields:
- Required: At least one reference number must contain your Zonos order ID or account order number
- As long as at least one of your reference numbers starts with
zx
(even if the value is onlyzx
), Zonos will scan all reference numbers to find matching Zonos order IDs or account order numbers - Examples:
- Reference 1:
zx
, Reference 2:ORDER123
- Reference 1:
zxORDER123
(combined format)
- Reference 1:
How it works
Once you have UPS Unlock set up, UPS shipments will reference Zonos order data. Here's how that process works:
- UPS automatically calls Zonos to validate the order with the reference fields provided
- Zonos validates and returns updated customs details to UPS - Zonos validates that the shipment matches the original quote by checking:
- Items in the shipment match those in the quote
- Quantities are less than or equal to the quoted amounts
- Part numbers match product IDs or SKUs from the quote
- Destination details (country/province) match the quote
- UPS processes your shipment with compliance information
- UPS calls Zonos to create shipment record with tracking number
- Zonos records the shipment on the order
UPS Unlock
Automate duty and tax billing to Zonos for UPS shipments processed outside of Dashboard.
UPS Unlock enables you to generate Zonos-compliant shipments from your own shipping platform, instead of using Zonos Dashboard. By adding a specific reference number when processing UPS shipments, UPS automatically validates and updates shipment data through Zonos, including customs descriptions, HS codes, duty account numbers, tax IDs, and commodity values.
This eliminates the need to configure complex rules or integrations to pass this information to your shipping platform. Instead, UPS retrieves the data directly from Zonos, reducing the risk of discrepancies or missing information while minimizing manual setup and maintenance time.