This guide explains how to integrate UPS with Shipi to calculate live shipping rates, generate labels, and automate UPS shipments.
Go to Shipping Accounts
- Login to your Shipi dashboard
- Navigate to Carriers → Shipping Accounts
- Click Connect Account or Add Shipping Account
Select UPS
- In the Add New Shipping Account popup:
- Search for UPS, or
- Select UPS from the carrier list
- Click on UPS
Step 1: UPS Account Information
This section connects your UPS account with Shipi.
🔹 Shipping Account Name
| Value | Explanation |
|---|---|
| Any name | Internal reference only |
| Example | UPS– International, UPS – Domestic |
📌 Helps when managing multiple UPS accounts.
🔹 UPS Account Number
| Field | Explanation |
|---|---|
| UPS Account Number | Your official UPS billing account |
📌 Required for:
- Rate calculation
- Label generation
- Duty & tax handling
🔹 Client ID & Client Secret
| Field | Explanation |
|---|---|
| Client ID | Authenticates Shipi → UPS |
| Client Secret | Secures API communication |
📌 Generated from UPS Developer Portal.
Find the below link to find how to fetch these details from UPS Development Portal
🔹 Execution Mode
| Option | What It Means | When to Use |
|---|---|---|
| Live Mode | Real shipments | ✅ Production |
| Test Mode | Sandbox testing | ⚠️ Testing only |
📌 Always use Live Mode for real orders.
🔹 Enable Insurance
| Option | Meaning | Recommended |
|---|---|---|
| Yes | UPS insurance applied | ⚠️ High-value goods |
| No | No insurance | ✅ Most merchants |
🔹 UPS Weight and Dimension Unit
| Option | Meaning | Use When |
|---|---|---|
| KG_CM | Kilograms & centimeters | Most countries |
| LB_IN | Pounds & inches | US-based stores |
⚠️ Must match your UPS account region.
🔹 Vendor Collector Type (Very Important)
This tells UPS who collects VAT / tax.
| Code | Meaning | Country / Use Case |
|---|---|---|
| IOSS | Import One-Stop Shop | EU B2C under €150 |
| VOEC | VAT on E-Commerce | Norway |
| HMRC | UK tax authority | UK shipments |
| PVA | Postponed VAT Accounting | UK B2B |
📌 Most merchants:
- EU →
IOSS - UK →
HMRC - Others → follow UPS advice
🚫 Wrong selection = customs failure.
Shipper Address (Ship From Address)
The Shipper Address defines where UPS will pick up the shipment and what appears as the sender address on labels and customs documents.
Shipper Address Fields Explained
| Field | Description | Notes |
|---|---|---|
| Shipper Name | Contact person name | Required |
| Company Name | Business or store name | Appears on label |
| Mobile / Contact Number | UPS pickup contact number | Must be reachable |
| Email Address | Shipment-related communication | Required |
| Address Line 1 | Primary pickup address | Required |
| Address Line 2 | Optional extra address info | Optional |
| Country | Pickup country | Must match UPS account |
| State | Pickup state | Required |
| City | Pickup city | Required |
| Postal / Zip Code | Area postal code | Very important |
| Tax ID / GSTIN | Tax identifier | Required for some countries |
| House Number | House / building number | Optional |
📘 Address Book (Recommended)
Shipi allows you to save multiple ship-from addresses using the Address Book.
Use this when:
- You ship from multiple warehouses
- You have dropshipping locations
- You want to switch pickup locations easily
👉 Note:
Address Book setup will be covered in a separate dedicated document.
Link this section to:
“How to Manage Ship-From Addresses in Shipi”
Step 2: Package Configuration (Important)
UPS shipping rates and label generation depend heavily on how your products are packed.
Before continuing, we strongly recommend configuring your Package Settings correctly.
👉 Read this guide:
How Package Configuration Works in Shipi
(Explains individual packing, weight-based packing, boxes, and real examples)
📌 Incorrect package configuration may cause: carrier rejections, wrong shipping rates, label failures
Step 3: UPS Shipping Services
You must enable at least one service.
🏠 Domestic UPS Services
| Code | Service Name | What It Is | When to Use | eCommerce Friendly |
|---|---|---|---|---|
| ups_03 | Ground | Low-cost ground shipping | Standard delivery | ✅ |
| ups_12 | 3 Day Select | 3-day delivery | Faster than ground | ✅ |
| ups_02 | 2nd Day Air | 2-day delivery | Priority orders | ✅ |
| ups_59 | 2nd Day Air AM | Morning delivery | Time-critical | ⚠️ |
| ups_01 | Next Day Air | Next business day | Urgent | ⚠️ |
| ups_13 | Next Day Air Saver | Next day (end of day) | Faster but cheaper | ⚠️ |
| ups_14 | Next Day Air Early AM | Early morning | Emergency | ❌ |
🌍 International UPS Services
| Code | Service Name | What It Is | Use Case | eCommerce Friendly |
|---|---|---|---|---|
| ups_11 | UPS Standard | Road-based intl | EU / nearby countries | ✅ |
| ups_07 | UPS Express | Fast international | Main intl service | ✅ |
| ups_08 | UPS Expedited | Cheaper intl | Cost-sensitive | ✅ |
| ups_54 | UPS Express Plus | Early AM intl | Urgent | ⚠️ |
| ups_65 | UPS Saver | End-of-day intl | Balanced | ✅ |
| ups_96 | Worldwide Express Freight | Heavy pallets | Freight only | ❌ |
📦 Other / Special UPS Services
| Code | Service | Use Case | Recommended |
|---|---|---|---|
| ups_92 | SurePost <1 lb | USPS final mile | ❌ |
| ups_93 | SurePost ≥1 lb | Economy mail | ❌ |
| ups_94 | SurePost BPM | Bulk print | ❌ |
| ups_95 | SurePost Media | Media shipments | ❌ |
| ups_82–86 | UPS Today services | Same-day | ❌ |
| ups_M* | Mail Innovations | USPS hybrid | ❌ |
| ups_70 | Access Point Economy | Pickup points | ⚠️ |
📌 eCommerce rule:
Stick to Ground, 2-Day, Express, Saver.
Service Configuration (Right-Side Config Box)
For each enabled service, Shipi allows customization.
Available Options
| Option | What It Does |
|---|---|
| Display Name | Rename service for customers |
| Price Adjustment (%) | Increase or decrease UPS rate |
📌 Examples:
+10%→ Add margin-5%→ Offer discount
Step 4: UPS Shipping Rates Settings
🔹 Fetch UPS Account Rates
| Option | Meaning | Recommended |
|---|---|---|
| Enabled | Uses your UPS contract | ✅ |
| Disabled | No live rates | ❌ |
🔹 Automatic Label Generation
| Option | Meaning | When to Use |
|---|---|---|
| Disabled | Manual label creation | ✅ |
| Enabled | Auto-create label | ⚠️ Fully automated flows only |
🔹 Paperless Trade
| Option | Meaning | Use When |
|---|---|---|
| Disabled | Physical invoice | ✅ |
| Enabled | Electronic customs docs | UPS-approved only |
🔹 Simple Rate
| Option | Meaning |
|---|---|
| Enabled | Flat UPS pricing |
| Disabled | Real-time rates |
⚠️ Use only if UPS supports Simple Rate for your account.
Step 5: UPS Shipping Label Settings
🔹 Shipment Content
| Value | Meaning |
|---|---|
{prod_names} | Sends product names |
| Custom text | Static description |
✅ Recommended: {prod_names}
🔹 Shipping Label Size (PDF)
| Option | Use |
|---|---|
| GIF / PDF | Standard UPS label |
🔹 Email Address to Send Shipping Label
| Field | Explanation |
|---|---|
| Receives label & invoice |
📌 Leave empty if not needed.
🔹 Who Will Pay the Duty Payment
| Option | Meaning | Recommended |
|---|---|---|
| Shipper | Merchant pays duties | ✅ |
| Recipient | Customer pays duties | ⚠️ Can delay delivery |
🔹 Delivery Confirmation
| Option | Meaning | Use When |
|---|---|---|
| None | No signature | ✅ |
| Signature Required | Any signature | High-value |
| Adult Signature Required | 18+ signature | Restricted items |
📦 Pack Type (UPS-Specific)
This must match what you physically ship.
| Code | Pack Type | When to Use |
|---|---|---|
| 02 | Customer Supplied Package | ✅ Most merchants |
| 01 | UPS Letter | Documents |
| 03 | Tube | Posters |
| 04 | PAK | UPS-style envelope |
| 21 | UPS Express Box | Branded box |
| 24 | UPS 25KG Box | Heavy |
| 25 | UPS 10KG Box | Heavy |
| 30 | Pallet | Freight |
| 2a–2c | Express Boxes | Size-specific |
| 56–67 | Mail types | ❌ Not eCommerce |
📌 Best choice: Customer Supplied Package
If required support – contact us on below link – https://myshipi.com/support