UPS

ShipEngine’s UPS integration supports domestic and international label creation, tracking, and real-time rate shopping. 

This article includes:

Connect a UPS Account to ShipEngine


To connect your UPS account to ShipEngine, follow the steps below:

  1. Go to Connections in the ShipEngine Dashboard.
  2. Select Add a Carrier.
  3. Click the UPS tile.
  4. Click Next.
  5. Read through the UPS Technology Agreement, select Yes, I Agree, then click Next.
  6. Fill out the left side of the form with your UPS account's Primary Contact Information.

    If you are unsure about where to find this information, see the Locate Your UPS Contact Information section below.
  7. Fill out the right side of the form with your UPS account information, then click Next.
    NOTE: If this is a new UPS account, be sure to uncheck the box next to “I have received an invoice in the last 90 days” then skip to step 9.
  8. Enter the requested information from your most recent UPS invoice, then click Next.
  9. Click Connect.

Locate Your UPS Contact Information


  1. Log in to your UPS account.
  2. Click your username and select Addresses from the drop-down in the top, right-hand corner of the screen.
  3. Click Edit beside your billing address (under the Addresses section).
  4. Enter this address information into the UPS Account Information window in ShipEngine.

To locate the information for the Title field:

  1. Go to the Profile menu again and click View & Pay Bill.
  2. Click UPS Billing Center on the page that appears.
  3. Hover over Administration and click Manage Users.
  4. Enter the value from the Role column into the Title field in ShipEngine.

UPS Invoice

To locate your UPS invoice (this information is necessary for the Invoice Verification stage of the connection process):

Go back to your UPS Billing Center, hover over the Invoice tab, and click on the hyperlink to your most recent invoice:

Enable Negotiated Rates


To see your UPS negotiated rates in ShipEngine, you must add the following details from your most recent UPS invoice (invoice must be within the last 30 days): 

  • Invoice Number
  • Invoice Date
  • Invoice Amount
  • Control ID

If you have not received an invoice yet, you must wait until you receive one.

To enable negotiated rates to an already-connected UPS account: 

  1. Go to the Connections section of ShipEngine.
    connections.png
  2. Click Edit next to your connected UPS account.
    neg-1.png
  3. Check Enable Negotiated Rates.
    neg-2.png
  4. Fill in the details from your most recent invoice.
  5. Confirm your changes.

NOTE: The rate you see in ShipEngine for UPS shipments is provided directly from UPS based on your account information and the parameters of your shipment. However it is still an estimate, and you will always be charged according to the terms of your contract. In addition, UPS reserves the right to add on additional fees.

Available Services


Domestic Services

Description

UPS® Ground

UPS’s economical option for shipping to all 50 states and Puerto Rico in 1-5 business days.

UPS 3 Day Select®

UPS’s shipping service for orders originating and being delivered in the 48 contiguous states within 3 business days.

UPS 2nd Day Air®

UPS’s expedited shipping service with guaranteed delivery to all 50 states and Puerto Rico in 2 business days. (Some restrictions may apply with Hawaii and Alaska.)

UPS 2nd Day Air AM®

UPS’s expedited shipping service that delivers to the contiguous 48 states in two business days before noon. (With limited support for Hawaii and Alaska.)

UPS Next Day Air Saver®

UPS’s expedited service that delivers to the contiguous lower 48 states by the end of the next business day.

UPS Next Day Air®

A UPS expedited shipping service with guaranteed delivery to all 50 states and Puerto Rico in 1 business day. (Some restrictions may apply with Hawaii and Alaska.)

UPS Next Day Air Early®

UPS’s quickest Next Day shipping option that will deliver to most locations by 8:00 a.m. on the next business day, with some arrivals by 10:00 a.m. to most other US locations such as Anchorage Alaska. And other US locations are available by 11:30 a.m. the next business day.

 

International Services

Description

UPS Standard®

UPS’s cost-effective service for shipping to Canada and Mexico. Delivery times can vary depending on location.

UPS Worldwide Expedited®

A UPS expedited service that delivers to Canada in 2 business days, 2-3 business days to Mexico, 3-4 business days to Mexico, and 4-5 business days to Asia and Latin America.

UPS Worldwide Saver®

A UPS expedited service that delivers international shipments in 1-3 business days, with next day delivery to Canada and documents to Mexico, and 2 business days to Europe and Latin America, and 2-3 days to Asia.

UPS Worldwide Express®

A UPS expedited service that delivers international shipments by either 10:30 a.m., 12:00 noon, or 2:00 p.m. local time depending on where the package is being delivered. These delivery times will be on the next business day delivery to Canada and Mexico, 2 business days to Europe and Latin America, and 2-3 business days to Asia.

 

Services

Dimensions and Weight Limit

All Listed Services

Max Dimensions: 165” in combined length and girth*.

Max Length: No side can exceed 108”

Max Weight:150 lbs.

*Length + 2x Width + 2x Height

 

Troubleshooting


Here are some common issues, their potential causes, and troubleshooting tips when using UPS services with ShipEngine.

I'm getting an error when trying to connect my UPS account to ShipEngine. What should I do?

There are several errors you may see when connecting a UPS account to ShipEngine. The chart below describes the most commonly experienced errors and their potential solutions:

Error

Cause

Solution

Request cannot be processed, please contact UPS customer service at 1-888-851-4901

Request cannot be processed, please contact UPS customer service at 1-XXX-XXX-XXXX

Billing or other UPS account issues.

Contact UPS at the number provided, and leave a voicemail with your contact information if no answer. Other UPS departments cannot typically assist with this error.

PostalCode and/or CountryCode input does not match those associated with the AccountNumber

The address entered does not match the Primary Contact Information for the account.

Log in to UPS.com to gather address information required.

Unable to verify negotiated rates. Please review invoice information and resubmit

Invalid invoice or account does not have access to negotiated rates.

If you do not already have access to negotiated rates, do not select the option to Enable Negotiated Rates. If you do not have a recent invoice, you must check with the UPS accounts payable department. You can also get billing help online or call the UPS Billing Department to request a duplicate invoice.

Request cannot be authorized due to invoice not found in UPS billing system

Invalid invoice information or outdated invoice.

If you do not have a recent invoice, you must check with the UPS accounts payable department. You can also get billing help online or call the UPS Billing Department to request a duplicate invoice.

Request cannot be authorized due to account is locked out, please try again after 24 hours

Attempted registration with invalid invoice information too many times.

Contact UPS directly to unlock the account. Ensure you have the correct invoice information for future attempts.

Missing or Invalid Shipper Number

Error in UPS account number entered.

Check the account number entered to ensure there are no spaces and the account number is correct.

Register Web service is temporarily unavailable

ShipEngine is unable to register the account with UPS.

Temporary issue typically related to server maintenance. Check the ShipEngine status page or contact support for updates.

Licensing system not available

ShipEngine is unable to register the account with UPS.

Temporary issue typically related to server maintenance. Check the ShipEngine status page or contact support for updates.

I'm getting an error when trying to create UPS shipping labels. What should I do?

There are a number of potential errors you may see when getting UPS rates and creating UPS labels in ShipEngine. The chart below describes the most commonly experienced errors and their potential solutions:

Error

Cause

Solution

Missing or invalid shipper number

Error in UPS account number being used for shipment.

If seen after successful connection of a UPS account, this error is typically related to Third-Party Billing. Check to ensure Third-Party Billing information is using a valid UPS account.

Missing or invalid ship from company name

No Company Name in Ship From Address.

Ship From Company Name is required for some UPS shipments. Add a Company Name in the ship_from object or update your warehouse_id to include a Company Name.

The Shippers shipper number cannot be used for the shipment

Billing or other UPS account issue.

Contact UPS directly to discuss the cause of the error and how to resolve it.