How to set up UPS

Overview

  • UPS's integration with Starshipit allows you to use all of Starshipit's features including generation of packing slips and shipping labels, auto-correction of addresses, branded tracking and notifications and many more.
  • This article outlines how to set up UPS account in Starshipit and how to migrate from the Access Key authentication model to OAuth 2.0 authentication.
  • Starshipit is also a certified UPS Ready Partner. Read more about this in our blog.

Table of Contents

Before you begin

You will need the following UPS details:

  • Username
  • Password
  • Shipper Number

How to set up UPS

To enable UPS on your Starshipit account:

  1. Log into Starshipit.
  2. Go to Settings > Couriers > Add a new courier > UPS.
  3. Select Enable UPS.
  4. Toggle to Use UPS new.
  5. Enter your UPS Shipper number.
  6. Click Authorize. This will take your UPS login page where you will need to enter your UPS username and UPS password. You will then be redirected to Starshipit once you complete this step. If you're not being redirected, follow these steps.
  7. Successful will show when you are redirected back to the Starshipit UPS settings page. If you get an invalid response, please reach out to our support team.
  8. Select Save.
  9. Click Test to ensure it works.
  10. Configure your product codes. 
  11. Go to Advanced and enable any settings you require.
    If you are migrating from the UPS Legacy integration you will need to re-enable your advanced settings.

How to migrate from the Access Key authentication model to OAuth 2.0 authentication

To migrate:

  1. Log into Starshipit.
  2. Go to Settings > Couriers > UPS.
  3. Under UPS API Version, click Use UPS (New)
  4. Click Authorize. This will take your UPS login page where you will need to enter your UPS username and UPS password. You will then be redirected to Starshipit once you complete this step. 
  5. Successful will show when you are redirected back to the Starshipit UPS settings page. If you get an invalid response, please reach out to our support team.
  6. Select Save.
  7. Click Test to ensure it works.
  8. You will need to reselect your advanced settings once you have authorized your integration.

UPS Available Products

Add your product codes to complete the integration. Supported product codes are:

Undefined Countries or Territories

Use for all countries or territories other than United States, Canada, European Union, Mexico, Poland, and Puerto Rico

  • 07 - UPS Express
  • 11 - UPS Standard
  • 08 - UPS Worldwide Expedited
  • 54 - UPS Worldwide Express Plus
  • 65 - UPS Worldwide Saver

All Countries or Territories

Shipments originating in any country or territory

  • 96 - UPS Worldwide Express Freight
  • M5 - UPS Priority Mail Innovations
  • M6 - UPS Economy Mail Innovations
  • 71 - UPS Worldwide Express Freight Mid-day

United States

Shipments originating in United States

  • 11 - UPS Standard
  • 08 - UPS Worldwide Expedited
  • 07 - UPS Worldwide Express
  • 54 - UPS Worldwide Express Plus
  • 65 - UPS Worldwide Saver
  • 72 - UPS Worldwide Economy DDP
  • 17 - UPS Worldwide Economy DDU

United States (Domestic)

Domestic shipments in United States

  • 02 - UPS 2nd Day Air
  • 59 - UPS 2nd Day Air A.M.
  • 12 - UPS 3 Day Select
  • M4 - UPS Expedited Mail Innovations
  • M2 - UPS First-Class Mail
  • 03 - UPS Ground
  • 01 - UPS Next Day Air
  • 14 - UPS Next Day Air Early
  • 13 - UPS Next Day Air Saver
  • M3 - UPS Priority Mail

Canada

  • 02 - UPS Expedited
  • 13 - UPS Express Saver
  • 12 - UPS 3 Day Select
  • 70 - UPS Access Point Economy
  • 01 - UPS Express
  • 14 - UPS Express Early
  • 65 - UPS Express Saver
  • 11 - UPS Standard
  • 08 - UPS Worldwide Expedited
  • 07 - UPS Worldwide Express
  • 54 - UPS Worldwide Express Plus
  • 54 - UPS Worldwide Express Plus
  • 72 - UPSTM Worldwide Economy DDP
  • 17 - UPSTM Worldwide Economy DDU

European Union

  • 70 - UPS Access Point Economy
  • 08 - UPS Expedited
  • 07 - UPS Express
  • 11 - UPS Standard
  • 54 - UPS Worldwide Express Plus
  • 65 - UPS Worldwide Saver
  • 74 - UPS Express®12:00
  • 72 - UPSTM Economy DDP
  • 17 - UPSTM Economy DDU

Mexico

  • 70 - UPS Access Point Economy
  • 08 - UPS Expedited
  • 07 - UPS Express
  • 54 - UPS Express Plus
  • 11 - UPS Standard
  • 65 - UPS Worldwide Saver

Poland

  • 70 - UPS Access Point Economy
  • 08 - UPS Expedited
  • 07 - UPS Express
  • 54 - UPS Express Plus
  • 65 - UPS Express Saver
  • 11 - UPS Standard
  • 83 - UPS Today Dedicated Courier
  • 85 - UPS Today Express
  • 86 - UPS Today Express Saver
  • 82 - UPS Today Standard
  • 72 - UPSTM Economy DDP
  • 17 - UPSTM Economy DDU

Puerto Rico

Shipments originating in Puerto Rico

  • 02 - UPS 2nd Day Air
  • 03 - UPS Ground
  • 01 - UPS Next Day Air
  • 14 - UPS Next Day Air Early
  • 08 - UPS Worldwide Expedited
  • 07 - UPS Worldwide Express
  • 54 - UPS Worldwide Express Plus
  • 65 - UPS Worldwide Saver

UPS Returns

Starshipit supports creating return shipments with UPS. Rates are supported for

UPS Print Return Label Service only. To set up returns with UPS, please follow the below instructions:

  1. Ensure that UPS has enabled returns on your account.
  2. Navigate to Settings > Couriers > UPS > Add your UPS Return Product codes then set a default service. 
  3. You can generate a return with UPS from an existing shipped order in Starshipit or create a manual return.

To learn more about generating returns checkout our guide here.

UPS Returns Services

Code Service
2 UPS Print and Mail (PNM)
3 UPS Return Service 1-Attempt (RS1)
5 UPS Return Service 3-Attempt (RS3)
8 UPS Electronic Return Label (ERL)
9 UPS Print Return Label (PRL)
10 UPS Exchange Print Return Label
11 UPS Pack & Collect Service 1-Attempt Box 1
12 UPS Pack & Collect Service 1-Attempt Box 2
13 UPS Pack & Collect Service 1-Attempt Box 3
14 UPS Pack & Collect Service 1-Attempt Box 4
15 UPS Pack & Collect Service 1-Attempt Box 5
16 UPS Pack & Collect Service 3-Attempt Box 1
17 UPS Pack & Collect Service 3-Attempt Box 2
18 UPS Pack & Collect Service 3-Attempt Box 3
19 UPS Pack & Collect Service 3-Attempt Box 4
20 UPS Pack & Collect Service 3-Attempt Box 5

UPS Additional Features

Dangerous Goods
Starshipit supports sending Dangerous Goods on the UPS Rest API. Follow these steps to migrate to the UPS REST API. To learn more on how to set up Dangerous Goods with UPS this support guide. 
Negotiated Rates
By default Starshipit will use UPS retail rates. If you have an agreement in place with UPS to have negotiated rates you can select Use Negotiated Rates from the advanced settings
International
If shipping internationally, make sure you configure your incoterms, export type and tax identification number from Settings > Couriers > UPS > Advanced 
NAFTA

You can configure settings for the NAFTA Certificate of Origin. This certificate is used by Canada, Mexico, and the United States including Puerto Rico, to determine if goods imported into their countries receive reduced or eliminated duty as specified by the North American Free Trade Agreement (NAFTA).

The NAFTA Certificate of Origin is attached to an invoice if the shipment is valued at greater than:
  • $1,000 USD and is being sent to Mexico - from Canada or the U.S.
  • $2,500 CAD and is being sent to Canada - from Mexico or the U.S.
  • $2,500 USD and is being sent to the U.S. - from Canada or Mexico.
Paperless
You can enable UPS paperless invoice for the commercial invoice and NAFTA CO documents by selecting this from the advanced settings. Note: you must also request UPS to enable paperless trade at their end. If these are enabled and working correctly, 'EDI' will show at the bottom-right of any paperless trade labels, or otherwise 'INV' will show.  
Declared Value
UPS charge additional fees if you specify the declared value for international shipments. This is a kind of insurance that they offer. If you would like to disable this insurance you can go to Settings > Couriers > UPS > Advanced > Tick Exclude Declared Value for International Shipments
Pickups
Starshipit supports booking a pickup with UPS. To learn more about how to book a pick up check out our support guide.
Cancel shipments

Easily cancel shipments by going to Settings > Couriers > UPS > Tools and entering the shipment tracking number.

Adult Signature

Ensure age verification for your shipments by ticking the Adult Signature option on each order.

Large/Additional Handling

Flag your packages as large or requiring additional handling using the tickboxes in the order details. This will ensure you see rates inclusive of any surcharges for these special packages.

Troubleshooting

When I try to authorise my UPS account, I'm not being redirected back to Starshipit

If you're not being redirected back to Starshipit, it is most likely because you're using a CampusShip UPS account, which is not supported for API integrations. You will need to create a new user ID by following the steps below:

  1. Sign up for a new UPS ID here.
    You will then need to add your UPS account to the newly created UPS ID.
  2. Click on your profile icon on the top right.
  3. Click Accounts and Payment.
    cid:image005.jpg@01D81128.49AD7C60
  4. Under Add a Payment Method, select Add Existing Account.
    cid:image006.jpg@01D81128.49AD7C60
  5. Click Add.
    cid:image007.jpg@01D81128.49AD7C60
  6. Once added, you will be prompted to choose a validation method:
    • Invoice Data Verification
    • PIN Verification
  7. Select I need to request a PIN and provide the email associated with the Account Owner for the added account.
  8. Retrieve the PIN from the account owner and enter it.
    Note: PIN information is valid for 30 minutes only.
  9. Upon completion, the account will be added to your new account and the account owner will receive email confirmation stating that the User ID has been successfully added to their account.

Want to deliver great shipping experiences?

Start a 30-day free trial or book a demo with one of our shipping experts

Was this article helpful?
1 out of 2 found this helpful

We're sorry you didn't find this helpful - please help improve this article!

We're always looking for ways to get it right.Please help others by submitting your feedback here