Rate errors and label errors are the main error types you may encounter when creating labels for your shipments. Such errors will prevent you from creating a label and these often occur because some required information is missing from the configuration. For example, UPS and DHL require a company name in the Ship From address. Without this information, you cannot create a label. This page lists common errors and how to attempt to resolve them.
Errors vs Warnings
In ShipStation, warnings don't stop you from creating shipping labels. They exist to bring something to your attention that might influence your shipping decision.
When you're unable to proceed, that means you have an error rather than a warning. An error blocks you from creating a shipping label and requires you to make some kind of change before you can successfully create a label.
|
Error Message |
Typical Cause |
How to Resolve |
|---|---|---|
|
Rate Error While trying to get a rate, the following rate alert messages may occur:
|
The shipment detail shown in the rate alert has not been set yet. ShipStation requires all four shipment details to create a label successfully. |
Set the missing values for the shipment. |
|
The lines[0] must not be longer than 40 characters. Field: shipments[0].to.destination.lines[0] |
The first address line (Address Line 1) of the Ship To address exceeds the 40-character limit. |
Edit the Ship To address so that Address Line 1 contains fewer than 40 characters. You can also move information to Address Line 2 or 3 if needed. |
|
Address Line 1 cannot exceed 50 characters. |
The first address line (Address Line 1) of the Ship To address contains more than 50 characters. |
Edit the Ship To address so that Address Line 1 contains fewer than 40 characters. You can also move information to Address Line 2 or 3 if needed. Possible Truncated AddressSome carriers will still allow you to create the label even if Address Line 1 contains more than 50 characters. However, the address will be truncated beyond the character limit. |
|
ShipStation only supports domestic return labels. APO, FPO, and DPO addresses are not supported. |
ShipStation cannot create return labels for U.S. territories or APO/FPO/DPO addresses, as they require customs information for shipping. |
Do not include a return label when creating shipments bound for a military or diplomatic address. |
|
Return Services are unavailable with the requested service. |
Not all carriers/services can be used for return labels. |
Review the Integrations Help Guide for your carrier for details. Details about Return Labels are in the Available Features section within each carrier's article. |
|
Selected service is not compatible with other settings (package type, weight, size) |
The service, package, weight, dimensions, or Other Shipping Options selected for the shipment are not compatible with each other. |
Review the shipment details to pinpoint the invalid shipment settings. You may need to refer to the carrier's service guide for details on allowed package types, dimensions, and shipping options. |
|
The mail class [X] cannot be used with package type [Y] for domestic mail. or The mail class [X] is not available for [Y] |
The selected shipping service and package type are not compatible with each other. |
Adjust the shipping service or package type as needed. You may need to refer to the carrier's service guide for details on which package types are compatible with which services. |
|
You have selected an invalid shipping service type for this address. |
The selected shipping service is not a valid option when shipping from the Ship From address to the Ship To address. For example, you attempt to use a domestic shipping service for an international shipment. |
Select a valid service for the shipment. You may need to refer to the carrier's service guide for details on allowed shipping services for the shipment destination. |
|
Dimensions are required in order to calculate the rate. |
The selected shipping service requires dimensions, but dimensions have not been added to the shipment details. |
Add package dimensions to the Size area of the shipment details. To ensure you receive an accurate rate, please use the actual package dimensions. |
|
Recipient address has not been verified. |
Address validation has not been performed on the Ship To address for this shipment. |
Click the Validate Address link next to the Ship To address in the Order Details screen. |
|
This field is required to ship to Mexico. |
Mexico requires a summary of contents in the Package Description field. This requirement is called Carta Porte. |
Enter a summary of the package contents (35 characters maximum) into the Package Contents field in ShipStation. You can then successfully create your shipping label. |
|
Inventory Unavailable. Insufficient inventory to fulfill these items. |
The order includes a product with a higher quantity than the available inventory for the product. |
Click Admin Override to ignore inventory levels entirely. No stock will be deducted from your existing inventory levels. You can manually adjust your stock levels if needed. |
|
Missing or invalid ship from company name |
Your ShipStation Ship From Location is missing a Company Name. |
Some carriers, like UPS, require a Ship From Company Name for some services. You can either add a Company Name to your Ship From Location address in your ShipStation account settings or add a Company Name in the Branding tab of your store's settings. |
|
When attempting to get a rate, no error message appears but no rate is displayed after clicking Get Rate. |
ShipStation is unable to get rates for the shipment, either because the carrier/service does not support estimated rates or you have applied a shipping option (like third-party billing) that prevents ShipStation from displaying estimated rates. |
Continue to create the label as normal. Even though ShipStation cannot get rates for the carrier/service, you can still create the label successfully. If the label creation fails, you'll see a more defined error message that can help you pinpoint the issue. |
|
No customs items have been created for international order. |
The shipment requires customs information but no customs information has been added. |
Review the customs declarations for the shipment and add at least one customs declaration line with a valid description, quantity, and value. |
|
Please add a description for your Customs Item(s). |
A customs declaration has been created for the shipment but is missing the description. |
Review the customs declarations for the shipment and add a Description for each item in the declaration. |
|
Customs contents type not set for international order. |
You have not set the Package Contents option for the customs declaration. |
Review the customs declarations for the shipment and set the Package Contents option. In most cases, the Package Contents should be set to Merchandise. |
|
Non-delivery option not set for international order. |
You have not set the If Non-Delivery option for the customs declaration. |
Review the customs declarations for the shipment and set the If Non-Delivery option. |
|
Customs item is missing quantity. |
The quantity is set to 0 for an item in the declaration. |
Review the customs declarations for the shipment and add a Qty for each customs line. |
|
Invalid package type for carrier(s) provided. |
You are attempting to use a package type that is not available with the service class. |
Review your selected package type and service class to select an available package appropriate for your shipment. |
|
Ship From Name must contain at least two words. Each word must be at least two characters long, separated by a space or Recipient Name must contain at least two words. Each word must be at least two characters long, separated by a space. |
You are attempting to ship an international package with USPS and the Name fields in your Ship From address do not contain two words for each name. |
Review your Ship From address and make sure the Name fields contain at least two words, with each word at least two characters long. |
|
XML Shipping System is unavailable |
One or more item SKUs exceed the 35 character limit. This typically occurs with international shipments that have customs declarations. |
Shorten any item SKU that is longer than 35 characters. |