Have you correctly connected FedEx but you're facing some issues during label creation? Here's how you can fix them case by case:
Document is Invalid
Document is Invalid is usually linked to a missing match between the first upload call and the actual shipping call.
What can I do to fix the issue?
As a first thing, verify here that the country you're shipping to supports ETD Documentation.
If it's not the case, check whether the same Document ID has been already used for other shipments.
Inactive customer account
If you ever happened to encounter Inactive customer account error message for a Fedex shipping we invite you to directly contact Fedex Customer Service in order to inform you about the origin of the issue. 🔎
Then, you can update your shipments on ShippyPro by clicking on Actions > Fix orders in error in bulk from Shipping Labels section.
Return: Number of packages exceeds maximum
If you're facing "Return: Number of packages exceeds maximum" with your Fedex shipments, here's why!
It's an issue concerning, as you can imagine, returns. Fedex in fact doesn't accept 2 packages for Returns.
You can always proceed to create a new manual return label for your shipment.
Total commodities weight is greater than package or shipment weight
If you enter a total weight and ship outside the EU, ShippyPro divides the weight by the number of items and approximate it. The total doesn't match and FedEx shows up an error message.
You can solve it by increasing the total weight manually.
Error Messages
If you are receiving "Invalid booking confirmation number", you need to contact your FedEx account manager and ask for a booking pickup number, which you have to insert in the Carrier Options "Booking Confirmation Number".
The Option is available only with the following shipping services:
Please read the article How can I add Carrier Options to my shipments?
Missing or invalid postalCode
In case you obtain this error when booking a pickup with FedEx, please check whether the postal code has been correctly inserted and you used the right format. If all checks out, you should reach out to your FedEx representative to verify if you're authorized to organize pickups from the selected country.
There was an error uploading ETD to FedEx: Authentication Failed. Please try uploading a new ETD for this order''
We suggest you to contact your FedEx account manager in order to check your account settings and verify whether they have activated your API for Paperless shipments.
There was an error uploading ETD to FedEx: The file you entered is corrupted by a virus and cannot be uploaded. Please use virus scanning software to sanitize the file prior to submitting it.. Please try uploading a new ETD for this order.
If you receive this error, our suggestion is to scan the file using an antivirus program. In case it does not work, to generate and upload a new file.
Error: fault
If you come across the error message "fault" after the shipment has been created, it means that we have received an item's quantity in the form of a decimal number (e.g. 1.5) instead of in the form of a whole number (e.g. 1). To correct the error, you will first have to verify that the quantity of items contains an integer number and then correct the shipment.
Customer is cash only
The account being used may be associated with an expired credit card or have some other billing-related issue. Failure to keep the FedEx Account current may result in the account being placed on a "cash only" status.
Packaging type missing or invalid
Not all Fedex service and package type combinations are supported, please ask FedEx which package you should use in combination with your service(s).
Incomplete commodity description 1
Fedex does not accept generic descriptions within the CN22 document.
A generic 'pants' will not be accepted, while 'Jeans Pants' will.
I dati inseriti nel parametro NONE sono invalidi. Azione di riferimento: NONE
FedEx doesn't allow all special characters on the labels. To solve this error, you can cancel the special characters from the label request, paying particular attention to the Notes and Item Description field.
Length, width, and height must be greater than 0 for package 1
If you are shipping from the USA or Canada, please check if the dimensions you indicated for the parcel are all greater than 0 when converted to inches (each dimension should therefore have a minimum value of 3 cm).
Airbill is not allowed for Destination Country
If you receive this error, the shipping service selected may not be available/allowed for the specific destination country in question. In this case, check directly with the courier for the most suitable shipping service for this destination or try selecting 'All Services' from the carrier connection modal (Carriers > FedEx > Edit > Service > “All Services”).
Package X - Dimensions exceed length and girth limit allowed
X would refer to the problematic parcel that's causing the error (e.g. if the second parcel is not accepted, it would say "Package 2").
This error means that the package dimensions are not conforming with the limitations imposed by the carrier for that particular service. You can find more information on the FedEx General Parcel Guidelines at this link: https://www.fedex.com/content/dam/fedex/us-united-states/services/GrlPkgGuidelines_fxcom.pdf
Resources unavailable to service request
The carrier's server could be down. Please wait and try to fix the orders in error later.
Fedex invalid customs value
If you encounter this error it means that:
The Total Sales field inside the order and the Unit Value in the CN22 should match.
The minimum amount required is 1 €
Special service SIGNATURE_OPTION is invalid
This error happens because Indirect Signature can only be requested for residential addresses. We recommend contacting FedEx and possibly shipping with this option directly with them.
"Weight - weight must be greater than 0 in Commodity…"
When shipping packages containing more than one item with FedEx, pay attention to the weight: in the Parcels section, you need to add the total weight of the parcels, while in the details of the CN22 section, under "weight," you should enter the weight and unit price of each item.
The sum of the weights of the parcels and the sum of the weights of items in the CN22 must match.
Meter number is not registered
Go in the Carrier section and remove the flag on the "test mode" option.
"weight.value is missing or invalid" during pickup request
Fedex allows pickup booking for parcels weighing more than 65kg only through their portal, so you will have to go to the courier's portal and book the pickup directly from there.
International Shipments cannot be voided at the package level
This error means you cannot edit an already created shipment, in this case please proceed and create a new shipment from scratch.
Destination country does not accept international non-document shipments
The error indicates that for the entered destination (e.g. Andorra) taxable shipments, i.e. anything other than document shipments, are not valid.
Commercial Invoice is Required
This usually means that no commercial invoice (necessary for all international orders) has been uploaded - However, if this happens even you have uploaded the invoice correctly, try uploading your company logo in the Sender info section of your profile and do the same in your FedEx profile, making sure they match - Once this has been done, try correcting the order using the “Fix order” button.
"FedEx International Priority is deprecated and no longer available. Please select another service"
You can correct it by selecting the "FedEx International Priority" service instead of International Priority service
The order of the parcel dimensions you see on the label (LxWxH) cannot be modified - it's how the carrier returns it to us.
PAYMENT.PAYORCOUNTRY.INVALID
If you experience this error, you are trying to ship from a country not compatible with your FedEx account (e.g. you have a US account and you are trying to ship from a European country)
SPECIAL_SERVICE_TYPE-CODORGORDEST.SPECIALSERVICES.NOTALLOWED
If you experience this error, you are requesting the Cash on Delivery (COD) service. Please note that FedEx COD service is no longer available in USA and Canada and only partially available in the rest of the world. Contact your FedEx Account Manager to know more about this service.
FedEx does not support insurance. Please use Declared Value carrier option instead
If you experience this error, you are requesting insurance on a shipment. FedEx does not provide insurance. Alternatively, you can use FedEx Declared Value (see further information at paragraph 4 above ☝️). Follow this link to know more about Declared Value.