Scopri come correggere gli errori con UPS
Per evitare che le etichette create con UPS vadano in errore ci sono alcuni piccoli accorgimenti da adottare.
Vediamo insieme come fare caso per caso!
❓ Come posso controllare e correggere un errore nella sezione "Errori"?
Vai su Ordini > Errori dalla tua dashboard ShippyPro.
-
Cerca il messaggio di Tipo Errore.
-
Clicca su Come risolvere? per vedere le istruzioni dettagliate.
-
Usa l’icona della chiave inglese per correggere i dati della spedizione.
❓ Supportate il servizio World Ease?
No.
❓ Perché vedo “Failure of Web Server bridge”?
Si tratta di un problema temporaneo del server UPS.
-
Prova a confermare l’ordine più tardi.
-
Puoi cliccare su Correggi Ordine per riprovare, oppure usare Azioni > Correggi ordini in errore in blocco se hai più ordini.
❓ Perché vedo “Name and company fields must be shorter than 35 characters”?
I campi Nome e Azienda non devono superare i 35 caratteri per le etichette UPS.
❓ Perché vedo “Postal Code length must be 5 numbers”?
Il CAP deve contenere esattamente 5 cifre e non deve includere caratteri speciali (ad esempio “-”, “/”).
❓ Perché vedo “Province must be in the form of an abbreviation”?
Nel campo Stato destinatario devi usare l’abbreviazione della provincia. Scrivere il nome completo genera un errore.
❓ Perché vedo “User Id and Shipper Number combination is not qualified to receive negotiated rates”?
Questo significa che le tariffe del contratto non sono state sincronizzate.
-
Verifica le tue credenziali.
-
Se sono corrette, contatta UPS per abilitare le tariffe via API.
❓ Perché vedo “The shipper number cannot be used for the shipment”?
Questo indica che il numero di conto potrebbe essere errato o sospeso.
👉 Controlla con il tuo referente UPS.
❓ Perché vedo “Failure: Unable to determine destination for Time in Transit Information. / Time in Transit information Unavailable. (111598)”?
Disattiva l’opzione Visualizza Time in Transit da:
Corrieri > Connessione > UPS > Modifica e prova a creare di nuovo l’etichetta.
❓ Perché vedo “Failure: The country associated with Shippers ShipperNumber must be the same as the shipments Shippers country. (120120)”?
Abilita Usa le informazioni aziendali come mittente fisso da:
Corrieri > UPS > Modifica.
❓ Perché vedo “Negotiated rates are unavailable at this time”?
Si tratta di un problema temporaneo del server UPS. Riprova più tardi.
-
❓ Perché vedo “Missing or invalid Notification/NotificationCode”?
Può accadere per diversi motivi:
-
Deseleziona eventuali notifiche attive in Corrieri > UPS v2 > Modifica > Notifica via email (usa Ctrl + clic).
-
Se sono già deselezionate, prova a selezionare solo:
-
QV Email Notification
-
QV Exception Notification
-
QV Delivery Notification Mail Innovationups
-
-
Se l’errore persiste, il tuo numero di conto (Account Number) potrebbe non essere collegato al tuo profilo UPS.com.
Per verificare:
-
Accedi a ups.com con lo stesso User ID e Password usati per l’API di spedizione.
-
Vai su My UPS > Account Summary.
-
Controlla se il tuo account è elencato. In caso contrario, clicca su Add a UPS Account e segui le istruzioni.
❓ Perché vedo “Failure: Invalid Access License number (250003)”?
Significa che la tua chiave di accesso XML non è valida.
-
Ricontrollala.
-
Assicurati di avere accesso in produzione all’API di validazione degli indirizzi UPS.
-
-
❓ Perché vedo “Missing or invalid shipper number”?
Per risolvere:
-
Accedi a ups.com con lo stesso User ID e Password usati per l’API di spedizione.
-
Vai su My UPS > Account Summary.
-
Controlla se il tuo account è elencato. In caso contrario, seleziona Add a UPS Account e segui i passaggi.
❓ Perché vedo “Failure: The ShipFrom country must be the same as the Shipper country (120317)”?
Puoi risolvere in tre modi:
-
Vai su Corrieri > Connessione > UPS > Modifica e abilita Usa le informazioni aziendali come mittente fisso.
-
Imposta l’ordine come etichetta di reso cliccando sul toggle di reso prima di crearlo.
-
Se usi l’API, aggiungi
"IsReturn": true
alla richiesta di spedizione.
-
❓ Perché vedo “Missing or invalid ship from StateProvinceCode (120306)”?
-
Disattiva Abilita Paperless se attivo.
-
Seleziona Usa le informazioni aziendali come mittente fisso da Corrieri > UPS > Modifica.
-
Aggiorna la spedizione cliccando su Modifica e Conferma nel menu Etichette di spedizione.
❓ Perché vedo “Missing or invalid ship from company name”?
Controlla che il campo Nome azienda nell’ordine sia compilato correttamente. Limite 35 caratteri.
❓ Perché vedo “Invalid ShipFrom AddressLine2”?
Il campo Indirizzo 2 del mittente o destinatario è troppo lungo. Il numero massimo di caratteri è 35.
❓ Perché vedo “The Shipper's shipper number cannot be used for the shipment”?
In questo caso devi contattare direttamente il tuo referente UPS.
❓ Perché vedo “The maximum declared amount was exceeded. Maximum value per package: 856 EUR. (121025)”?
-
L’importo massimo dichiarato per pacco è 856 EUR.
-
Per le spedizioni di reso, il valore massimo supportato è 999 USD (da convertire eventualmente in EUR).
❓ Perché vedo “Invalid Bill-To type. (120444)”?
L’account inserito per la fatturazione non è riconosciuto da UPS.
❓ Perché vedo “Failure: The selected service is not available from the origin to the destination. (121210)”?
Verifica con il tuo referente UPS se il contratto include spedizioni verso la destinazione dell’ordine.
❓ Perché vedo “Invalid product description for product number 1. Product description should be present at least once. Valid range is 0 to 35 alphanumeric”?
Il campo Descrizione prodotto accetta un massimo di 35 caratteri. Assicurati di non superare questo limite.
❓ Perché vedo “Invalid Authentication Information (250002)”?
Significa che la password del tuo account UPS non corrisponde a quella fornita in fase di configurazione (probabilmente è stata cambiata o reimpostata).
Se non funziona:
-
Elimina la connessione.
-
Ricreala da zero in Corrieri.
📌 Nota: i link di tracking e gli aggiornamenti degli ordini precedenti NON saranno più disponibili.
❓ Perché vedo “Failure: Address Validation Error on ShipTo address (120802)”?
Controlla i campi Indirizzo, Città, CAP e Stato del destinatario. L’errore viene generato dal sistema UPS se uno dei campi non corrisponde a un indirizzo reale.
📌 Nota per le spedizioni negli USA: il CAP deve essere composto da 5 cifre (senza lettere).
❓ Perché vedo “Missing or Invalid Vendor Collection ID Number”?
-
Verifica di aver inserito correttamente il numero IOSS da Il mio profilo > Informazioni mittente.
-
Se non funziona, rimuovi il numero IOSS e conferma di nuovo la spedizione in errore.
❓ Perché vedo Missing or invalid Shipper AttentionName
Tieni presente che il campo Nome mittente accetta un massimo di 35 caratteri, spazi inclusi.
❗️ Importante: se hai selezionato l'opzione "Fixed Shipper" dal modulo di connessione UPS, significa che prenderemo le informazioni sul mittente direttamente dalla sezione Il mio profilo > Informazioni sul mittente, quindi assicurati che il nome e il cognome inseriti non superino i 35 caratteri.
❓ Perché vedo “The maximum number of user access attempts was exceeded (250006)”?
Questo errore appare quando la password UPS non corrisponde a quella su ShippyPro e hai superato i tentativi di accesso.
Per risolvere:
-
Controlla la password nel modulo di connessione.
-
Contatta UPS per sbloccare l’account.
-
Correggi l’ordine.
❓ Perché vedo “Destination Ireland Error Message: Invalid sold to state province code. Valid length is 0 to 5 alphanumeric (128100)”?
-
Controlla che il campo Provincia sia popolato con il codice ISO corretto per il paese di destinazione.
-
Se l’errore persiste, sostituisci il CAP con “IED”.
❓ Perché vedo “Failure: Invalid merchandise description of package (120623)”?
La descrizione dell’articolo è troppo lunga.
👉 Accorcia il testo a massimo 35 caratteri.
❓ Perché vedo “Failure: The UserId is currently locked out, please try again in 30 minutes. (250007)”?
L’errore è restituito direttamente dal server UPS.
👉 Contatta il tuo referente UPS o il servizio clienti per sapere perché l’account è stato bloccato.
❓ Perché vedo “The country associated with Shipper's ShipperNumber must be the same as the shipments Shipper's country”?
Il codice cliente utilizzato non permette l’uso di un indirizzo mittente estero.
👉 Controlla questa limitazione con il tuo referente UPS.
❓ Perché vedo “Failure: Invalid ShipTo AddressLine2 (120203)”?
Il campo Indirizzo 2 del destinatario non deve superare i 35 caratteri.
❓ Perché vedo “Invalid freight charges monetary value. Valid length is 0 to 15 numeric and can hold up to 2 decimal places”?
Disabilita l’opzione Aggiungi spese di trasporto alla fattura commerciale dal modulo di connessione.
❓ Perché vedo “To be reprocessed: Failure: The request is well formed but the request is not valid (10002)”?
Rimuovi tutti i caratteri speciali dalla descrizione degli articoli, incluso il documento CN22.
❓ Perché vedo “Missing or invalid ship from state province code”?
Verifica le informazioni inserite nel campo State/Province Mittente e utilizza la sigla per le province italiane.
📌 Nota: per alcuni Paesi (come i Paesi Bassi) il campo Provincia/Stato Mittente può essere lasciato vuoto. Prova a rimuovere qualsiasi dato da questo campo e rielabora l’ordine.
❓ Perché vedo “Missing or invalid ship to state province code”?
Inserisci nel campo Stato/Provincia Destinatario la sigla della provincia o il codice ISO (es. Barcelona > B, Alicante > A).
👉 In alternativa, prova a rielaborare l’ordine lasciando vuoto questo campo.
❓ Perché vedo “Missing or invalid ship to company name”?
Correggi il campo Nome destinatario assicurandoti che non superi i 35 caratteri.
❓ Perché vedo “Indirizzo mittente mancante o non valido”?
Il campo dell’indirizzo per UPS ha un limite di 35 caratteri.
👉 Ricorda che puoi utilizzare il campo Indirizzo 2 per altre specifiche (nome campanello, numero appartamento, ecc.).
❓ Perché vedo “Shipment Description is required for this shipment” (o “Missing package description”)?
-
Ordini manuali:
-
Se hai selezionato Numero ordine Marketplace in Il Mio Profilo > Preferenze > Descrizione contenuto stampato sulle etichette, ricordati di compilare sempre il campo Numero ordine oppure TransactionID (se spedisci via API).
-
Se l’errore persiste, modifica l’opzione scegliendo Numero d’ordine ShippyPro.
-
-
Ordini da marketplace:
-
Inserisci solo il TransactionID nel campo Descrizione articoli (Items description).
-
Se l’errore continua, seleziona Numero ordine Marketplace in Il Mio Profilo > Preferenze > Descrizione contenuto stampato sulle etichette.
-
❓ Perché vedo “Shipment Description cannot exceed the length of 50 characters”?
Questo errore dipende dall’opzione selezionata in Preferenze.
👉 Soluzione: cambia l’opzione scegliendone un’altra (es. numero ordine).
❓ Perché vedo “Point_mode is required when point_id is set and viceversa”?
Se hai selezionato un Pickup Point ID tramite opzione corriere, devi selezionare anche un Pickup Point Mode (Hold for Pickup o Access Point Delivery) e viceversa.
❓ Perché vedo “International Shipments cannot be voided at the package level”?
Le spedizioni internazionali non possono essere annullate a livello di singolo pacco.
👉 Devi creare una nuova spedizione da zero.
❓ Perché vedo “The requested service is unavailable between the selected locations”?
Questo errore appare quando il servizio scelto non è disponibile tra origine e destinazione.
Esempio: i CAP 6991, 6992 e 6993 non sono serviti dall’Austria ma solo dalla Germania. Per spedire lì, occorre usare CAP tedeschi e impostare come destinazione la Germania.
Verifica che:
-
il CAP sia corretto e corrisponda alla città giusta,
-
non ci siano lettere/spazi extra nel CAP,
-
il CAP del mittente sia corretto.
📌 Per spedizioni internazionali, ricorda di includere i dettagli CN22.
❓ Perché vedo “Invalid Destination (111542)”?
Controlla che CAP e città del destinatario siano corretti.
❓ Perché vedo “Invalid Carrier”?
Questo errore appare se il campo Carriername nella chiamata API non è compilato correttamente.
Se utilizzi UPSv2, il campo deve essere:
❓ Perché vedo “Printing could not be managed for the selected orders, please try again with fewer orders”?
Se stampi in ZPL con UPS e generi anche la fattura commerciale UPS, quest’ultima sarà sempre in PDF, causando conflitto di formati.
👉 Soluzione: modifica le impostazioni e imposta il formato etichetta su PDF.
❓ Perché non riesco a visualizzare il servizio UPS SurePost durante la creazione delle spedizioni?
Il servizio UPS SurePost non è disponibile nel Label Creator e può essere incluso solo tramite chiamata API Ship.
❓Perché non riesco a vedere le tariffe UPS e visualizzo l'errore "No matching rate and transit times available (111562)" among the excluded carriers ?
Apri la pagina modale della connessione UPS e rimuovi il flag da “Visualizza le tariffe del tempo di transito”. Se il tracking è creato nel formato 1ZXXXXXXXXXXXXXX, potrebbe essere necessario rimuovere l'opzione Modalità di prova da Corrieri > Modifica.
❓Perché le mie spedizioni messicane vanno in errore?
A partire dal 6 marzo 2023, tutti i pacchi spediti verso, da o all'interno del Messico dovranno avere una descrizione a livello di pacco degli articoli spediti. Assicuratevi di aggiungerla alle vostre spedizioni messicane.
❓Cosa posso fare se le tariffe UPS non sono corrette?
Hai appena provato a spedire uno dei tuoi ordini con UPS, ma le tariffe indicate non corrispondono a quelle negoziate nel vostro contratto?
Ecco alcuni suggerimenti che potrebbero aiutarti!
1. Se ottieni l'errore La combinazione di ID utente e numero di mittente non è qualificata per ricevere le tariffe negoziate, chiedi a UPS di caricare le tariffe tramite API.

2. Verifica se è stata attivata l'opzione Mostra tariffe senza IVA da Il mio profilo > Preferenze.

3. Prova a disattivare la visualizzazione delle tariffe del tempo di transito e ad attivare l'opzione: Usa la tua azienda come mittente fisso da Corrieri > Modifica.

4. Se è stata attivata la modalità Test ma le credenziali sono quelle di produzione, prova a disattivare questa opzione da Corrieri > UPS > Modifica:

❓Perché non riesco a vedere le mie note UPS sull'etichetta?
Le etichette UPS non supportano questo campo, che viene trasmesso automaticamente al Corriere compilando CarrierNote tramite API.
❓Perché non ricevo le notifiche di tracciamento UPS?
Non tutti i servizi UPS prevedono notifiche di tracciamento e si possono riconoscere facilmente in base al NotificationCode.
Il primo numero è il NotificationCode che inviamo nella richiesta di UPS:
2: Return notification or label creation - solo per le spedizioni di ritorno. Non applicabile al GFP (Ground Freight Pricing).
5: In-Transit notification - solo per le spedizioni di reso.
6: Ship Notification - consentito solo per le spedizioni in uscita.
7: Exception Notification - Non applicabile alla GFP.
8: Delivery Notification
❓Perché vedo There was an error while uploadign the file. Please try again later. - Your UPS Account number is not authorized for user generated forms functionality ?
In modale di connessione, spunta la casella "Request UPS Commercial Invoice along with the label". Nell'eventualità l'operazione non dovesse essere risolutiva, ti consigliamo di verificare insieme al tuo rappresentante commerciale di UPS se sei abilitato alla generazione della modulistica esternamente.
❓Perché ricevo "Invalid return service. Check the selected service in carrier configuration." ?
In questo caso, controlla la tua modale di connessione di UPSv2 Corrieri > modifica e selezione il tipo di servizio di reso corretto dal menù a tendina (campo "Return Service Type").
❓Perché le informazioni dei campi "Address 1" e "Address 2" sono invertite sull'etichette di spedizione?
Si tratta di impostazioni del corriere che purtroppo non possono essere modificate.
Non preoccuparti! Tutte le informazioni sono correttamente trasmesse al corriere
❓Perché sull'etichetta di spedizione mancano le informazioni su "Address 2" del mittente?
Si tratta di impostazioni del corriere che purtroppo non possono essere modificate.
Non preoccuparti! Tutte le informazioni sono correttamente trasmesse al corriere.
❓Perché vedo "Invalid or missing product origin country code for product number 1" ?
Il Paese di Origine inserito nel CN22 è errato.
Se hai configurato la sezione Customs Info nella sezione Il Mio Profilo, assicurati di aver associato un Codice of Origin valido per gli SKU coinvolti.
❓Perché ricevo l'errore "Non è stato possibile gestire la stampa per tutti gli ordini selezionati, riprova con meno ordini. (Printing could not be managed for the selected orders, please try again with fewer orders)" ?
UPS restituisce sempre un'etichetta GIF se si seleziona COD.
Questo ci obbliga a fare una conversione da GIF a PDF quando è selezionato COD. Al momento COD + ZPL non è supportato per questo motivo, solo PDF.
❓Cosa significa l'errore "ShipTo PhoneNumber must be at least 10 alphanumeric characters" ?
Verifica il campo del numero di telefono del destinatario, deve contenere almeno 10 caratteri alfanumerici. Ricorda che 0000000000 non è accettato e neanche numeri che iniziano con 0.
Il numero del destinatario deve essere conforme al formato richiesto per i numeri di telefono del paese di destinazione.
❓Perché vedo "Missing or invalid shipment indication type code." ?
Se stai spedendo via API con Opzione Corriere "Pickup Point Mode", assicurati di aver inserito il codice corretto nel parametro "value" (01: Hold for Pickup, 02: Access Point Delivery):
❓Cosa significa "Invalid number of products" ?
Il numero massimo di prodotti consentito per una singola spedizione UPS è il seguente:
50: Package Packing List
100: Fattura commerciale, NAFTA, CO, EEI
1000: Air Freight packing list
❓ Perché vedo “Invalid/Missing Refresh Token”?
Crea una nuova connessione UPSv2 dalla pagina Corrieri.
❓ Perché vedo “Invalid sold to state province code. Valid length is 0 to 5 alphanumeric”?
Controlla che il campo Stato/Provincia non superi i 5 caratteri.
👉 In caso contrario, sostituiscilo con la sigla della provincia corretta e rielabora l’ordine
.
❓ Perché vedo “Invalid Shipment Contents Value”?
Se ricevi questo errore mentre tenti di ottenere le tariffe UPS, controlla il campo Total Value e assicurati che non sia vuoto.
❓ Perché vedo “json_encode error: Malformed UTF-8 characters, possibly incorrectly encoded”?
Rimuovi eventuali caratteri speciali presenti:
-
negli indirizzi,
-
nella descrizione della merce,
-
nei dettagli del CN22
-
.
❓ Perché vedo “Documenti ETD non correttamente allegati all'ordine”?
Se trovi più documenti della stessa tipologia allegati a un ordine, controlla che la modalità Test sia disattivata nella connessione UPS:
👉 Vai in Corrieri, clicca su Modifica accanto al logo UPS.
❓ Perché vedo “RSS web service currently unavailable”?
Questo errore indica che il sistema UPS che gestisce tracciamenti e aggiornamenti pacchi ha un problema temporaneo.
👉 Soluzione: attendi un po’ e rielabora la spedizione, così il corriere ha il tempo di ripristinare il servizio
.
❓ Perché vedo “Missing or invalid ship from address”?
Controlla se hai selezionato l’opzione Use your company info as default shipper nella connessione UPS: questo può causare errore se l’indirizzo non corrisponde a quello in Il Mio Profilo > Informazioni sul Mittente.
❓ Perché ricevo tariffe errate per alcuni paesi?
Per alcuni Paesi (es. Emirati Arabi Uniti, Slovenia) UPS potrebbe non mostrare tariffe negoziate in ShippyPro a causa di limitazioni.
👉 Ti consigliamo di verificare con il tuo referente UPS.
❓ Perché vedo “The Delivery Confirmation option cannot be combined with the Return Services option. (among the excluded carriers)”?
Questo errore indica che la spedizione (di solito un reso) non è compatibile con l’opzione Signature required selezionata in Corrieri > UPSv2 > Modifica.
-
.
❓ Perché vedo “UPS Account is not authorized for Hold for Pickup at UPS Access Point Shipment”?
Se spedisci tramite API, assicurati di:
-
selezionare l’opzione corriere Pickup Point Mode,
-
inserire il valore 02.
❓ Perché vedo “Missing or invalid service code”?
Assicurati che il servizio selezionato in Corrieri > UPS > Modifica sia corretto.
📌 Se crei etichette via API:
-
non scegliere All services,
-
seleziona invece il servizio specifico e includilo nella chiamata API.
❓ Perché vedo “SYSTEM.UNEXPECTED.ERROR GENERIC.ERROR”?
Questo errore può apparire durante la prenotazione di un ritiro.
👉 Prova a ripetere l’operazione un paio di volte.
👉 In alternativa, controlla se l’opzione Test Mode è attiva nella connessione e disattivala
.
❓ Perché vedo “Invalid or Missing ShipmentIdentificationNumber”?
Può accadere se l’ordine era stato spedito con un altro corriere e poi modificato.
Alcuni corrieri non supportano la funzione VoidShipment (cancellazione spedizione): il trackingID resta associato all’ordine e non viene accettato da UPS.
❓ Perché vedo “Invalid or missing international forms form type for shipment with return service. Valid value is 01 or 05”?
Per le spedizioni di reso, alcuni documenti ETD non sono accettati.
👉 Soluzione:
-
Rimuovi l’ETD da Gestione Fatture,
-
Attiva nella connessione UPS l’opzione corretta per generare la fattura commerciale UPS.
❓ Perché vedo “Invalid Unit of Measurement for the given country”?
Disattiva l’opzione Utilizza le informazioni della tua azienda come mittente predefinito in Corrieri > UPS > Modifica e riprova.
.
❓ Perché vedo “Number of Packages must be specified”?
Controlla che nella chiamata Ship sia indicata correttamente la Packaging Type Quantity.

❓ Perché vedo “A shipment can only contain one Commercial Invoice”?
Questo errore compare quando carichi più di una fattura commerciale per la stessa spedizione.
👉 Soluzione:
-
Non caricare documenti ETD se hai già attivato Generate Commercial Invoice nella connessione,
-
Assicurati di non aver caricato due volte i documenti via API,
-
Cancella i documenti ETD da Gestione fatture,
-
Correggi l’ordine.
❓ Perché vedo “Missing or invalid PackageIdentifier”?
Questo errore si verifica nelle spedizioni di Merci Pericolose quando manca o è errato l’Identificativo del pacco.
👉 Devi richiedere a UPS l’identificativo corretto.
📌 Nota: il campo ha una lunghezza di 5 cifre.
❓ Perché vedo “UPS: Failure: Client error: POST … resulted in a 429 Too Many Requests”?
Questo errore può apparire durante la comparazione delle tariffe se UPS riceve troppe richieste contemporanee.
👉 Soluzione: aggiorna la pagina e riprova più tardi.
❓ Perché vedo “Invalid service designation”?
Questo errore indica che il servizio selezionato non supporta pick-up nella località indicata.
👉 Ti consigliamo di verificare direttamente con UPS.
❓Ho creato una spedizione con UPS, ma non riesco a visualizzare l’etichetta da stampare — vedo solo il numero di tracking. Perché?
Verifica se stai utilizzando un servizio UPS che non prevede la generazione di etichette stampabili. In particolare, UPS Return Service 1-Attempt (RS1), UPS Return Service 3-Attempt (RS3) e UPS Electronic Return Label (ERL) non restituiscono etichette da stampare.