Skip to main content
All CollectionsIntegrationsCarrier ConnectionUSPS
Troubleshooting USPS shipping errors
Troubleshooting USPS shipping errors

Common shipping errors and how to resolve them

Updated over 4 months ago

Below is a list of common shipping errors and how to resolve them. However, If you find that you are still encountering any errors when shipping, please contact our Veeqo support team who are happy to help!

Weight, Customs item must be a positive numeric number value 1120 or less
The weight on the item needs to be between 1 or greater but less than 1120


Missing or invalid data element ToPhone

  • You will need to ensure that a customer phone number is entered on the order.

  • If there is a customer phone number added to the order, please check that the Veeqo Dispatch Location that the order is allocated to has a valid and correctly formatted phone number.

Missing or invalid data element. MailClass. Error Encountered
Please check the dimensions and weight for the select shipping option as it might be under or exceeding the limit.


Value, customers item must be a positive numeric value 9999.99 or less
The value of the items must be above 0 as most carriers do not allow items to be 0.00 "i.e" it must at least be 0.01 in your chosen currency


Weight exceeds maximum allowed by mail service
The item has exceeded the weight limit for the service you have chosen. You will need to find an alternative service to ship with.


UNDEFINED:undefined error
1. Make sure that the address fields are filled out and are correct. You can also log into your USPS account to see if you get quotes directly from USPS with the current details within the order.

2. Make sure that the weight field is populated.


Recipient address invalid. The address as submitted could not be found. Please check for abbreviations in the street address line or the City name.
This would mean that the address is incorrect / invalid. You will need to check and verify that the address in Veeqo is correct (alternatively an address validator checker) or you can contact the customer who purchased the item to re-confirm their address details. You can check the address to see if it is correct here:
https://tools.usps.com/zip-code-lookup.htm?byaddress


The total weight of all customs items exceeds the total inputted package weight. Please increase the package weight or decrease the customs items weight. The minimum weight accepted per USPS customs item is 1oz.
For international shipments the total weight of the items can't be more than the allocation/package weight.


Missing or invalid data element: ToPostalCode
You will need to make sure that the formatting and/or information is correct. For example, making sure that the City and State match the Zip Code.


Allocation weight is empty
The allocation / weight attribute needs to be greater than zero


Missing invalid data element: Country of Origin, Customs item #1. Error encountered (LogIn ID:)
The country of origin on the item will need to be set in Veeqo

Shipment was not created. Invalid input.: Requested items can't fit into any existing package, and exceed unshipped item quantities.

This error usually means that the order has been shipped on the store's side, but the status has not yet updated in Veeqo. Check the order on your store to verify, and contact support if this is not the case.


Missing quotes or undefined error message

If you are not receiving quotes from your shipping carrier when trying to ship an order or are receiving an undefined error message, please the following troubleshooting steps:

  1. Customers address - Double check your customers address. You can do this using a carrier address verifier for the carrier you are trying to use.

  2. Customer email and phone number- Check that the customer has an email address and phone number added to the order. Some carriers will not accept a shipment via the API if these are not present.

  3. Total order weight- Check that the order has a total weight added. The weight needs to be above 0.

  4. Maximum weight allowed by the service- Check that the weight you have added for the order can be accepted by the service you are trying to use.

  5. Ship from address - We will use the location you entered in Veeqo as your ship from address. Check you have a valid location address in settings.

My rules have stopped working on certain services

With the launch of USPS Advantage on 9th July there are changes that may effect rules you've applied to certain USPS services.

You'll need to update any rules that set the preferred shipping option to USPS First Class Package, USPS Parcel Select Ground or USPS Parcel Select Cubic:

  1. Go to "Settings" and "Rules"

  2. Select an existing rule that sets the Preferred Shipping Option to USPS First Class Package, USPS Parcel Select Ground or USPS Parcel Select Cubic

  3. Under "Set preferred shipping options" click the drop down and set the Carrier as "Buy Shipping" and the USPS Ground Advantage service you wish to apply for the rule

  4. Click "Update Rule"

  5. Repeat for any other rules that set the preferred shipping option to Amazon Shipping

Did this answer your question?