UPS

Details about ShipStation's integration with UPS. Includes requirements, connection process, features, notes, and troubleshooting tips.

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

UPS Requirements

Connection Requirements:

  • An active account with UPS.

    Need to open a UPS account? Sign up with UPS to get started!

  • 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 9 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.

Connect a UPS account to ShipStation

To connect your UPS account to ShipStation:

  1. Select the UPS tile and click Connect.

    UPS Logo
  2. Click Next.

  3. Read through the UPS Technology Agreement, select Yes, I Agree, then click Next.

  4. Fill out the left-hand side of the form with your UPS account's Primary Contact Information.

    Closeup of the the form to Connect a UPS account.

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

  5. Fill out the right-hand 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 45 days, then skip the next step.

  6. Enter the requested information from your most recent UPS invoice, then click Next.

    UPS invoice with ControlID Invoice date invoice number and amount due highlighted

    For UPS accounts in Australia that have negotiated rates, add 000 to the start of the invoice number. Then enter 0000 for the Control ID. Otherwise, your negotiated rates will not appear in ShipStation.

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

To locate the information for the Title field:

  1. Go to the Profile menu again and click View & Pay Bill.

    UPS Profile menu with View & Pay Bill option highlighted.
  2. Click UPS Billing Centre 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 ShipStation.

    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 Centre, hover over the Invoice tab, and click on the hyperlink to your most recent invoice:

UPS Invoice number with censored number highlighted.

Available Features for UPS Integration

ShipStation's integration with UPS supports these standard features:

UPS Additional Features

ShipStation's integration with UPS allows for these 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 ShipStation.

Any UPS labels you create in ShipStation 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.

Enable Negotiated Rates

Go to Settings > Shipping > Carriers & Fulfillment. Then click Settings for your UPS account. Check the Enable Negotiated Rates and click Confirm.

To enable negotiated rates, add 3 leading 0s to provided invoice numbers and enter in 0000 for the Control ID as a placeholder. This will allow you to proceed through the NR setup and will show their UPS NR in-app.

UPS settings pop-up Select Enable negotiated rates option.

UPS Carbon Neutral Program

By default, all UPS accounts connected to ShipStation 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 ShipStation.

Electronic Data Interchange (EDI)

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

If ShipStation 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. Use the Other Shipping Options in ShipStation to change billing for a shipment.

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

Enable 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

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

Dry Ice shipping

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

Additional Handling

Enable this option to inform UPS that the package will require special handling. See the UPS page on Additional Charges for more information and restrictions.

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

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

ShipStation will submit international customs information electronically to the carrier.

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

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

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.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

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.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.

UPS Surcharges

When entering your shipments weight and dimensions into ShipStation, they should accurately reflect the size of the package so the rate returned to ShipStation will be the rate you are actually charged for the shipment. Should the dimensions entered into ShipStation 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 ShipStation 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.

Refer to the UPS Tariff/Terms and Conditions of Service – United States for more information.

The over maximum limit surcharge is $920.00 per package. Refer to the UPS Daily Rate and Service Guide for the most up to date information.

Additional Details about the UPS Integration

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

  • UPS End of Day forms (also known as PLD forms) are not available in ShipStation. As a Certified UPS Partner, ShipStation submits all shipment information electronically to UPS when labels are created, so no End of Day process or PLD form is necessary. If you require a manifest for record-keeping purposes, you can create a generic shipment manifest by going to Insights > Reports > Shipping Manifest and running the report for your UPS shipments.

  • ShipStation's address validation tool is not able to 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.

  • Rates for UPS are not yet available in the Rate Calculator.

  • UPS will only display Address Line 1 of the Ship From and Return Addresses. Secondary address information (such as an apartment or suite number) must be added to Address Line 1.

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

  • You can import your UPS Worldship® address book into ShipStation by following the instructions in our Transfer UPS Worldship® Address Book to ShipStation help article.

  • The ability to ship Dangerous Goods is not available within ShipStation. You must go through UPS directly.

UPS Troubleshooting Tips

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

UPS Account Connection Errors

Error

Cause

Solution

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

ShipStation unable to register the account with UPS.

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

Licensing system not available

ShipStation unable to register the account with UPS.

Temporary issue typically related to server maintenance. Check the ShipStation 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 in ShipStation. 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

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

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

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

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

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

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 ShipStation. The UPS Carbon Neutral Shipping Program is not available between all locations.

Go to Settings > Shipping > Carriers & Fulfillment to 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.

ShipStation will submit international customs information electronically to the carrier.

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

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

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.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

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.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.

DDP