How to fix UPS errors
Learn how to solve the issues you may face with UPS
Updated over a week ago

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.

πŸ“Œ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.

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 Address, 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 > Invoice 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.

Done! πŸŽ‰

Did this answer your question?