UPS (US)

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.
    AddFunds1.png
  2. Select Add a Carrier.
    ups2.png
  3. Click the UPS tile.
    ups3.png
  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.
    ups6.pngIf 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.
    ups8.png
  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.
    contactups2.png
  3. Click Edit beside your billing address (under the Addresses section).
    contactups3.png
  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.
    titleups1.png
  2. Click UPS Billing Center on the page that appears.
    titleups2.png
  3. Hover over Administration and click Manage Users.
  4. Enter the value from the Role column into the Title field in ShipEngine.
    titleups4.png

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:

invoiceups.png

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 Features


Common ShipEngine Features:

Feature

Supported?

Domestic Shipping

Yes

International Shipping

Yes

Electronic Customs Submission

Yes

Return Labels

Yes

Estimated Rates

Yes

Carrier Insurance

Yes

Tracking

Yes

Automatic Tracking

Yes

End of Day (Electronic)

No

End of Day (PDF)

No

Label Branding

Yes

Label Messages

Yes

Multi-package Shipping

Yes

 

Shipping Options:

Domestic Services

UPS 2nd Day Air AM®

UPS 2nd Day Air®

UPS 3 Day Select®

UPS Ground®

UPS Next Day Air Saver®

UPS Next Day Air®

UPS Next Day Air® Early

UPS Saver®

UPS SurePost®

 

International Services

UPS Standard®

UPS Worldwide Expedited®

UPS Worldwide Express®

UPS Worldwide Express Plus®

UPS Worldwide Saver®

 

Package Options

Package

UPS 10 KG Box®

UPS 25 KG Box®

UPS Express® Box

UPS Express® Box - Large

UPS Express® Box - Medium

UPS Express® Box - Small

UPS Express® Pak

UPS Letter

UPS Tube

 

Confirmation Options

No Confirmation

Delivery

Signature

Adult Signature

 

Additional Features:

Feature

Description

Invoiced Carrier

UPS bills you for only the labels you use, which are invoiced monthly to you on your account. UPS does not charge your account when you create the label in ShipEngine.

Any UPS labels you create in ShipEngine that are NOT used to ship a package will not be billed on your invoice. However, you may still wish to void labels you don't use for improved accuracy in your shipment records.

Negotiated Rates

Your UPS negotiated rates can be enabled in ShipEngine for cheaper shipping costs. 

UPS Consolidation Services

You can enable UPS Consolidation services for use in ShipEngine. For more information, see our articles on UPS SurePost and Mail Innovations

UPS Ground Freight Pricing

You can use UPS Ground with Freight Pricing when you get rates for UPS Ground shipments in ShipEngine. 

When you use this option, you'll need to assign a Freight Classification Code

UPS Ground with Freight Pricing is only available for multi-package UPS shipments that use the shipping service UPS® Ground.

UPS Carbon Neutral Program

By default, all UPS accounts connected to ShipEngine are automatically enrolled in the Carbon Neutral program.

If you do not want to participate in the Carbon Neutral program, disable this option in your UPS Settings in ShipEngine.

Electronic Data Interchange (EDI)

Contact UPS to have EDI enabled for your UPS account. Once enabled, ShipEngine will automatically submit customs information electronically through the UPS EDI service.

If ShipEngine is not able to submit customs information through EDI (either because it's not enabled for your UPS account or because the destination country does not support EDI), you will instead need to print any necessary customs forms and include them with the shipment.

Third Party and Recipient billing

This option allows you to assign the billing to a third party or recipient UPS account. 

You must enter the account number and account zip code of the third-party account. The third-party account must also allow third-party billing.

Bill duties and taxes to payor of shipping charges

Use this option to be charged duties and taxes on behalf of your international customers.

If you use this option in conjunction with third-party or recipient billing, the billed account will be responsible for the duties and taxes.

Saturday Delivery

Use this option to allow for package delivery on Saturdays. See the UPS page on Saturday Delivery for more information and restrictions.

Dry Ice shipping

Use this option to let UPS know the package contains dry ice. See the UPS page on Coolants and Refrigerants for more information and restrictions.

Collect on Delivery

Use Collect on Delivery so that UPS will collect funds from the recipient when UPS delivers the package. See the UPS page on Collect on Delivery for more information and restrictions.

 

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.