This article covers the more common warnings and error you may encounter when using Shippo.
"Unable to Validate Address"
When you see the error "Unable to Validate Address", you can troubleshoot the address directly on the USPS website. If the address is a U.S. address you can use this link: https://tools.usps.com/go/ZipLookupAction_input
Some of the most common causes for an invalid address are:
- "Name" field only has one name (must have at least two; a first and last name, or a two part company name)
- Missing suite/apartment/unit number
- Missing house/building number or incomplete street name
- Use of non-English characters like "ñ" or "街頭"
- Suite/apartment/unit number/etc on the wrong line, should be on ‘Street 2’, not ‘Street 1’
- The street name is misspelled or missing information
- Ex: ‘Woodburt’ instead of ‘Woodburn’
- Ex: 'Cavanaugh' instead of 'Cavanaugh St.'
- Street name and suffix all one word, should be two words
- Ex: ‘Hill St’ instead of ‘HillSt’
- Too much information is included in street address
- Ex: ‘8550 NW 51st Street Lauderhill’ instead of ‘8550 NW 51st Street’
- Company name included in ‘Street 1’
- Ex: ‘Company Name LLC 2269 Chestnut St’ instead of ‘2269 Chestnut St’
- Using symbols instead of writing out words
- Ex: ‘Lewis & Clark Rd’ instead of ‘Lewis and Clark Rd’
- Abbreviations used when they shouldn’t be
- Ex: ‘Co Rd 704’ instead of ‘Country Road 704’
- Ex: ‘ACR 425’ instead of ‘Country Road A 425’
- Missing the 4-digit zip code extension
- Ex: ‘10009’ instead of ‘10009-4153’
If you're still not seeing what the error is, trying Googling the address, and compare how the address appears in Google Maps to how it looks in Shippo. Ultimately, if you cannot determine the correct address, you may need to contact your customer to verify the address with them.
Military addresses can also be tricky. If you’re having trouble validating a military address, you can find the correct formats for APO, FPO, and DPO addresses here. If the format is correct and the customer confirms the address is valid, the issue might be with the address validation system. We use USPS' validation tool and their database is usually a month out of date. If this is the case, please contact us.
"No Rates Have Been Found"
The most common reasons for this error are:
- Incorrect zip code
- The package dimensions or weight exceed the restrictions set by the carriers you've activated
- A Flat Rate or Regional Rate package has been chosen but isn't available for this particular shipment
- The carrier's system is temporarily unavailable or not responding
Please check the dimensions and weight of your package, as well as the city/state/zip code combination, to resolve this issue. If all of that information is correct, or if you're getting that same error message for multiple different orders, please contact us.
"An error occurred when creating the label."
This error is typically just a temporary connection issue. Please wait a few minutes and try again, and you should be able to create the label.
When you see any of the following error messages when trying to get rates:
CanadaPost: AAA Authentication Failure
UPS (250002): Hard: Invalid Authentication Information
DHL: 'Invalid fieldlength in element 'PartnerID'
It means there is something incorrect in the account credentials you have entered for a given carrier.
Please refer to this article for more information on how to correctly enter your account credentials for different carriers.
"There was an error processing your shipment..."
When you see this error message when searching for rates it could be for a few different reasons.
This indicates there is missing or incorrect information in the package details you entered. Most likely, some address details are not in the correct fields, or have been entered incorrectly. Some examples of what could cause this are:
- If there is an invalid character in the email address, for example if you entered "firstname.lastname@example.org/" with the extra / character by mistake instead of email@example.com
- If the state in a US address is written out as the full name instead of the 2-letter abbreviation, so "Colorado" instead of "CO." The 2-letter abbreviation should always be used in Shippo.
- If the phone number is missing for an international or military address
You can correct any address errors by clicking "Edit" next to either the recipient or the sender address on Step 1 of label creation.
"Default Payment Method" (Canada Post)
This error indicates that Canada Post thinks that there is no valid, default credit card saved for your account.
There are three types of Canada Post accounts: standard, contract/credit card and contract/billing.
This error can occur if:
- You have a billing account but you've selected “credit card” as your Canada Post payment method.
- You're a credit card customer, but the card you have on file with Canada Post is invalid or expired.
- You have a standard account, not a contract account, but you've put a value into the “contract ID” field.
- You have a contract with Canada Post but have not entered your contract information.
Please double check your Canada Post account information in order to correct this issue.
"The sender address must contain a first and last name, or a company name must be added"
This error message refers to the sender/return address in Shippo. USPS will return an error if the sender or recipient information is incomplete.
On international labels, the name for both the sender and the recipient address must follow a strict format of a "first name" and a "last name" and both must have more than one character. These do not have to be your actual first and last name but can be your business name. For example, instead of just "Shippo" in the first name field, "Shippo Inc." could be used to complete both fields.
"Ascii Codec Can't Encode Character"
This error indicates that there's a character or symbol in part of the label information that the carrier can't process. Typically this is something like ® or ™ in the lines of text you can add to a label under "Settings" in Shippo, but it could be in the address information as well.
"Missing or Invalid: IntegratedFormType. Error encountered."
This error indicates that you have not entered a customs item for an international shipment. At least one customs item is required in order to create the documents needed for international shipments.
"Missing or Invalid: ContentsType. Error encountered."
This error indicates that you have chosen an incorrect option from the "ContentsType" menu on the Customs page for an international shipment, most often "Return Merchandise." "Return merchandise" is not authorized for use to many countries, and with several service levels - using "Merchandise" instead will solve the problem.
"Selected Services Do Not Apply"
When you see this error message at the bottom of the rates page and no rates are returned:
Error calculating postage rates for one or more mail classes: First Class Mail International:  Selected services do not apply. Error encountered (Log ID: 22903) Priority Mail International:  Selected services do not apply. Error encountered (Log ID: 22903) Priority Mail Express International:  Selected services do not apply. Error encountered (Log ID: 22903) Global Express Guaranteed:  Selected services do not apply. Error encountered (Log ID: 22903). Error encountered (Log ID: 22903)
This indicates that you have selected a service that's not available for the type of shipment you're doing. This happens most often when signature confirmation is selected for an international shipment, which USPS does not offer.
"The minimum weight accepted per USPS customs item is 1 oz."
This indicates that you have entered a customs item weight that is less than 1 oz.
Customs item weights cannot be less than 1 oz. If you are shipping multiple smaller items weighing less than 1 oz, you can consolidate your customs items into one listed item.
To do this, create a single customs item that contains the total weight of all the customs items, and delete any other customs items included on your customs form. This will ensure that the weight of the items doesn't go over the total weight you entered for the package on step 1 of label creation.