Overview
If you pack and ship orders from your winery, you can connect your own UPS account to Offset. Offset sends each order's details to UPS and creates the shipping label so everything can be managed in one place.
Setup happens in four stages:
You create API credentials in the UPS Developer Portal and send them to the Offset team securely.
The Offset team enters them, and your connection is active as soon as they're saved.
You ask UPS to set up your account to receive labels through the API.
You set up your UPS shipping methods and print a test label.
Please note that UPS can take several weeks to set up your account for API labels. Start creating your credentials as early as you can.
Getting Started: What You'll Need
A UPS shipping and developer account.
A 4x6 thermal label printer, such as a Zebra, with self-adhesive 4x6 labels.
Step 1: Create a UPS App in the Developer Portal
The UPS Developer Portal is where you create the credentials that let Offset create labels on your account.
Go to developer.ups.com and log in with your UPS.com login. It must be linked to the UPS account you ship with.
If UPS sends you back to ups.com after you log in, return to developer.ups.com and continue.
Open Apps from your profile menu and click Add Apps (some pages say Create an Application).
In the "I need API credentials because" section, select "I want to integrate UPS technology into my business".
Choose the UPS account to link to the app and accept the terms.
Fill in your primary contact details and continue.
Enter an app name (this is only for your reference) and a callback URL
Under Add Products, add the following, then click Save:
Authorization (OAuth)
Address Validation
Locator
Rating
Time In Transit
Tracking
Shipping
Open your new app. Your Client ID and Client Secret appear on its details page. Click the eye icon to reveal each one.
IMPORTANT: Copy your Client ID and Client Secret right away and store them safely, ideally in a password manager such as 1Password. If you lose the secret, you can generate a new one from the app.
Step 2: Send Your Details to the Offset Team
Contact support@offsetpartners.com to let us know your UPS credentials are ready. Send them in a secure way, such as a secure Google Sheet, an encrypted file, or a 1Password vault. We will need:
UPS account number
Client ID
Client Secret
IMPORTANT: Your API keys and secret keys give access to your UPS account, so share them securely using one of these options:
A 1Password vault (preferred): We’ll create a secure vault and add you as a guest. Add your credentials there, then let us know once they’re in.
A one-time secret link: If you can’t use 1Password, paste your credentials into a one-time link service such as Yopass, One-Time Secret, or Password Pusher, then send us the link. The link stops working once it’s opened, so your credentials don’t stay in anyone’s inbox.
Don’t send credentials in a regular email or chat message, or put them in Google Sheets or other shared documents.
Step 3: Ask UPS to Enable Your Account
UPS works only with the account holder, so this step comes from you.
Email your UPS rep or UPS customer support. Let them know you've created API credentials, shared them with Offset, and need your account set up to receive labels through the API so you can run tests.
Copy the Offset support team, so we can help if UPS has technical questions.
You can set up your shipping methods (Step 4) while you wait to hear back from UPS.
Step 4: Set Up Your UPS Shipping Methods
Each shipping method you'll ship with UPS needs UPS selected as its fulfillment, with the matching service.
Go to Settings → Fulfillment Methods & Rates
Click the ellipsis (…) next to a UPS shipping method, such as UPS Ground, and select Edit Fulfillment Method
Under Method Details, change Fulfillment to UPS
If you use ShipCompliant for fulfillment with other methods, make sure you choose InHouseUPS for the Fulfillment option. Additionally, set the ShipCompliant status for this method as "Payment Accepted" or "Delivered" since you're fulfilling in house.
In Method Code, select the matching UPS service from the table below
Save, and repeat for each UPS shipping method
Step 5: Print a Test Label
Once UPS has set up your account, print one test label before you ship in volume. This is ready once you receive the okay from UPS.
Create a test order with a UPS shipping method.
Go to Orders, check the box next to the test order, and open the Choose an Action dropdown.
Run Step 1) Carrier Export. The order changes from Not Shipped to Processing. If the export fails, the error appears on the order. Review it before you try again.
Run Step 2) Carrier Labels which will automatically download a label.
Check that the label prints at the right size, scans cleanly, and creates the number of labels you expect
Print UPS Labels From the Orders Page
Once your test label looks right, you can print labels for all your UPS orders.
NOTE: If you use ShipCompliant, send your orders to ShipCompliant first. Select the orders and choose ShipCompliant Export [API] from the Choose an Action dropdown before moving on to the carrier exports.
Go to Orders and open Filters
Set Shipping Statuses to Not Shipped and select Filter Orders. Filters default to year-to-date orders, so check the date range if an order you expect is missing
If you use ShipCompliant, run your ShipCompliant export first and check for failures. Then filter Compliance Status to Passed Compliance, so labels are created only for compliant orders
Check the box next to each order you're shipping, or use the checkbox at the top to select all
Open the Choose an Action dropdown and, under Carrier Exports, run these steps in order:
Step 1) Carrier Export: Sends the orders to UPS and creates a shipment for each one. Each submitted order changes to Processing
Step 2) Carrier Labels: Downloads one PDF with the labels for every selected order. Print it on your 4x6 label printer
Step 3) Packing Slips (optional): Downloads packing slips to include in each box
Ship your packages. Tracking numbers are added to each order automatically, and each order changes to Shipped when UPS scans the package
Shipment Emails and Tracking Links
Your customer receives an email when their package is picked up, when it ships, when it's out for delivery, if there's a delivery exception, and when it's delivered. UPS tracking numbers link to UPS's tracking page, both on the order in Offset and in these emails.
Since these emails come from Offset, you can disable the customer email notifications within UPS if you wish.

