Come risolvere gli errori FedEx: i codici di errore FedEx più comuni

Perché vedo l'errore “Total commodities weight is greater than package or shipment weight”?

Se inserite un peso totale e spedite fuori dall'UE, ShippyPro divide il peso per il numero di articoli e lo approssima. Il totale non corrisponde e FedEx restituisce un messaggio di errore.

Potete risolvere aumentando manualmente il peso totale.

Perché vedo l'errore “Packaging type missing or invalid”?

Non tutte le combinazioni di servizio e tipo di imballaggio FedEx sono supportate: chiedete a FedEx quale imballaggio usare in combinazione con i vostri servizi.

Perché vedo l'errore “Length, width, and height must be greater than 0 for package 1”?

Se spedite da USA o Canada, verificate che le dimensioni indicate per il collo siano tutte maggiori di 0 una volta convertite in pollici (ogni dimensione deve quindi avere un valore minimo di 3 cm).

Perché vedo l'errore “Package X - Dimensions exceed length and girth limit allowed”?

X indica il collo che causa l'errore (ad es. se il secondo collo non viene accettato, comparirà "Package 2").

Questo errore significa che le dimensioni del collo non rispettano i limiti imposti dal corriere per quel determinato servizio. Trovate maggiori informazioni nelle FedEx General Parcel Guidelines a questo link: https://www.fedex.com/content/dam/fedex/us-united-states/services/GrlPkgGuidelines_fxcom.pdf

Perché vedo l'errore “Weight - weight must be greater than 0 in Commodity…”?

Quando spedite con FedEx colli che contengono più di un articolo, fate attenzione al peso: nella sezione Parcels dovete inserire il peso totale dei colli, mentre nei dettagli della sezione CN22, alla voce "weight", dovete inserire il peso e il prezzo unitario di ciascun articolo.

La somma dei pesi dei colli e la somma dei pesi degli articoli nel CN22 devono corrispondere.

Perché vedo l'errore “COMMODITYWEIGHT.GREATERTHAN.PACKAGEWEIGHT - Total commodities weight is greater than the package weight. Please check each commodities weight entered."?

L'errore compare se il "peso totale" è uguale alla somma dei pesi dei prodotti nella spedizione. FedEx si aspetta che nel campo "peso totale" sia incluso anche il materiale di imballaggio.

Provate ad aumentare il valore nel campo "peso totale" e a rielaborare la spedizione.

Perché vedo l'errore “PACKAGE_INDEX - 1 WEIGHT - 68.01 WEIGHT_UNITS - KG WEIGHT.BELOWMINIMUMLIMIT.ERROR - The weight entered is below the standard minimum for FedEx {package} Express services. Please enter a weight of at least 68.01 KG."?

Per utilizzare il servizio Freight, il peso indicato deve essere superiore a 68 kg per singolo collo, oppure le dimensioni del collo devono corrispondere a un peso volumetrico superiore a 68 kg.

Perché vedo l'errore "The sum of the weights of items exceeds the total weight of the parcels. Please fix the weights and try again."?

Ricordate che il peso totale del collo deve essere leggermente superiore alla somma dei valori degli articoli dichiarati nel CN22, perché FedEx deve considerare anche il peso dell'imballaggio.

Perché vedo l'errore "Package 1 - YOUR_PACKAGING cannot exceed the limit of 68.00 KG."?

Riducete il peso totale dei colli e dei singoli articoli, se è presente un modulo CN22.

"The parcel weight is less than the total weight calculated from all items (unit weight × quantity)"

Il sistema ha rilevato un'incongruenza tra il peso dichiarato del collo e il peso totale degli articoli (peso unitario × quantità). Se gli articoli pesano più del collo, il corriere rifiuterà la spedizione.

Verificate il peso effettivo del collo (imballaggio incluso), controllate la quantità degli articoli e aggiornate l'ordine su ShippyPro assicurandovi che il peso del collo sia uguale o superiore al peso totale degli articoli.

Perché vedo l'errore “Error: fault”?

Se compare il messaggio di errore "fault" dopo la creazione della spedizione, significa che abbiamo ricevuto la quantità di un articolo sotto forma di numero decimale (ad es. 1.5) invece che di numero intero (ad es. 1). Per correggere l'errore, verificate prima che la quantità degli articoli sia un numero intero e poi correggete la spedizione.

Perché vedo l'errore “Incomplete commodity description”?

FedEx non accetta descrizioni generiche all'interno del documento CN22.

Una descrizione generica come 'pants' non verrà accettata, mentre 'Jeans Pants' sì.

Perché vedo l'errore “COMMODITY_INDEX - 1 COMMODITY.DESCRIPTION.REQUIRED - A commodity description is required."?

Assicuratevi che ogni articolo dell'ordine abbia un nome corrispondente importato dal Marketplace.

Se manca il nome di un articolo, aggiungetelo nel Marketplace e attendete che l'ordine venga reimportato con i dati completi.

Perché vedo l'errore "COMMODITY INDEX - 1 CUSTOMS.DESCRIPTION.INCOMPLETE"?

FedEx richiede che le informazioni doganali siano il più dettagliate possibile entro 35 caratteri: descrizioni come "gift" vanno evitate.

Non c'è un minimo richiesto, ma FedEx può ritenere la descrizione incompleta se troppo generica.

Perché vedo l'errore "COMMODITY_INDEX - 1 SHIPMENT.COMMODITYDESC.VAGUE.NOTALLOWED - The description for commodity 1 is vague and is not allowed"?

FedEx si è allineata alle normative della Commissione Europea e ora richiede che ogni ordine includa una descrizione dettagliata e specifica della merce. Aggiornate il vostro ordine inserendo una descrizione chiara e conforme sia nei dettagli dell'ordine sia nei dettagli del CN22.

Se vi servono indicazioni su come compilare correttamente la descrizione dell'articolo, potete consultare:

• la documentazione ufficiale della Commissione Europea con esempi di descrizioni non accettabili e le relative alternative corrette;
• il video tutorial di FedEx con consigli pratici per inserire una descrizione conforme;

Se il problema persiste, accedete al vostro profilo e verificate se in Preferences > Custom Value l'opzione è attiva. In tal caso, potete aggiornare i dati inseriti o selezionare un'altra preferenza.
Assicuratevi inoltre di non selezionare Order Numbers, ma di trasmettere una delle altre opzioni.

Perché vedo l'errore “FedEx invalid customs value”?

Se riscontrate questo errore significa che:

• Il campo Total Sales dell'ordine e lo Unit Value nel CN22 devono corrispondere.
• L'importo minimo richiesto è 1 €

Perché vedo l'errore “EXPORTDETAIL.DATA.MISSING - Export detail data is missing in this shipment. Please update and try again"?

Questo errore indica che dovete compilare il parametro B13A, richiesto dal corriere in questi casi. Dovrete aggiungere la seguente Carrier Option:

Qui trovate ulteriori dettagli dal sito FedEx su quando è richiesto il B13A: FedEx | System Down

Perché vedo l'errore "TOTALCARRIAGEVALUE.EXCEEDS.CUSTOMSVALUE"?

Verificate che il valore totale dell'ordine, il totale nel CN22 e il Declared Value corrispondano.
Se riscontrate questo errore, provate ad aumentare leggermente l'importo TotalValue e poi a ritentare la spedizione.

Perché vedo l'errore "TOTALCUSTOMSVALUE.REQUIRED - Customs Value is required field."?

Per questa spedizione sono richiesti i documenti doganali. Se avete bisogno di assistenza su come procedere, non esitate a contattare il nostro team di supporto.

Perché vedo l'errore "CURRENCY.TYPE.INVALID - The currency type you selected is invalid. Please select another currency type.COMMODITY_INDEX"?

Verificate con il vostro account manager FedEx o con il supporto FedEx se la valuta selezionata è effettivamente supportata per il tipo di spedizione e il servizio che state utilizzando.

Perché vedo l'errore: CUSTOMS.VALUE.INVALID - The recipient country doesn’t accepts zero or null as customs value.Please update and try again.

Se il paese del destinatario non accetta spedizioni con valore inferiore a 1, dovete modificare il prezzo dichiarato dell'ordine prima di spedire di nuovo.

Perché vedo l'errore “Commercial Invoice is Required”?

Di solito significa che non è stata caricata alcuna fattura commerciale (necessaria per tutti gli ordini internazionali). Se invece succede anche dopo aver caricato correttamente la fattura, provate a caricare il logo della vostra azienda nella sezione Sender info del vostro profilo e a fare lo stesso nel vostro profilo FedEx, assicurandovi che corrispondano. Fatto questo, provate a correggere l'ordine con il pulsante “Fix order”.

Perché vedo l'errore "SHIPMENT.ELECTRONICIMAGE.REQUIRED - This COMMERCIAL_INVOICE requires electronic image. Please update and try again."?

Questo messaggio di errore compare quando FedEx richiede due immagini elettroniche obbligatorie per completare la spedizione:

• L'intestazione della fattura (letterhead)
• La firma della fattura

Per correggere l'errore e procedere correttamente con la spedizione, dovete caricare queste due immagini direttamente nella finestra di configurazione del corriere FedEx.

Ecco come fare:

1. Aprite la finestra di configurazione di FedEx cliccando sul pulsante "Edit" nella sezione Carriers.
2. Selezionate l'opzione "Generate Invoice with FedEx format (in order to print the commercial invoice along with the label)" per abilitare l'invio della fattura elettronica insieme all'etichetta.
3. Caricate l'immagine dell'intestazione della fattura in formato PNG o GIF nella sezione "Upload a new PNG or GIF Image for the Invoice's letterhead".
4. Caricate l'immagine della firma nella sezione "Upload a new PNG or GIF Image for the Invoice's signature".

📌 Requisiti delle immagini:

Sono supportati solo i formati PNG e GIF, con i seguenti limiti di dimensione:

• Intestazione: 700x50 pixel, max 60 KB
• Firma: 240x25 pixel, max 60 KB

Per le spedizioni verso alcune destinazioni europee, FedEx può richiedere il documento AWB come requisito obbligatorio: provate quindi a rimuovere questo flag nel collegamento FedEx e a rielaborare la spedizione:

Se nessuno dei suggerimenti precedenti vi aiuta e state caricando un vostro ETD, contattate il team di supporto e vi aiuteremo a risolvere.

Perché vedo l'errore "Invalid input: please, check your data again."?

L'errore riguarda il formato del documento caricato. Provate a utilizzare il formato GIF.

Perché vedo l'errore "You are requesting the transmission of 2 different invoices. Remove ETD file or disable “Generate Commercial Invoice” in carrier settings."?

Questo errore si verifica quando selezionate l'opzione "Generate Commercial Invoice" nella finestra di collegamento e poi caricate la documentazione ETD per la stessa spedizione.

Poiché le due opzioni non sono compatibili, dovete:

• Caricare la documentazione oppure selezionare "Generate Commercial Invoice" nella finestra.

Perché vedo l'errore “SHIPPING_DOCUMENT - COMMERCIAL_OR_PRO_FORMA_INVOICE SHIPPING.DOCUMENT.REQUIRED - COMMERCIAL_OR_PRO_FORMA_INVOICE is required to process your electronic trade document request”?

La fattura commerciale USMCA è accettata solo per le spedizioni in partenza dagli Stati Uniti (esportazioni USA).

Perché vedo l'errore “COMMERCIAL_OR_PRO_FORMA_INVOICE is required to process your electronic trade document request”?

Provate a rimuovere il flag "Avoid generation of AWB for intra-EU shipments"

Se non riuscite a risolvere, contattate il nostro supporto via chat o ticket.

Perché vedo l'errore “The COMMERCIAL_INVOICE requires an electronic LETTER_HEAD”?

Se state utilizzando il vecchio collegamento FedEx, collegate FedEx v2 e caricate lì l'intestazione.

Perché vedo l'errore “SHIPPINGDOCUMENTSPECIFICATION.CUSTOMERIMAGEUSETYPE.NOTFOUND - Letterhead and/or Signature images could not be retrieved."?

Questo errore può dipendere da un caricamento errato dell'intestazione e/o della firma. Vi suggeriamo di caricarle di nuovo dalla sezione Carriers, tenendo conto dei seguenti limiti:

• Immagine della firma: 240x25 pixel, 60KB
• Immagine dell'intestazione: 700x50 pixel, 60KB

Perché vedo l'errore “COMMERCIAL_INVOICE requires an electronic SIGNATURE"?

Se state utilizzando il vecchio collegamento FedEx, collegate FedEx v2 e caricate la firma.

Perché vedo l'errore “FedExv2:In order to generate a commercial invoice, you must upload your letterhead image and signature in the carrier settings. Please upload new images and try again."?

Andate nella sezione Carriers e verificate che i documenti richiesti siano caricati correttamente nelle impostazioni del collegamento FedEx, in "Upload a new PNG or GIF Image for the invoice's letterhead":

Come evitare la generazione di quattro etichette per le spedizioni FedEx?

Per evitare la creazione di quattro etichette per le spedizioni da UE a UE con FedEx, vi basta attivare questa casella nelle impostazioni del collegamento al corriere:

Avoid generation of AWB for intra-EU shipments

SHIPPING.DOCUMENT.REQUIRED: COMMERCIAL_INVOICE is required to process your electronic trade document request.

Il paese di destinazione non accetta la fattura generata tramite FedEx. Disattivate la configurazione dalle impostazioni FedEx in Carriers > FedExv2 > Edit e allegate manualmente la vostra fattura alla spedizione.

Perché l'anteprima della fattura commerciale FedEx è corretta, ma alcuni campi risultano vuoti dopo aver scaricato il file?

Si tratta di un problema di compatibilità del PDF generato direttamente da FedEx, che può presentarsi con alcuni lettori PDF come Adobe Acrobat e Microsoft Edge. Provate ad aprire il file con un lettore PDF alternativo come Chrome o Firefox.

Perché vedo l'errore “Document is Invalid”?

L'errore Document is Invalid è di solito legato a una mancata corrispondenza tra la prima chiamata di upload e la chiamata di spedizione vera e propria.

Cosa posso fare per risolvere il problema?

Come prima cosa, verificate qui che il paese verso cui spedite supporti la documentazione ETD.

Se non è così, controllate se lo stesso Document ID è già stato usato per altre spedizioni.

Perché vedo l'errore "There was an error uploading ETD to FedEx: Authentication Failed. Please try uploading a new ETD for this order''?

Vi suggeriamo di contattare il vostro account manager FedEx per controllare le impostazioni del vostro account e verificare che abbiano attivato le vostre API per le spedizioni Paperless.

Perché vedo l'errore "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."?

Se ricevete questo errore, vi suggeriamo di scansionare il file con un antivirus. Se non funziona, generate e caricate un nuovo file.

Perché vedo l'errore “The ETD document type you uploaded is not supported by FedEx v2. Please retry with a different ETD document type. Supported types are: PRO_FORMA_INVOICE, CERTIFICATE_OF_ORIGIN, USMCA_COMMERCIAL_INVOICE_CERTIFICATION_OF_ORIGIN, COMMERCIAL_INVOICE."?

Questo errore può verificarsi per diversi motivi:

1. È possibile che il tipo di ETD selezionato non sia corretto. Modificate il tipo di documento dalla scheda Details & Documents.

   Ad es.

   • Commercial invoice (o valore 5 via API) per la fattura
   • Other (o valore 99 via API) per la dichiarazione doganale

   

2. Se spedite verso un paese dell'Unione Europea, potreste riscontrare questo errore perché i documenti ETD non sono richiesti per le spedizioni verso i paesi UE.
3. È possibile che riscontriate questo errore perché la configurazione paperless è disattivata. Andate in Carriers > FedEx v2 > Edit e verificate che l'opzione sia selezionata:

   

Perché vedo l'errore “You are requesting Paperless service: please upload an ETD file or enable “Generate Invoice with FedEx format” in carrier settings."?

Verificate se l'opzione “Paperless” è attiva nel vostro collegamento al corriere FedEx, nella sezione Carriers. Se è attiva, disattivatela e rielaborate la spedizione.

Perché vedo l'errore “General Failure”?

Se state creando una spedizione internazionale, tenete presente che FedEx accetta un massimo di 5 ETD. Se ne avete caricati di più, provate a unirli in un unico PDF.

Perché vedo l'errore “SPECIAL_SERVICE_TYPE - ELECTRONIC_TRADE_DOCUMENTS ORGORDEST.SPECIALSERVICES.NOTALLOWED - This special service type is not allowed for the origin/destination pair. Please update and try again"?

Il flag "Avoid generation of AWB for intra-EU shipments”, in Carriers>FedExv2>Edit, non può essere attivato per i resi.

Perché vedo l'errore “SHIPMENTSPECIALSERVICES.ETDDETAIL.NOTAVAILABLE - Electronic trade documents are not available for domestic shipments. Please update and try again."?

Se state elaborando spedizioni nazionali, potreste riscontrare questo errore per i seguenti motivi:

1. Avete selezionato le opzioni "Paperless" e "Generate Invoice" nelle impostazioni del collegamento al corriere. Soluzione: rimuovete il flag.
2. Avete selezionato "Avoid generation of AWB for intra-EU shipments” nelle impostazioni del collegamento al corriere. Soluzione: rimuovete il flag.

Perché vedo l'errore “There was an error while uploading the file. Please try again later”?

Se l'errore compare per una spedizione internazionale con ETD, riconvertite il file ETD, caricatelo di nuovo ed eliminate quello precedente.

Perché vedo l'errore “I dati inseriti nel parametro NONE sono invalidi. Azione di riferimento: NONE"?

FedEx non accetta tutti i caratteri speciali sulle etichette. Per risolvere l'errore, eliminate i caratteri speciali dalla richiesta di etichetta, prestando particolare attenzione ai campi Notes e Item Description.

Perché vedo l'errore "ErrorMessage": "STREETLINES.TOO.LONG - We are unable to process this request. Please try again later or contact FedEx Customer Service."?

Il limite massimo per FedEx è di 35 caratteri.

Perché vedo l'errore “RECIPIENT.STATEORPROVINCECODE.INVALID. We are unable to process this request”?

Verificate che il campo Provincia/Stato del destinatario sia corretto, oppure rimuovetelo.

Perché vedo l'errore “SHIPPER.STATEORPROVINCECODE.INVALID. Shipper State or Province code is invalid”?

Verificate che il campo Provincia/Stato del mittente sia corretto, oppure rimuovetelo.

Perché vedo l'errore “VALUE.TOO.LONG - CustomerReference value is invalid for customer reference 2 in requestedPackage 1. Please update and try again."?

La nota per il corriere è troppo lunga: accorciatela e rielaborate la spedizione.

Perché vedo l'errore “Zip code must be at least 6 characters"?

Se spedite nel Regno Unito, verificate che il codice postale inserito sia corretto. Tenete presente che possono esserci degli spazi tra i caratteri del codice postale: non rimuoveteli.

Perché vedo l'errore “Street 1 and Street 2 cannot be longer than 35 characters. Please enter a shorter address or split it between the two fields"?

Riducete la lunghezza di Address 1 e Address 2 a un massimo di 35 caratteri in totale.

Perché vedo l'errore “RECIPIENT.STATEORPROVINCECODE.INVALID - Destination country is not serviced. Please update and try again."?

Se riscontrate questo errore spedendo alle Isole Canarie, ricontrollate i dettagli della spedizione e assicuratevi di inserire correttamente le seguenti informazioni:

• Usate il codice "ES" nel campo "State/Province"
• Inserite "Spain" nel campo "Country".

Perché vedo l'errore “FedExv2:DESTINATION.POSTALCODE.MISSING.ORINVALID - Destination postal code missing or invalid."?

Verificate che il campo del codice postale sia compilato e che sia corretto.

Perché vedo l'errore "PHONENUMBER.TOO.SHORT - Phone no. must be 10 digits for U.S. and Canada.Please update and try again"?

FedEx non accetta numeri di telefono che iniziano con la cifra 0, perché li interpreta come numeri di meno di 10 cifre.

Perché vedo l'errore "Could not interpret numbers after plus-sign"?

Assicuratevi che i numeri di telefono di mittente e destinatario includano il prefisso internazionale corretto.

Perché vedo l'errore "SHIPPER.POSTALSTATE.MISMATCH - Shipper Postal-State Mismatch. Please correct and try again."?

Rimuovete la provincia dal campo ‘state’ o ‘province’ del mittente. Lasciate il campo vuoto.

FedEx accetta i caratteri greci?

No, il corriere non supporta i caratteri greci, ma solo i caratteri latini.

FedExv2 - FEDEX EU CONNECT PLUS 2025: -DESTINATION.POSTALCODE.MISS ING.ORINVALID -Destination postal code missing or invalid.

Verificate che il codice postale della spedizione non contenga caratteri speciali o doppi spazi.

Perché vedo l'errore “Return: Number of packages exceeds maximum”?

Se riscontrate l'errore "Return: Number of packages exceeds maximum" con le vostre spedizioni FedEx, ecco il motivo!

Come potete immaginare, il problema riguarda i resi: FedEx infatti non accetta 2 colli per i resi.

Potete sempre creare una nuova etichetta di reso manuale per la vostra spedizione.

Perché vedo l'errore “Airbill is not allowed for Destination Country”?

Se ricevete questo errore, il servizio di spedizione selezionato potrebbe non essere disponibile/consentito per il paese di destinazione in questione. In questo caso, verificate direttamente con il corriere il servizio più adatto per questa destinazione, oppure provate a selezionare 'All Services' nella finestra di collegamento del corriere (Carriers > FedEx > Edit > Service > “All Services”).

Perché vedo l'errore “International Shipments cannot be voided at the package level”?

Questo errore significa che non potete modificare una spedizione già creata: in questo caso, create una nuova spedizione da zero.

Perché vedo l'errore “Destination country does not accept international non-document shipments”?

L'errore indica che per la destinazione inserita (ad es. Andorra) le spedizioni tassabili, cioè tutto ciò che non è una spedizione di soli documenti, non sono valide.

Perché vedo l'errore “FedEx International Priority is deprecated. Please select another service"?

Potete correggerlo selezionando il servizio "FedEx International Priority" invece del servizio International Priority.

Perché vedo l'errore “RATE.LOCATION.NOSERVICE - FedEx service is not currently available to this origin / destination combination. Enter new information or contact FedEx Customer Service."?

Per questo errore ci sono 3 possibili soluzioni:

1. Verificate con il corriere di avere l'autorizzazione a spedire verso questa destinazione. Controllate anche che i dettagli dell'ordine siano corretti e privi di caratteri speciali o spazi vuoti.
2. Provate a rimuovere eventuali opzioni aggiuntive (ad es. Courier Options o servizi aggiuntivi selezionati nel collegamento al corriere, come “Delivery Signature”).
3. L'errore può verificarsi se il Packaging Type selezionato nel collegamento al corriere non è corretto. Ad esempio, l'opzione Envelope può essere usata solo per spedizioni fino a 0,5 kg. Se la vostra spedizione supera questo peso, selezionate Your Packaging e riprovate.

Perché vedo l'errore "REQUESTEDSHIPMENT.SERVICETYPE.UNSUPPORTED - Service type is not supported at the moment. Please contact FedEx customer service for more information."?

Verificate che il servizio che state utilizzando sia compatibile con la spedizione che state cercando di creare.

Se spedite via API, assicuratevi di selezionare il servizio specifico da utilizzare sia nella Carrier Connection sia nel parametro CarrierService della chiamata API (All Services non verrà accettato).

Perché vedo l'errore "SERVICETYPE.NOT.ALLOWED. selected service type is not allowed between origin and destination. Please update and try again"?

Il servizio o alcuni dati potrebbero non essere corretti.

Come risolvere:

• Assicuratevi di non lasciare campi vuoti nella sezione dell'indirizzo.
• Selezionate il servizio corretto (per le spedizioni nazionali, usate un servizio nazionale, non uno internazionale).

Perché vedo l'errore: REQUESTEDSHIPMENT.SERVICETYPE.NOTSUPPORTED - FEDEX_INTERNATIONAL_CONNECT_PLUS is not supported for the destination. Please update and try again

Alcuni paesi, come Malta e Croazia, non accettano per i resi il servizio indicato nell'errore. Contattate il vostro referente FedEx per un'alternativa valida.

WARNING: "Invalid Value in Service Type. Please update and try again."

L'errore "Invalid Value in Service Type" indica che il servizio FedEx selezionato non è valido o non è supportato per la destinazione scelta.

Vi consigliamo di verificare quanto segue:

• Verificate di aver selezionato il servizio FedEx corretto nella configurazione del corriere su ShippyPro per le spedizioni verso il paese di destinazione. Se non siete sicuri, provate a selezionare "All Services" nelle impostazioni del collegamento per visualizzare tutti i servizi disponibili.
• Verificate direttamente con FedEx quali servizi sono abilitati per le spedizioni B2C verso il paese di destinazione, perché alcuni servizi potrebbero non essere disponibili o consentiti per quella destinazione.
• Assicuratevi che tutti i dettagli della spedizione (peso, dimensioni e tipo di imballaggio) rispettino i requisiti FedEx per il servizio e la destinazione selezionati.

Perché vedo l'errore “Invalid booking confirmation number” o “BOOKING.CONFIRMATION.NUMBER.INVALID”? - Booking confirmation number is invalid. SHIPMENT.LOADCOUNT.INVALID - Invalid shipper load and count.?

Dovete contattare il vostro account manager FedEx e chiedere un numero di prenotazione del ritiro, da inserire nella Carrier Option "Booking Confirmation Number".

L'opzione è disponibile solo con i seguenti servizi di spedizione: FedEx International Priority Freight, FedEx International Economy Freight, FedEx Regional Economy Freight

Nota: ricordate che se spedite via API, potete impostare questa Carrier Option nella chiamata Ship come segue:

Leggete l'articolo How can I add Carrier Options to my shipments?

Perché vedo l'errore “Special service SIGNATURE_OPTION is invalid”?

Questo errore si verifica perché la firma indiretta (Indirect Signature) può essere richiesta solo per indirizzi residenziali. Vi consigliamo di contattare FedEx ed eventualmente spedire con questa opzione direttamente tramite loro.

Perché vedo l'errore “SPECIAL_SERVICE_TYPE-CODORGORDEST.SPECIALSERVICES.NOTALLOWED”?

Se riscontrate questo errore, state richiedendo il servizio di contrassegno (COD). Tenete presente che il servizio COD di FedEx non è più disponibile in USA e Canada ed è disponibile solo in parte nel resto del mondo. Contattate il vostro account manager FedEx per saperne di più su questo servizio.

Perché vedo l'errore “FedEx does not support insurance. Please use Declared Value carrier option instead”?

Se riscontrate questo errore, state richiedendo un'assicurazione su una spedizione. FedEx non offre l'assicurazione. In alternativa, potete usare il FedEx Declared Value. Seguite questo link per saperne di più sul Declared Value.

Perché vedo l'errore "SHIP.SPECIALSERVICE.INVALID - Package 1 - Special service SIGNATURE_OPTION is invalid"?

Se avete selezionato l'opzione Indirect Signature, assicuratevi di includere anche la Carrier Option:

Perché vedo l'errore "SpecialServicesRequested dangerousGoodsDetail - Invalid dangerousGoodsAccessibilityType in RequestedPackage 1"?

Assicuratevi di utilizzare l'integrazione FedEx v2 e selezionate “Limited Quantities Commodities” nella Carrier Option Dangerous Goods.

Perché vedo l'errore "Fedex LOCATION_ID_TYPE - XHNGW HOLDATLOCATIONDETAIL.LOCATIONID.INVALID - Hold At Location Id is invalid. Please update and try again."?

Il Point ID inserito nella Carrier Option non è valido.

Come attivare l'opzione "IsDocumentOnly" in una spedizione via API

Se spedite solo documenti, dovrete dichiarare il campo "CustomInfoContentsType": "documents" nella vostra chiamata API.

Come posso aggiungere un'assicurazione per ogni collo?

Ora potete specificare il valore dichiarato di ogni collo direttamente nell'elemento parcels della vostra richiesta SHIP, aggiungendo i seguenti attributi nell'oggetto Attributes di ciascun collo:

Aggiungete i campi declaredValue e declaredValueCurrency a ogni collo per cui volete definire un valore dichiarato specifico.

Ho cliccato sul pulsante "Return label in the box", ma il menu a tendina che compare è vuoto. Perché?

Tramite quel menu potete selezionare un indirizzo specifico come destinazione dei resi. Per maggiori informazioni, vi invitiamo a consultare l'articolo dedicato al collegamento FedEx: How to connect FedExv2

Cosa significa questo errore: PACKAGE_INDEX - 1 LOCATION_ID_TYPE - HOLD_AT_LOCATION COUNTRY.POSTALCODEORZIP.INVALID - Invalid postal code/ZIP for the country selected. Please correct and try again.

La consegna al punto selezionato non è possibile. Verificate i limiti di peso e dimensioni di quel punto o punto di ritiro.

Errore: LOCATION_ID_TYPE - HOLD_AT_LOCATION HOLDATLOCATIONDETAIL.LOCATIONID.INVALID - Hold At Location Id is invalid. Please update and try again

Il punto di ritiro non può ricevere colli: può solo spedirli.

Perché vedo l'errore “Missing or invalid postalCode”?

Se ottenete questo errore prenotando un ritiro con FedEx, verificate che il codice postale sia stato inserito correttamente e nel formato giusto. Se è tutto corretto, contattate il vostro referente FedEx per verificare di essere autorizzati a organizzare ritiri dal paese selezionato.

Perché vedo l'errore “weight.value is missing or invalid” durante la richiesta di ritiro?

FedEx consente la prenotazione del ritiro per colli di peso superiore a 65 kg solo tramite il proprio portale: dovrete quindi andare sul portale del corriere e prenotare il ritiro direttamente da lì.

Perché vedo l'errore “PICKUP.STATEORPROVINCECODE.MISSING - GENERIC.ERROR”?

Per le richieste di ritiro in Quebec e Terranova, il campo "State" va compilato rispettivamente con "PQ" e "NL" invece dei normali codici ISO (che sarebbero QC e NF).

Perché vedo l'errore "ORIGINDETAIL.READYDATETIMESTAMP.REQUIRED - GENERIC.ERROR"?

Se riscontrate questo errore prenotando un ritiro, verificate che l'orario selezionato rientri negli orari di apertura del deposito locale e tra gli orari minimo e massimo previsti per il ritiro.

Perché vedo l'errore "PICKUP.WEIGHT.VALUE.INVALID - Invalid or missing weight value"?

Se ricevete questo errore durante la programmazione di un ritiro, assicuratevi che la spedizione rispetti i limiti di peso di FedEx. In caso di dubbi, vi consigliamo di contattare il vostro referente FedEx per chiarimenti.

Perché vedo l'errore "ORIGINDETAIL.READYDATETIMESTAMP.AFTERCUTOFFTIME"?

Spiegazione: l'orario di preparazione è programmato dopo il cut-off del magazzino (verificate gli orari esatti con il corriere).
Come risolvere: aggiornate l'orario entro l'intervallo consentito nei campi "PickupTime" e "PickupAfternoonMaxtime".

Perché vedo l'errore "PICKUP.NUMBER.EXPIRED - PREVIOUS DAY PICKUP, CANNOT CANCEL OR UPDATE"?

L'errore FedEx indica che è troppo tardi per apportare modifiche online. Poiché il sistema non può elaborare aggiornamenti o cancellazioni per richieste relative ai giorni precedenti, dovete contattare il servizio clienti FedEx per annullare o riprogrammare la spedizione.

Perché vedo l'errore “Inactive customer account”?

Se vi capita di riscontrare il messaggio di errore Inactive customer account per una spedizione FedEx, vi invitiamo a contattare direttamente il servizio clienti FedEx per conoscere l'origine del problema.

Poi potete aggiornare le vostre spedizioni su ShippyPro cliccando su Actions > Fix orders in error in bulk dalla sezione Shipping Labels.

Perché vedo l'errore “Customer is cash only”?

L'account in uso potrebbe essere associato a una carta di credito scaduta o avere qualche altro problema di fatturazione. Se l'account FedEx non viene mantenuto in regola, può essere messo in stato "cash only".

Perché vedo l'errore “Meter number is not registered”?

Andate nella sezione Carrier e rimuovete il flag dall'opzione "test mode".

Perché vedo l'errore “PAYMENT.PAYORCOUNTRY.INVALID”?

Se riscontrate questo errore, state cercando di spedire da un paese non compatibile con il vostro account FedEx (ad es. avete un account USA e state cercando di spedire da un paese europeo).

Perché vedo l'errore “FORBIDDEN.ERROR - We could not authorize your credentials. Please check your permissions and try again."?

Se l'errore si verifica quando le credenziali sono corrette o non sono state modificate, provate a rielaborare l'ordine, perché potrebbe essere causato da un rallentamento lato FedEx.

Perché vedo l'errore “The city, State/Province and ZIP/Potal code combination that you entered is not valid"?

Se questo messaggio compare mentre collegate FedEx v2, verificate che credenziali, nome e indirizzo su ShippyPro corrispondano esattamente a quelli presenti nell'account FedEx, nella sezione Billing address.

Perché vedo l'errore "GROUND.SHIPPING.NOTAUTHORIZED - Ground shipping is not authorized for this User."?

FedEx non ha autorizzato il servizio FedEx Ground per questo utente.

Perché vedo l'errore: ACCOUNTNUMBER.MINIMUMLENGTH.REQUIRED - Enter a valid 9-digit FedEx account number?

Verificate che l'Account Number inserito nel vostro collegamento FedEx sia corretto. Inoltre, se utilizzate l'Incoterm EXW, assicuratevi di inserire un Account Number valido per la parte a cui intendete addebitare la spedizione.

Perché vedo l'errore ACCOUNT.NUMBER.INVALID - Account number not found. Please provide a valid account number.

Significa che il corriere non può elaborare la spedizione perché il numero di account è:

• ❌ Mancante: non è stato fornito alcun numero di account
• ❌ Non valido: il numero di account fornito non esiste o non è nel formato corretto
• ❌ Inattivo: il numero di account non è più attivo presso il corriere

Per risolvere il problema:

1. Verificate che il vostro numero di account FedEx sia corretto e attivo
2. Aggiornate le informazioni dell'account di spedizione nella pagina Carriers su ShippyPro
3. Contattate il supporto FedEx se non siete sicuri del vostro numero di account o se il vostro account è stato disattivato

Perché vedo l'errore “Resources unavailable to service request”?

Il server del corriere potrebbe essere fuori servizio. Attendete e provate a correggere gli ordini in errore più tardi.

Perché vedo l'errore “SYSTEM.UNEXPECTED.ERROR - GENERAL FAILURE {FAILURE_CAUSE}. Please update and try again."?

Questo errore indica un disservizio temporaneo del server lato corriere. Provate a correggere l'ordine più tardi.

Perché vedo l'errore "INTERNAL.SERVER.ERROR - We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."?

Questo errore indica un disservizio temporaneo del server lato corriere. Provate a rielaborare gli ordini in errore più tardi.

Nota: se l'errore persiste solo su una spedizione specifica, mentre le altre vengono generate correttamente, significa che il server FedEx non riesce a elaborare quella particolare spedizione (ad es. troppi ETD allegati).

Perché vedo l'errore “An error occurred while processing your shipment. Please try again later"?

Se ricevete questo errore su tutte le spedizioni durante GetRates/la selezione del corriere, è possibile che ci sia un rallentamento momentaneo lato corriere. Riprovate più tardi.

Se ricevete questo errore durante GetRates/la selezione del corriere solo su uno o alcuni ordini specifici, è possibile che l'ordine contenga caratteri speciali o combinazioni di caratteri (ad es. una parola specifica seguita da parentesi) bloccati dal firewall del corriere. Provate a rimuovere tutti i caratteri speciali o create una spedizione manuale da zero.

Perché vedo l'errore "CXS JWT is expired"?

Potrebbe trattarsi di un rallentamento temporaneo del server del corriere: provate a rielaborare l'etichetta.

Perché vedo l'errore "SERVICE.UNAVAILABLE.ERROR - The service is currently unavailable and we are working to resolve the issue. We apologize for any inconvenience."?

Se riscontrate l'errore mentre cercate di prenotare un ritiro, riprovate più tardi.

Perché le tariffe FedEx risultano €0 o n/a?

Contattate FedEx: è possibile che le tariffe negoziate non siano disponibili. Il servizio clienti FedEx potrebbe rispondervi così:

A causa dell'integrazione di TNT in FedEx e per motivi legali, al momento nessuna soluzione IT di FedEx consente di accedere ai prezzi.

Prevediamo che questa funzionalità sarà attiva nel corso del primo trimestre del 2025.

Perché vedo una differenza nei giorni di consegna?

Se una spedizione all'interno dell'Europa ha una data di consegna più lunga di quella indicata nel vostro contratto o sul sito FedEx, controllate il campo “description”:

• deve essere sempre in inglese
• deve essere breve (ad es. SAMPLE, DOCUMENTS)

Se una spedizione fuori dall'Europa ha una data di consegna più lunga di quella indicata nel vostro contratto o sul sito FedEx, controllate il campo “description”:

• deve essere sempre in inglese;
• deve essere il più precisa possibile (ad es. "cosmetics" NO, "Extra Face & Eye Cream 50 ml Anti wrinkle (x1)" SÌ). Per USA, Canada e Messico i controlli sulla descrizione della merce sono molto rigorosi.

Assicuratevi inoltre che i codici postali statunitensi siano composti da 5 cifre.

Perché vedo l'errore RATEQUOTE.SHIPMENTPROCESSING.ERROR?

Tariffe e tempi di transito non sono disponibili per il numero di account inserito. Contattate il servizio clienti FedEx locale.

Perché non vedo alcuna differenza tra le tariffe con e senza tasse per le spedizioni extra-UE?

FedEx non restituisce alcun dato fiscale (IVA, ecc.) per le spedizioni extra-UE. Questi costi verranno poi aggiunti dal corriere nella fattura di pagamento.

Perché i tempi di transito FedEx sono diversi da quelli che vedo sul portale FedEx?

Questa differenza nasce dal fatto che FedEx non sempre fornisce questa informazione nelle risposte API delle tariffe. Di conseguenza, non è possibile allineare i nostri dati con quelli della piattaforma FedEx, perché non abbiamo accesso alle informazioni necessarie. Se non riceviamo il tempo di transito da FedEx, mostriamo 1 giorno come valore predefinito.