UPS

ShipEngine is a certified UPS Ready® application that allows you to get rates and create shipping labels via your negotiated UPS shipping rates. UPS helps both large and small businesses with their logistical needs and offers sustainability options like paperless invoices and their Carbon Neutral program.

You can connect UPS accounts based in the US, Canada, UK, and Australia to your ShipEngine accounts. Features and services between accounts in these countries differ somewhat. Check the Available Features section below for details on which features and services are supported for each country.

UPS Requirements

Connection Requirements:

  • An active account with UPS.

  • Your UPS account billing address, phone number, and email address.

  • The following details from your most recent UPS invoice (not required for new accounts):

    • Control ID

    • Invoice Date

    • Invoice Number

    • Invoice Amount

    See Step 8 of the Connect a UPS Account section below for an image of a sample invoice.

International Requirements:

Include three copies of a commercial invoice with your shipment if you do not have electronic submission enabled. Review international options and forms.

Connect a UPS Account to ShipEngine

To connect your UPS account to ShipEngine:

  1. Select the UPS tile.

    UPS Logo
  2. Click Continue setup.

  3. Read through the UPS Technology Agreement and check the box next to "I have read and agree to the following terms of service above", then click Next.

  4. Enter your UPS account information.

    If you are unsure about where to find this information, see the Locate Your UPS Contact Information section below.

    CONN_Carriers_UPSForm.png

    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 8.

  5. Enter the requested information from your most recent UPS invoice on the right side of the Register your UPS Account screen.

    Sample UPS invoice with Control ID number, Invoice Date, Invoice Number, and Amount Due highlighted.
  6. Click Continue setup.

  7. Review the Confirmation screen details, then 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.

    UPS Profile menu with Addresses item highlighted.
  3. Click Edit beside your billing address (under the Addresses section).

    UPS Address with Edit highlighted
  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.

    UPS__ViewPayBill_US__png.png
  2. Click UPS Billing Center on the page that appears.

    UPS Billing Center menu item highlighted.
  3. Hover over Administration and click Manage Users.

  4. Enter the value from the Role column into the Title field in ShipEngine.

    UPS manage user menu with Administrator role highlighted.

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:

UPS Invoice number with censored number highlighted.

Enable Negotiated Rates

To see your UPS negotiated rates in ShipEngine, you must add the following details from your most recent UPS invoice:

  • Invoice Number

  • Invoice Date

  • Invoice Amount

  • Control ID

The invoice must be within the last 30 days. 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. Click the vertical ellipsis next to your connected UPS account and select Edit.

    CONN_EditCarrier_UPS_MRK.png

    This will open the Edit Carrier window.

  2. Check the box next to Enable Negotiated Rates.

    CONN_UPS-Settings_NegotiatedRates_MRK.png
  3. Fill in the details from your most recent invoice.

  4. Click the Save button to 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 for UPS Integration

Common ShipEngine Features

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipEngine will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipEngine.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

UPS Services & Options

US, Canada, and UK UPS accounts can create both domestic and international labels in ShipEngine. Australia UPS accounts can create international shipping labels only.

US Domestic & International Services

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®

Canada Domestic & International Services

Domestic Services:

  • UPS Expedited®

  • UPS Express®

  • UPS Express Early®

  • UPS Express Saver®

  • UPS Saver®

  • UPS Standard®

International Services:

  • UPS 3 Day Select® to the U.S.

  • UPS Express Early® A.M. to the U.S.

  • UPS Standard International®

  • UPS Worldwide Expedited®

  • UPS Worldwide Express®

  • UPS Worldwide Express Plus®

  • UPS Worldwide Express Saver®

UK Domestic & International Services

Domestic Services:

  • UPS Express®

  • UPS Express Plus®

  • UPS Express Saver®

  • UPS Saver®

  • UPS Standard®

International Services:

  • UPS Express®

  • UPS Express Plus®

  • UPS Express Saver®

  • UPS Expedited®

  • UPS Standard®

Australia International Services

  • UPS Worldwide Expedited®

  • UPS Worldwide Express®

  • UPS Worldwide Express Plus®

  • UPS Worldwide Express Saver®

UPS Package Types & Confirmation Options

UPS Package Types:

  • 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

UPS Confirmation Options:

  • No Confirmation

  • Online (this is the default UPS confirmation option in ShipStation)

  • Delivery

  • Signature

  • Adult Signature

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipEngine will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipEngine.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

UPS Surcharges

When entering your shipments weight and dimensions into ShipEngine, they should accurately reflect the size of the package so the rate returned to ShipEngine will be the rate you are actually charged for the shipment. Should the dimensions entered into ShipEngine not reflect the actual dimension of the shipped package, you may be subject to additional fees from UPS.

It is the shipper's responsibility to enter an accurate dimension into ShipEngine before creating the label for the shipment!

Packages with an actual weight of more than 150 pounds, or that exceed 108 inches in length, or exceed a total of 165 inches in length plus girth [(2 x width) + (2 x height)] combined, as measured to determine their billable weight, are not accepted for transportation.

If UPS finds packages that exceed these limits in the UPS system, the shipments are subject to additional charges. UPS reserves the right in its sole and unlimited discretion to return such packages to the shipper at the shipper’s expense.

UPS Integration Notes

  • Labels created through ShipEngine will not appear in your Shipment History on UPS.com.

  • UPS End of Day forms (also known as PLD forms) are not available in ShipEngine. As a Certified UPS Partner, ShipEngine submits all shipment information electronically to UPS when labels are created, so no End of Day process or PLD form is necessary.

  • ShipEngine's address validation tool cannot determine if an address is considered Residential or Commercial, so all addresses are treated as Commercial addresses. This may cause the estimated rates to be incorrect for some Residential UPS shipments.

  • UPS Smart Pickup is not available for UPS shipments created through ShipEngine.

  • Recipient Address Line 1 has a 30-character limit. When the Recipient Address 1 field exceeds this limit ShipEngine will automatically wrap to Address Line 2.

  • Label Messages will only work on Multi-package shipment labels.

  • Rates for Australia-based UPS accounts are not yet available in the Rate Calculator.

UPS Troubleshooting Tips

Here are some common issues, potential causes, and troubleshooting tips.

UPS Account Connection Errors

Error

Cause

Solution

Invalid Account Status

Account was not active over an extended period of time.

Contact UPS directly to re-activate the account.

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

Billing or other UPS account issue.

Contact UPS at the number provided, and leave a voicemail with your contact information if nobody answers. 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 unable to register the account with UPS.

This is a temporary issue typically related to server maintenance. Check the ShipEngine status page or contact support for updates.

Licensing system not available

ShipEngine unable to register the account with UPS.

This is a temporary issue typically related to server maintenance. Check the ShipEngine status page or contact support for updates.

UPS Rate and Label Errors

There are a number of potential errors you may see when getting UPS rates and creating UPS shipments. This next chart describes the most commonly experienced errors and their potential solutions:

Error

Cause

Solution

The requested billing option is unavailable between the selected locations

This error occurs for international labels on packages valued under 100 Euros when you select the option to Bill taxes and duties to the payor of shipping in the Other Shipping Options section.

UPS does not bill duties and taxes if the shipment value, including product cost and shipping cost, is under 100 Euros per day. UPS will block the label from being created due to DDP being not applicable for the shipment, since none will be charged to the receiver or shipper.

Deselect the option to Bill taxes and duties to the payor of shipping in the Other Shipping Options section, then create the label.

The Userid is currently locked out please try again in 5 minutes

ShipEngine's access credentials are out of date and need to be updated.

Go to Settings > Shipping > Carriers and click the Setting link for UPS. Click the Remove Account action. Once removed, add the account back to ShipEngine.

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

ShipEngine's access credentials are out of date and need to be updated.

Go to Settings > Shipping > Carriers and click the Setting link for UPS. Click the Remove Account action. Once removed, add the account back to ShipEngine.

The accessory is not valid with the selected option

Service, package, or shipping option not compatible

The service and package are not compatible, or an "Other Option" that is not allowed (like Saturday Delivery) is selected for the shipment. Remove any options that are not permitted for the shipment type.

The requested accessory option is unavailable between the selected locations

You are attempting to ship something by UPS and have selected the Carbon Neutral option in your UPS account settings in ShipEngine. The UPS Carbon Neutral Shipping Program is not available between all locations.

Go to your ShipEngine Connection Settings and edit your UPS settings. Disable the Carbon Neutral option and save your changes.

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. Either add a Company Name to the Ship From Address or add a Company Name in the Branding tab of the store's settings.

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.

Missing or invalid ship from StateProvinceCode

UPS wants the 2-digit state code instead the name of the City or Province.

If shipping to or from an address in the UK, try substituting the state or province for a two-letter code as found on this United Kingdom (GB) State/Province Table. For example, use JJ instead of Edinburgh.

DDP
DDP

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipEngine will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipEngine.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

DDP