Troubleshooting Shipping
The Problem
You're expecting a particular shipping method to display for an order and it's not available.
Quick Steps to Troubleshooting
- Login to the merchant portal
- Navigate to the Item Screen
- View the links for the item you're having trouble with
- Click on "open in new window" button
- On the cart screen that appears, click the 'Actual Shipping' link
- Enter location information into the form
- Back on the cart page, click the 'View Packing Solution' link
- Review the packing solution for information.
- Scroll to the bottom and review the section 'No Estimates for Shipping Methods'
No Estimates for Shipping Methods - Reason Codes
- Disabled by merchant.
- Does not meet the valid only for criteria for this shipping method.
- Does not meet the valid only for pricing tier criteria for this shipping method.
- First Class mail must weigh 13 ounces or less.
- Invalid shipping method for [XXXXX] item(s) in the cart.
- Method is not mapped to the third party fulfillment provider.
- One or more of the items in the order does not qualify for USPS: Media Mail.
- One or more of the items in the order does not qualify for XXXX Shipping Method.
- Error: OriginZip is required when DestinationPostalCode and AcceptanceDateTime are populated.
- Package did not meet individual package weight restriction.
- Package exceeds maximum insured value restriction.
- Package exceeds maximum value restriction.
- Shipper did not return an estimate for all of the boxes.
- Shipping method is invalid because (screen branding theme) is one of the invalid for screen branding themes configured on this method.
- The Destination ZIP Code you have entered is invalid.
- This method is not being rated.
- This shipping method is not valid for residential shipments.
- Total shipment did not meet weight restriction.
- Unable to pack items into boxes.
"Not Valid for" reasons
- 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.
- This shipping method is not valid to APO/FPO addresses.
TODO
- Invalid for distribution center [...]
- 6011 - Postal code not served.
- USPS Error: Exceed maximum weight for mail service type. Maximum weight to [...] = [##].
- Shipping method is invalid for shipments sent on [...].
- Error Information: The Destination ZIP Code you have entered is invalid.
- Item [...] requires delivery within [...] calendar days, but delivery will take [...] in transit. Box would ship on [...] and be delivered on [...]
- Customer has invalid pricing tier for this shipping method.
- Error Information: The Origin ZIP Code you have entered is invalid.
- Service not available.
- Saturday delivery not available for the recipient zipcode.
- Error communicating with PeriShip API. Message [...]
- Filtered because [...] is available.
Detailed Steps to Troubleshooting
Here are some screenshots illustrating the steps needs to troubleshoot a shipping method
Login to the merchant portal
Navigate to the Item Screen
View the links for the item you're having trouble with
Click on the "open in new window" button to add the item to the cart
On the cart screen that appears, click the 'Actual Shipping' link
Enter location information into the form
Back on the cart page, click the 'View Packing Solution' link
Review the packing solution for information.
Scroll to the bottom and review the section 'No Estimates for Shipping Methods'
Troubleshooting Shipping while using the BEOE
Within the BEOE tool you can also troubleshoot any shipping issues by using the "View packing solution" option.
You can find BEOE by going to:
Main Menu → Operations → Order Management → Manually enter an order
Once an address and item has been added there will be a section to Calculate shipping. If you click the Calculate button, but no shipping method are returned or you don't see the one you would expect you can use the "View Packing Solution" link to view the details of the shipment.
We will also display just above the link the "Last Calculation Attempt", and the details we got back. In this case there were zero applicable shipping methods found. By clicking on the " View Packing Solution" we can see that the international shipping method for this account have been disabled and no other method are allowed internationally.