Shipping Error Messages
- 1 Introduction
- 2 "This shipping method is not valid for ... shipment"
- 2.1 Error Messages
- 2.2 Explanation
- 2.3 Remediation
- 3 "Invalid shipping method for item in the cart" / "One or more of the items in the order does not qualify for Shipping Method"
- 4 "Does not meet the valid only for pricing tier criteria for this shipping method"
- 4.1 Explanation
- 4.2 Remediation
- 5 "Shipper did not return an estimate for all of the boxes"
- 5.1 Explanation
- 5.2 Remediation
- 6 When No Shipping Estimates Appear
- 7 Related Documentation
Introduction
This page documents common shipping method error messages that appear when a shipping method is unavailable at checkout. Each section covers a specific error reason code, its explanation, and remediation steps where applicable.
These errors typically surface in the No Estimates For Shipping Method section of the checkout or order review screen.
See Also: If no shipping estimates appear at all (rather than a specific error), see Why Are My Shipping Estimates Not Displaying During Checkout? For step-by-step diagnostic instructions, see Troubleshooting Shipping.
"This shipping method is not valid for ... shipment"
Error Messages
This shipping method is not valid for international shipments.
This shipping method is not valid for domestic shipments.
This shipping method is not valid for P.O. Box shipments.
This shipping method is not valid for United States shipments.
This shipping method is not valid for residential shipments.
This shipping method is not valid for business shipments.
This shipping method is not valid to continental US.
Explanation
The shipping method has geographic or address-type restrictions that exclude the destination on this order. For example, UPS does not deliver to P.O. Boxes, and USPS First Class International is not valid for domestic addresses. FedEx Ground does not ship to residential addresses; FedEx Home Delivery must be used instead.
Remediation
No action is required. This is expected behavior — the shipping method legitimately cannot deliver to that address type. The method will remain unavailable until the customer provides an eligible address, or you configure an additional method that covers the destination.
"Invalid shipping method for item in the cart" / "One or more of the items in the order does not qualify for Shipping Method"
Explanation
Certain shipping methods are only valid for specific product types. The classic example is USPS Media Mail, which only accepts books, recorded media, and a few other categories.
If one or more items in the cart do not meet the product-type requirements of the selected shipping method, this error is shown.
The reason code may also appear as: One or more of the items in the order does not qualify for USPS: Media Mail
Remediation — Path 1: Method Specific Options
If the product should qualify for the restricted shipping method, update its eligibility flags in the Item Editor.
Navigate to: Home → Items → Item Management
Locate and open the item by clicking its Item ID or the pencil icon.
In the Item Editor, click the Shipping tab, then click Method Specific Options.
Adjust the flags as needed to allow this item to use the shipping method, then click Save.
Remediation — Path 2: USPS Media Product Type (for USPS Media Mail)
For USPS Media Mail specifically, navigate to the item in Item Management, then scroll to the Advanced section at the bottom of the Item Editor. Locate the USPS Media Product Type field, select the appropriate product type, and click Save. Retest the cart.
"Does not meet the valid only for pricing tier criteria for this shipping method"
Explanation
The customer's order is not within a valid pricing tier for this shipping method. Pricing tiers can restrict a shipping method to customers assigned to specific pricing levels.
Remediation
Navigate to: Configuration → Checkout → Shipping
Click the Methods tab, then click Edit on the shipping method in question.
Click the Restrictions tab and scroll down to the Pricing Tiers section. Adjust the radio buttons as needed, then save and retest.
If you also need to adjust the pricing levels on your pricing tiers, navigate to: Configuration → Items → Pricing Tiers
"Shipper did not return an estimate for all of the boxes"
Explanation
The shipper did not think it could use that method for the address supplied. For example, if you ship product from Iowa and enter an address in California, USPS will not return an estimate for International Shipping since it does not apply to a domestic address.
Remediation
If the address is correct, this cannot be fixed — it is expected behavior. The carrier simply does not service that combination of origin, destination, and shipping method.
When No Shipping Estimates Appear
Real-time shipping methods calculate costs by sending package weight, dimensions, and address details to the carrier's API, which returns estimates for each configured method. Because these methods rely on external API calls, server timeouts and outages can occur.
Check Carrier API Status
The first thing to check is whether the carrier's servers are up:
https://www.shippingapimonitor.com/
Test in Troubleshooting Mode
If the carrier server appears up, test the checkout scenario directly:
Navigate to your storefront to initiate a shopping cart checkout, or
Use View All Orders (In Any Stage) to locate the order, then view the packing solution or clone the order to the BEOE to inspect the Packing Solution link — which appears just below where the estimates would display.
If you are still unsure of the issue, see Troubleshooting Shipping for a detailed diagnostic walkthrough.
Proactive Steps When a Carrier API Is Down
USPS API outage: Disable U.S.P.S. Address Standardization from the checkout process by checking the appropriate checkbox on the Checkout Options tab in the shipping configuration area.
Any carrier outage: Change the shipping method cost calculation from real-time to one of the non-real-time calculation options.
Related Documentation
Why Are My Shipping Estimates Not Displaying During Checkout?