How to fix UPS errors

Learn how to solve the issues you may face with UPS

Updated this week

Have you correctly connected UPS but you're facing some issue during label creation? πŸ”

Here's how you can fix them case by case:

πŸ“Œ Failure of Web Server bridge

In this case, try to confirm again the order/s in error a bit later, the error is related to a temporary issue with UPS server.

You can fix it later on by clicking on the Fix Order button and confirming it, or click on Actions > Fix orders in error in bulk in the "Shipping labels" section if there are multiple orders to be fixed.

πŸ“Œ To check: Name and company fields must be shorter than 35 characters.

The Name and Company fields must not exceed 35 characters for labels created with UPS.

πŸ“Œ Postal Code length must be 5 numbers.

The Postal Code must necessarily be 5 digits and must not contain special characters, such as - or /.

πŸ“Œ Province must be in the form of an abbreviation.

In the Recipient State field, you are asked to enter the province in the form of an abbreviation. The province in full form will generate a label in error.

πŸ“ŒUser Id and Shipper Number combination is not qualified to receive negotiated rates.

In this case contract's tariffs haven't been synchronized, so you need to verify your credentials and, if correct, ask UPS to enable rates via API.

πŸ“ŒThe shipper number cannot be used for the shipment.

This Error indicate that the Account Number may be wrong or suspended.

If this message occurs, check with your UPS contact.

πŸ“Œ Invalid product description for product number 1. Product description should be present at least once. Valid range is 0 to 35 alphanumeric

The Product Description field accepts a maximum of 35 characters. Make sure that this number has not been exceeded.

πŸ“ŒMissing or Invalid Notification/Notification Code

In order to solve this error try to disable notifications from Carriers > Connection > UPS > Edit.

πŸ“ŒFailure: Unable to determine destination for Time in Transit Information. / Time in Transit information Unavailable. (111598)

For this type of error you should disable the option View Time in Transit from Carriers > Connection > UPS > Edit and then try to create the label again.

πŸ“Œ Failure: The country associated with Shippers ShipperNumber must be the same as the shipments Shippers country. (120120)

Enable Use your company info as fixed shipper from Carriers > Connection > UPS > Edit to solve this issue.

πŸ“Œ Negotiated rates are unavailable at this time

If this error occurs, UPS server is temporary not able to communicate rates. Please try again later.

πŸ“Œ Failure: Missing or invalid Notification/NotificationCode

You may have received this error for a number of reasons. However, more than likely it's because your shipper number (Account Number) from the Shipping API was not added to your profile.

To verify you have the correct information in your profile proceed as following:

  • Log in to (Be sure to use the same User ID and Password that is in your Shipping API).

  • Select Account Summary from the My UPS tab rollover menu.

  • Verify your account is listed; if not, select the Add a UPS Account link.

  • Follow the instructions to add the account

πŸ“Œ Failure: Invalid Access License number (250003)

This error means that your XML access key is not valid for the server. Double check it and make sure you have production access to the UPS address validation API.

πŸ“Œ Missing/invalid shipper number

In case you receive this error proceed as following:

  • Log in to (be sure to use the same User ID and Password employed for Shipping API)

  • Select Account Summary from My UPS tab rollover menu.

  • Verify whether your account is listed or not; if not, select Add a UPS Account option.

  • Follow the instructions to add your account.

πŸ“Œ Failure: The ShipFrom country must be the same as the Shipper country (120317)

You can fix it in three ways:

  • Access Carriers > Connection > UPS > Edit > flag Use your company info as fixed shipper option.

  • Set that the order you're going to ship is a return label by clicking on the blue arrow before creating it.

  • Through API by adding: "IsReturn": true into the Ship request.

πŸ“ŒFailure: Missing or invalid ship from StateProvinceCode (120306)

In this case proceed to disable Enable Paperless option if active and select Use your company info as fixed shipper from Carriers > Connection > UPS > Edit.

Then proceed to update the shipment by clicking on Edit and Confirm inside Shipping Labels menu.

πŸ“Œ The Shippers shipper number cannot be used for the shipment

If you face this error please get in touch with your UPS Person.

πŸ“Œ The maximum declared amount was exceeded. Maximum value per package: 856 EUR. (121025)

Please keep in mind that the maximum value supported for Returns is 999 USD, to be eventually converted in EURO.

πŸ“Œ Invalid Bill-To type. (120444)

In this case the account number employed for billing is not recognised by UPS.

πŸ“Œ Failure: The selected service is not available from the origin to the destination. (121210)

Please check together with your UPS account manager whether your contract provide for shipments to the destination of the order.

πŸ“Œ Invalid Authentication Information (250002)

This error is shown when the UPS account password does not match the one provided upon account setup (it was reset or changed).

πŸ“Œ Failure: Address Validation Error on ShipTo address (120802)

Please review the recipient's Address, City, Postal code and State fields. This error is generated by UPS validation check whenever one of this fields does not match with the actual address.

πŸ“Œ Note for shipments to the United States: a valid postal code in the USA is composed by 5 digits, no letters.

πŸ“Œ Missing or Invalid Vendor Collection ID Number

In case of this error, make sure that you’ve correctly populated the IOSS number from My Profile > Sender Info section. In case you still cannot solve it, try removing the IOSS number and confirm again the shipment in error.

πŸ“Œ The maximum number of user access attempts was exceeded (250006)

This error is shown when the UPS account password does not match the one provided on Shippypro (it was reset or changed), and you exceeded the amount of retries trying to operate with a wrong password.


1) Check your password on the connection modale

2) Reach UPS to unlock your account.

3) Fix the order
πŸ“Œ Destinantion Ireland Error Message:
Invalid sold to state province code. Valid length is 0 to 5 alphanumeric (128100)

In order to correct the address of a shipment to this particular destination, please replace the postcode data with IED.

β€‹πŸ“ŒFailure: Invalid merchandise description of package (120623)

The item description field is limited to 35 symbols for UPS, check the length of this field and shorten it if necessary.

πŸ“Œ Failure: The UserId is currently locked out, please try again in 30 minutes. (250007)

The error message you're receiving for your UPS shipments is returned directly from the UPS server. In this case, please reach out to your UPS representative or the carrier's customer service to inquire about why your account is blocked.

πŸ“Œ The country associated with Shipper's ShipperNumber must be the same as the shipments Shipper's country

In this case, the customer code used for the connection does not allow the use of a non-domestic sender address, and you would need to check this limitation with your carrier contact.

πŸ“Œ"Failure: Invalid ShipTo AddressLine2 (120203)"

Please notice the maximum number of characters allowed in address field 2 is 35.

πŸ“Œ "Invalid freight charges monetary value. Valid length is 0 to 15 numeric and can hold up to 2 decimal places"

In case you are faced with this error, try to disable the option β€œAdd freight charges to commercial invoiceβ€œ from your connection modal:

πŸ“Œ "To be reprocessed: Failure: The request is well formed but the request is not valid (10002)"

To correct this error we need to remove all special characters from the description of the items being shipped, including the description within document CN22

πŸ“Œ Missing or invalid ship from state province code

Check the information entered in the Sender State/Province field and use the abbreviation for Italian provinces.

πŸ“Œ Missing or invalid ship to state province code

If you get this error, try entering the Province abbreviation or ISO Code (e.g. Barcelona > B, Alicante > A) in the Recipient State/Province field, otherwise try reprocessing the order leaving this field empty.

πŸ“Œ Missing or invalid ship from address line 1

If you get this error with UPSv2, please check that the Sender Address entered:

  • is correctly valid and geolocatable;

  • does not exceed the limit of 35 characters including spaces (35 for Address 1 and 35 for Address 2)

NB: if you have activated the option "Use your company info as the fixed shipper" from the carrier connection modal (Carriers > UPSv2 > Edit), the sender address to be verified will be the one present in "My Profile" > "Sender Info" (the "Address" field must not exceed the character limit and the "House No." field must only contain the house number reference).


πŸ“Œ Missing or invalid ship to address line 1

If you get this error, try to remove any additional information in the Address 2 field to avoid any discrepancies with the courier's street map: the Address 1 and Address 2 fields are in fact merged for the courier, so only use the Address 2 field if it is not possible to enter all characters of the main address in Address 1.
Please note that the character limit allowed in total (Address 1 and Address 2 together) is 35 inclusive spaces.

If you have any doubts, please contact us and we will be happy to help you! πŸ’¬


πŸ“Œ Printing could not be managed for the selected orders, please try again with fewer orders

If you are printing in ZPL with UPS and you are issuing the UPS commercial invoice at the same time, the invoice will always be in PDF, so the two formats won’t match. The label will return error Printing could not be managed for the selected orders, please try again with fewer orders. How to fix it? Please change the settings of the label type = PDF.

πŸ“Œ "Shipment Description is required for this shipment" (or "Missing package description")

In case you're creating a manual shipment and you selected to print the content "Marketplace Order number" from My Profile > Preferences > Content description printed on the labels, make sure to always correctly populate the Order Number field during the shipment creation:

or to populate the "TransactionID" field if you are shipping via API.

πŸ“Œ Shipment Description cannot exceed the length of 50 characters

This error refers to the "sku and quantity" selection in the Preferences section:

The solution is to change the above option by choosing another one such as order number.

πŸ“Œ Point_mode is required when point_id is set and viceversa

If you have selected a Pickup Point ID for delivery via the corresponding Carrier Option, you will also need to select a Pickup Point Mode from those available (Hold for Pickup or Access Point Delivery) and vice versa:

πŸ“Œ International Shipments cannot be voided at the package level

This error means you cannot edit an already created shipment, in this case, please proceed and create a new shipment from scratch.

Did this answer your question?