Return Labels
The UPS Connector supports creating return labels via the UPS Return Service. This allows your customers to easily send packages back to you.
How It Works
UPS uses Return Service Code "9" (UPS Print Return Label) for returns. The addresses are swapped:
| Field | Regular Shipping | Return |
|---|---|---|
| Shipper (Sender) | Your company | The customer |
| ShipTo (Recipient) | The customer | Your company |
| ShipFrom | Your company | The customer's address |
The return label is created on your end, but the customer is the sender on the label.
UPS Print Return Label
UPS supports various return types. The connector uses Code "9" (Print Return Label) — the label is printed at your location and sent to or included with the customer's shipment.
Creating a Return Label
Step 1: Start the Return
Via the Shipment Label List:
- Open the Shipment Label List
- Click Create Return Label in the action bar
Via an Existing Shipment:
- Open an already created shipment label
- Use the Create Return Label action
Step 2: Verify the Return Address
The return data is automatically prepared:
- Return Shipper (customer) — taken from the recipient address of the original shipment
- Return ShipTo (your company) — taken from your shipper address in the UPS Setup
- Account Number — your UPS customer number (billed to your account)
Step 3: Packages
For return labels, packages are automatically marked as returns:
- In the Package List, the Is Return field is set to
Yes - Each package receives its own tracking number for the return
Step 4: Create the Label
Click Create. The connector:
- Builds a Return Shipment Request (Service Code "9")
- Sends it to the UPS Shipping API (
POST /api/shipments/v2409/ship) - Parses the response: tracking number, label graphic
- Saves the return label in Business Central
Sending the Return Label to the Customer
| Method | Description |
|---|---|
| By Email | Send the label as an image/PDF attachment to the customer by email |
| Included in Shipment | Print the label beforehand and include it in the original shipment |
| On Request | Only create the label when the customer requests a return |
Recommendation
Include the return label with the original shipment — this greatly improves customer satisfaction and reduces support inquiries.
Return Tracking
Return shipments are tracked just like regular shipments:
https://www.ups.com/track?tracknum={Tracking-Number}
The tracking URL is automatically generated and saved in Business Central.
Multi-Parcel Returns
If the customer needs to return multiple packages:
- Create a return label with multiple packages
- All packages are automatically marked as returns
- Each package receives its own tracking number
Frequently Asked Questions
Who pays for the return?
The return is billed to your UPS Account Number. The customer pays nothing.
Can the customer print the return label themselves?
Yes — send the label as a GIF/PNG file to the customer by email. The customer can print it on a regular printer.
How long is a return label valid?
UPS return labels are typically valid for up to 1 year from the creation date.
Can I void a return label?
Yes, return labels can be voided just like regular labels — via the Void Shipment action, as long as the package has not yet been handed over to UPS.
Are returns created via the same API endpoint?
Yes. Returns use the same /api/shipments/v2409/ship endpoint, but with the additional ReturnService object (Code "9") and swapped addresses.