Carrier - FedEx Troubleshooting Tips

Overview

If you are receiving error messages related to FedEx shipments, the article provides the troubleshooting tips to help you resolve the issue.

Error messages

data.shipment.parcels is invalid, the total price of the item should >= 1 for ARM, AUS, AZE, BLR, CAN, CHN, CZE, GEO, IDN, JPN, KGZ, MDA, NZL, NCL, PNG, PHL, RUS, SVK, TKM, UZB

Countries that required the total price of the item to be >=1
ARM	Armenia
AUS	Australia
AZE	Azerbaijan
BLR	Belarus
CAN	Canada
CHN	China
CZE	Czech Republic (Czechia)
GEO	Georgia
IDN	Indonesia
JPN	Japan
KGZ	Kyrgyzstan
MDA	Moldova
NZL	New Zealand
NCL	New Caledonia
PNG	Papua New Guinea
PHL	Philippines
RUS	Russia
SVK	Slovakia
TKM	Turkmenistan
UZB	Uzbekistan

What does it mean

The total price of the item in your shipment's parcels has an invalid value.

How to solve

Admin UI

Make sure that the package price you have entered is a valid value. To edit the item price, go to your AfterShip Shipping admin > Awaiting shipments > Select an order > Edit the item(s) > Verify/edit the parcel unit price.



Shipping API

Ensure that the shipment.parcels.items.price.amount field has a valid value.



Please verify the price of your items and ensure they meet the minimum requirement for the specified countries listed above.

data.service_type is not available for this shipment, please select an appropriate and acceptable service type

What does it mean

It typically indicates that the service you are trying to select or access is currently unavailable or restricted. For example, you selected a service type that can't be used for your destination, or your account settings have some limitations for this.

How to solve

Based on your shipment information, you can go to the FedEx rate calculator to confirm if it has any available service type for your shipment.

Check account settings, ensuring that your FedEx account settings allow access to the desired service.

Consider using alternative services: If the specific service you need is unavailable, explore alternative shipping options provided by FedEx or other courier services. FedEx usually offers a range of services with varying delivery speeds and features, so you might find an alternative option that suits your requirements.

Contact FedEx customer support: If you have checked the above steps and the issue persists, it's best to reach out to FedEx customer support directly.

data.shipment.parcels.0.weight is invalid, parcel weight must be greater than the total weight of the items

What does it mean

The parcel weight must be greater than the total weight of the items.

How to solve

If you are using the AfterShip Shipping API, ensure that the shipment.parcels.weight.value must be greater than the total weight of the items.



If you are using our app to process your shipment, make sure that the parcel weight must be greater than the total weight of the items.

data.shipment.parcels.0.box_type is not available for this shipment, the weight or dimensions of the parcel do not meet the requirements

What does it mean

Typically, the API provides information about the dimension limitations for different box types. However, please note that these limitations may vary depending on the specific routes. For instance, when shipping from HK to US, the possible box types could include: "FedEx® 10kg Box," "FedEx® 25kg Box," "FedEx® Box," "FedEx® Envelope," "FedEx® Pak," and "FedEx® Tube."

To double-confirm these details, you can refer to this link.

How to solve

Check if the box_type you are using meets the dimension or weight requirements

Box Name (Admin)	Box Type (API)	Dimension	Weight (lb)	Link
FedEx® Envelope	fedex_envelope	9.252in x 13.18in	1.1	FedEx Envelope
FedEx® Box	fedex_box	N/A	N/A	FedEx Box
FedEx® Pak	fedex_pak	11.75 in x 14.75in	5.5	FedEx Pak
FedEx® Tube	fedex_tube	38in x 6in x 6in x 6in	20	FedEx Tube
FedEx® 10kg Box	fedex_10kg_box	15.81in x 12.94in x 10.19in	22	FedEx 10kg Box
FedEx® 25kg Box	fedex_25kg_box	21.56in x 16.56in x 13.19in	55	FedEx 25kg Box
FedEx® Small Box	fedex_small_box	12.25in x 10.9in x 1.5in	20	FedEx Small Box
FedEx® Medium Box	fedex_medium_box	13.25in x 11.5in x 2.38in	20	FedEx Medium Box
FedEx® Large Box	fedex_large_box	17.88in x 12.38in x 3in	20	FedEx Large Box
FedEx® Extra Large Box	fedex_extra_large_box	11.88in x 10.75in x 11in / 15.25in x 14.13in x 6in	20	N/A
Custom	custom	N/A	N/A	N/A

For the API

For your shipment, please ensure that the shipment.parcels.box_type must meet the requirements.



For the admin UI

Choose the right Package according to weight and dimension constraints.

There is an error when create shipper account: Invalid billing address

What does it mean

The most common cause of account creation failure is when the provided address does not match FedEx's records. For example, if you registered with a billing or shipping address that does not match what is entered in AfterShip Shipping, it will result in an Invalid Billing Address error.

How to solve

Please go to FedEx Billing Online portal under MyOptions/Manage Payment Preferences and update your address accordingly

Updated on: 09/10/2024