La maggior parte degli errori UPS dipende da poche cause: un campo troppo lungo, un carattere speciale che UPS non riesce a leggere, un codice di provincia o di stato nel formato sbagliato, oppure credenziali dell'account che non corrispondono a quelle registrate da UPS. In questa guida trovate i messaggi di errore UPS più frequenti durante la creazione delle etichette nella piattaforma di spedizione ShippyPro, con la causa e la soluzione per ciascuno.
Gli errori sono raggruppati per tipo (account, indirizzi, dogana, tariffe, etichette, ritiri e API), così potete andare direttamente alla sezione che corrisponde al messaggio che vedete. Se non avete ancora collegato UPS, partite dalla pagina dell'integrazione UPS e dall'elenco completo delle integrazioni ShippyPro.
Nota: i messaggi di errore sono riportati in inglese, esattamente come li restituisce UPS, così potete ritrovarli facilmente.
UPS non supporta l'intero set di caratteri Unicode e converte automaticamente i caratteri speciali in caratteri "sicuri". Per questo simboli, caratteri non latini e lettere accentate (ä, ö, ü, è, ì, ò, à) possono risultare corrotti o distorti sull'etichetta di spedizione stampata.
Ogni ordine UPS non andato a buon fine finisce nella sezione Errori della dashboard. Ecco come trovare la causa e correggerla:
Dalla dashboard di ShippyPro, andate su Ordini > Errori.
Cliccate su Come risolvere? per vedere le istruzioni dettagliate per quell'errore.
Usate l'icona della chiave inglese per modificare i dettagli della spedizione.
Una nota prima dell'elenco degli errori: ShippyPro non supporta il servizio UPS World Ease.
Questi errori UPS di solito indicano che il numero di account, la password o la chiave di accesso collegati a ShippyPro non corrispondono a quelli registrati da UPS.
Le tariffe del vostro contratto non sono ancora state sincronizzate.
Il numero di account (Account Number) potrebbe essere errato o sospeso. 👉 Verificate con il vostro referente UPS.
Per risolvere questo errore contattate il vostro referente UPS.
Di solito si verifica quando il numero di account usato come mittente non è stato aggiunto e autenticato nel profilo My UPS del cliente su ups.com, nella sezione Billing and Account Numbers.
Importante: questo controllo può farlo solo il cliente, accedendo a ups.com con le stesse credenziali usate per creare l'applicazione che genera i token OAuth 2.0 (configurata tramite il portale UPS Developer).
Per risolvere:
Le cause più comuni sono due:
La vostra chiave di accesso XML non è valida.
Il codice di errore UPS 250002 compare quando la password dell'account UPS non corrisponde più a quella indicata al momento della configurazione (perché è stata reimpostata o modificata). Se aggiornarla non basta, eliminate la connessione e createne una nuova dalla sezione Corrieri.
📌 Nota: dopo aver eliminato la connessione, i link di tracking e gli aggiornamenti degli ordini precedenti non saranno più disponibili.
La password UPS salvata in ShippyPro non corrisponde più al vostro account UPS (è stata reimpostata o modificata) e sono stati fatti troppi tentativi con la password sbagliata. Per risolvere:
Questo messaggio arriva direttamente dal server UPS. 👉 Contattate il vostro referente UPS o il servizio clienti del corriere per capire perché l'account è bloccato.
UPS non riconosce il numero di account usato per la fatturazione.
Create una nuova connessione UPSv2 dalla pagina Corrieri.
Per addebitare i costi a un numero di account di terzi, usate le opzioni corriere exw_third_party_zipcode e exw_third_party_country per inserire i dati del pagante. Senza questi parametri vengono usati per default i dati del destinatario.
Ci sono due possibili soluzioni, a seconda della vostra configurazione:
UPS è molto rigido su lunghezza e formato dei campi. La maggior parte degli errori di indirizzo nasce da testi oltre il limite di 35 caratteri, CAP nel formato sbagliato o province scritte per intero.
I campi Nome e Azienda non possono superare i 35 caratteri sulle etichette UPS.
Il CAP deve contenere esattamente 5 cifre, senza caratteri speciali come "-" o "/".
Nel campo Provincia del destinatario usate la sigla della provincia. Scrivere il nome per intero genera l'errore.
Controllate il campo Stato/Provincia del mittente e usate la sigla per le province italiane. Per alcuni paesi (come i Paesi Bassi) questo campo può restare vuoto per UPS: cancellate i dati inseriti ed elaborate di nuovo la spedizione.
Inserite la sigla della provincia o il codice ISO nel campo Stato/Provincia del destinatario (es. Barcellona > B, Alicante > A). Se non funziona, rielaborate l'ordine lasciando il campo vuoto.
Il campo Stato/Provincia non può superare i 5 caratteri. Se è più lungo, sostituitelo con la sigla corretta della provincia ed elaborate di nuovo l'ordine.
Spedite in Irlanda (128100)? Assicuratevi che il campo Provincia contenga il codice ISO corretto del paese di destinazione. Per le spedizioni in Irlanda, inserite "IE" nel campo Stato/Provincia ed elaborate di nuovo la spedizione. Se l'errore continua, sostituite il CAP con "IED".
UPS non riconosce "PR" come sigla di stato per Porto Rico. Impostate Porto Rico come paese al posto di USA e lasciate vuoto il campo stato.
UPS esegue un controllo di validazione e restituisce questo errore quando Indirizzo, Città, CAP o Stato non corrispondono all'indirizzo reale. Controllate tutti e quattro i campi.
Per le spedizioni verso gli Stati Uniti, un CAP valido è composto da 5 cifre e nessuna lettera.
Controllate il CAP e la città.
Il campo Indirizzo 2 del mittente o del destinatario è troppo lungo. Il massimo è 35 caratteri.
Se vedete questo errore con UPSv2, verificate che l'indirizzo del mittente:
📌 Nota: se avete attivato Usa i dati della tua azienda come mittente fisso nella finestra di connessione del corriere (Corrieri > UPSv2 > Modifica), l'indirizzo controllato da UPS è quello in Il mio profilo > Info mittente. Il campo Indirizzo deve rispettare il limite di caratteri e il campo N. civico deve contenere solo il numero civico.
📌 Il limite complessivo di Indirizzo 1 e Indirizzo 2 è di 35 caratteri, spazi inclusi.
Il campo indirizzo di UPS ha un limite di 35 caratteri e gli indirizzi più lunghi generano questo errore. 👉 Usate il campo Indirizzo 2 per i dettagli aggiuntivi, come il nome sul campanello o il numero dell'interno.
Controllate se nella connessione UPS è selezionato Usa i dati della tua azienda come mittente predefinito. Se l'indirizzo non corrisponde a quello in Il mio profilo > Info mittente, può causare questo errore.
Potete risolverlo in tre modi:
"IsReturn": true alla richiesta Ship.Togliete la spunta da Usa i dati della tua azienda come mittente predefinito in Corrieri > UPS > Modifica ed elaborate di nuovo la spedizione.
Se avete selezionato Mittente fisso nel modulo di connessione UPS, i dati del mittente vengono presi direttamente da Il mio profilo > Info mittente. Assicuratevi che nome e cognome inseriti lì non superino i 35 caratteri.
Il numero di telefono del destinatario deve avere almeno 10 caratteri alfanumerici. Tenete presente che:
Scoprite come ShippyPro collega UPS e gli altri corrieri al vostro negozio in un'unica piattaforma. Prenotate una demo con il nostro team.
Le spedizioni UPS internazionali aggiungono dati doganali, dettagli CN22 e documenti ETD. Questi sono gli errori più frequenti.
Il campo Descrizione prodotto accetta al massimo 35 caratteri. Verificate di non aver superato il limite.
UPS limita il campo descrizione articolo a 35 caratteri. Controllatene la lunghezza e accorciatelo se serve.
Eliminate tutti i caratteri speciali dalla descrizione degli articoli spediti, compresa la descrizione nel documento CN22.
Eliminate tutti i caratteri speciali da indirizzi, descrizione della merce e dettagli CN22.
Il Paese di origine indicato nel CN22 potrebbe essere errato. Se avete configurato la sezione Info doganali in Il mio profilo, verificate che a ogni SKU interessato sia associato un Paese di origine valido.
Assicuratevi che il numero IOSS sia inserito correttamente in Il mio profilo > Info mittente. Se l'errore continua, provate a rimuovere il numero IOSS e a confermare di nuovo la spedizione.
Il valore massimo supportato per i resi è di 999 USD, eventualmente convertiti in EUR.
Disattivate l'opzione Aggiungi spese di trasporto alla fattura commerciale nella finestra di connessione.
Dal 6 marzo 2023 tutti i pacchi spediti verso, dal o all'interno del Messico devono avere una descrizione degli articoli a livello di collo. 👉 Aggiungetela alle vostre spedizioni per il Messico.
L'ordine supera il numero massimo di prodotti che UPS accetta in una singola spedizione:
| Tipo di documento | Numero massimo di prodotti per spedizione UPS |
|---|---|
| Package Packing List | 50 |
| Commercial Invoice, NAFTA, CO, EEI | 100 |
| Air Freight packing list | 1.000 |
Nella finestra di connessione, spuntate Richiedi la fattura commerciale UPS insieme all'etichetta. Se non funziona, chiedete al vostro commerciale UPS se siete autorizzati a generare i moduli esternamente.
Succede quando per la stessa spedizione viene caricata più di una fattura commerciale. Verificate che:
👉 Rimuovete i documenti ETD da Gestione fatture e correggete l'ordine.
Se allo stesso ordine risultano allegati più documenti dello stesso tipo, verificate che la Modalità test sia disattivata nella connessione UPS: andate nella sezione Corrieri e cliccate su Modifica accanto al logo UPS.
Per le spedizioni di reso, il documento ETD caricato potrebbe non essere valido, perché UPS non accetta alcuni tipi di allegato per i resi. 👉 Per risolvere:
Quando caricate documenti per una spedizione UPS internazionale, scegliete il tipo di documento corretto:
FormType = 99.UPS accetta il tipo "Altro" / "99" perché corrisponde alla categoria "07 - Customer Generated Forms" usata dai suoi sistemi.
L'opzione corriere upsv2documents_only funziona solo quando il paese di origine e quello di destinazione sono diversi. Inoltre, l'origine non può essere gli USA e la destinazione non può essere CA, PR o MX.
UPS non accetta l'incoterm usato (DDP, EXW, ecc.) per questa spedizione. Cambiatelo e riprovate.
È un problema temporaneo del server UPS. Riprovate più tardi.
Se le tariffe mostrate quando spedite con UPS non corrispondono a quelle negoziate nel vostro contratto, provate questi passaggi:
Per alcuni paesi (es. Emirati Arabi Uniti, Slovenia), limitazioni del corriere possono impedire la visualizzazione delle vostre tariffe negoziate o scontate in ShippyPro. 👉 Verificate con il vostro referente UPS.
Se non vedete le tariffe UPS e questo errore compare tra i corrieri esclusi, aprite la finestra di connessione UPS e togliete la spunta da Visualizza tariffe con tempo di transito. Se i vostri numeri di tracking vengono creati nel formato 1ZXXXXXXXXXXXXXXXX, potrebbe essere necessario anche disattivare la Modalità test da Corrieri > Connessioni > Modifica.
Il messaggio completo è "Failure: Unable to determine destination for Time in Transit Information. / Time in Transit information Unavailable. (111598)". Disattivate Visualizza tempo di transito da Corrieri > Connessione > UPS > Modifica e create di nuovo l'etichetta.
Assicuratevi che l'opzione Visualizza tariffe con tempo di transito sia spuntata nella connessione del corriere.
Il servizio selezionato non può consegnare fisicamente dall'origine alla destinazione, oppure non è disponibile per quella destinazione. Per le spedizioni internazionali, verificate anche di aver inserito i dettagli CN22. Poi controllate che:
📌 I CAP 6991, 6992 e 6993 non sono raggiungibili dall'Austria e vengono serviti solo dalla Germania. Usate i CAP tedeschi corrispondenti e impostate la Germania come paese di destinazione.
L'errore dipende dal codice del servizio. Verificate che il servizio selezionato sia disponibile dall'indirizzo del mittente.
Controllate il tipo di servizio impostato nella connessione del corriere da Corrieri > UPS > Modifica. Se spedite tramite API:
UPS SurePost non è disponibile nel creatore di etichette standard. Potete usarlo solo come servizio tramite una chiamata all'API di spedizione.
Aprite il vostro template UPSv2 da Corrieri > Modifica e scegliete il servizio di reso corretto dal menu a tendina Tipo di servizio di reso.
Gestite molti resi? Scoprite come funziona ShippyPro Easy Return.
La spedizione (di solito un reso) non è compatibile con l'opzione Firma richiesta selezionata nella connessione UPSv2 della pagina Corrieri.
Andate su Corrieri > UPSv2 > Modifica e scegliete l'opzione che vi serve dal menu a tendina Opzione firma alla consegna.
Il contrassegno non è disponibile per questa spedizione. Verificate con il vostro referente UPS che il contrassegno sia attivo sul vostro contratto. Tenete presente che il contrassegno potrebbe non essere supportato per le spedizioni verso la Svizzera.
Se compare quando richiedete le tariffe UPS, verificate che il campo Valore totale non sia vuoto.
UPS non accetta spedizioni multicollo per la destinazione selezionata. Contattate il vostro account manager per i dettagli su questa limitazione.
Le cause più comuni sono due:
Questo errore può comparire anche come "Missing package description".
Per le spedizioni manuali:
Per gli ordini da marketplace:
L'errore dipende dall'opzione selezionata nella sezione Preferenze. 👉 Sceglietene un'altra, ad esempio il numero d'ordine.
L'errore riguarda il campo Reference Number (numero di riferimento del collo) inviato a UPS. In ShippyPro il campo TransactionID dell'ordine corrisponde direttamente al parametro ReferenceNumber, quindi l'errore compare quando quel valore non rispetta le regole UPS. Controllate il TransactionID dell'ordine in errore e verificate che:
Verificate di non usare un servizio che non restituisce etichette stampabili: UPS Return Service 1-Attempt (RS1), UPS Return Service 3-Attempt (RS3) e UPS Electronic Return Label (ERL) non restituiscono etichette.
Le etichette UPS non stampano quel campo. 👉 L'informazione viene comunque trasmessa automaticamente al corriere compilando CarrierNote tramite API.
Sono impostazioni dell'etichetta UPS che non si possono modificare. 👉 Nessun problema: tutte le informazioni vengono comunque trasmesse correttamente al corriere.
Non potete modificare una spedizione già creata. 👉 Create una nuova spedizione da zero.
Può succedere quando la spedizione non è stata consegnata al destinatario, il processo di reso era già partito ed è stato assegnato un nuovo numero di tracking al reso. Se vi serve una nuova spedizione, createne una manuale con gli stessi dati per evitare l'errore.
Verificate se l'ordine è stato spedito prima con un altro corriere e poi modificato. I corrieri che non supportano la funzione VoidShipment lasciano il proprio ID di tracking sull'ordine, che il nuovo corriere potrebbe rifiutare.
Le cause possono essere diverse. Seguite questi passaggi in ordine:
Per verificarlo:
Non tutti i servizi UPS inviano notifiche di tracking. Potete riconoscerle dal NotificationCode:
| NotificationCode | Notifica | Si applica a |
|---|---|---|
| 2 | Notifica di reso o creazione etichetta | Solo spedizioni di reso. Non applicabile a GFP (Ground Freight Pricing) |
| 5 | Notifica in transito | Solo spedizioni di reso |
| 6 | Notifica di spedizione | Solo spedizioni in uscita |
| 7 | Notifica di eccezione | Non applicabile a GFP |
| 8 | Notifica di consegna | Tutte le spedizioni |
Volete aggiornamenti di tracking brandizzati per tutti i vostri corrieri? Scoprite ShippyPro Track & Trace.
Se avete selezionato un ID punto di ritiro tramite l'opzione corriere, dovete selezionare anche una Modalità punto di ritiro (Hold for Pickup o Access Point Delivery), e viceversa.
Se spedite tramite API con l'opzione corriere Modalità punto di ritiro, inserite il codice corretto nel parametro "value":
Quando spedite tramite API, selezionate l'opzione corriere Modalità punto di ritiro e impostate il valore 02.
Compilate sia il numero di telefono sia l'indirizzo email nei campi to_address.
Se compare quando prenotate un ritiro:
Se lo vedete durante la prenotazione di un ritiro, il servizio che state usando non supporta i ritiri da quell'origine. 👉 Verificate con UPS.
UPS richiede un intervallo minimo tra l'orario in cui il pacco è pronto per il ritiro (ready time) e l'orario di chiusura per quella sede. Se l'orario di chiusura è troppo vicino a quello di disponibilità, la prenotazione non va a buon fine. Per risolvere:
Alcuni errori UPS non dipendono dai vostri dati. Arrivano dai server UPS e di solito si risolvono da soli.
È un problema temporaneo del server UPS. Provate a confermare di nuovo l'ordine più tardi.
Se compare mentre confrontate le tariffe, aggiornate la pagina. UPS potrebbe ricevere un volume elevato di richieste e non riuscire a elaborarle tutte insieme. 👉 Riprovate più tardi.
Il sistema UPS che gestisce le richieste di tracking e gli aggiornamenti dei pacchi ha un problema: il corriere non riesce a comunicare con il proprio server e la spedizione non può essere elaborata. 👉 Aspettate un po' e poi rielaborate la spedizione, così UPS ha il tempo di risolvere il problema.
Se collegate il vostro negozio o ERP tramite l'API di ShippyPro, questi sono gli errori dell'API UPS da tenere d'occhio.
Il campo CarrierName nella chiamata API non è compilato correttamente. Con la connessione UPSv2 deve essere:
"CarrierName": "UPSv2"Assicuratevi che l'opzione corriere Packaging Type Quantity sia indicata correttamente nella chiamata Ship.
Per inviare il valore 01 (UPS Letter / busta), includete "package": 1 nella chiamata Ship. Senza questo campo, ShippyPro invia per default il valore 2. Controllate il payload inviato dal vostro ERP o i log API nella pagina API di ShippyPro.
Succede quando spedite merci pericolose e l'opzione "Package identifier" manca o non è valida. Chiedete a UPS l'identificativo da usare per la spedizione.
📌 Nota: il campo è lungo 5 cifre.
Includete nella chiamata API l'opzione corriere upsv2hazardous_materials impostata a 1. Da sola però non basta: UPS richiede anche diversi campi che descrivono la merce e, senza di essi, la spedizione restituisce un errore.
| Opzione corriere | Contenuto |
|---|---|
upsv2hazmat_regulation_set |
La normativa applicabile (es. ADR, IATA, CFR, TDG) |
upsv2hazmat_transportation_mode |
La modalità di trasporto |
upsv2hazmat_commodity_regulated_level_code |
Il livello di regolamentazione (es. FR, LQ, EQ, LR) |
upsv2hazmat_proper_shipping_name |
Il nome ufficiale della merce pericolosa |
upsv2hazmat_id_number |
Il numero UN/NA/ID del prodotto |
upsv2hazmat_class_division_number |
La classe/divisione di pericolo |
upsv2hazmat_packaging_type e upsv2hazmat_packaging_type_quantity |
Tipo e quantità dell'imballaggio |
upsv2hazmat_quantity e upsv2hazmat_uom |
La quantità di merce e la relativa unità di misura |
upsv2hazmat_emergency_contact e upsv2hazmat_emergency_phone |
Nome e numero di telefono di un contatto per le emergenze |
La maggior parte degli errori UPS dipende da limiti e formati dei campi: nomi, indirizzi e descrizioni oltre i 35 caratteri, CAP nel formato sbagliato e province scritte per intero invece della sigla. Subito dopo vengono i problemi di account, come un numero di account non collegato al profilo ups.com o una password non aggiornata.
Andate su Ordini > Errori in ShippyPro, correggete i dati e poi usate Azioni > Correggi in blocco gli ordini in errore per rielaborarli insieme. Per un singolo ordine, cliccate su Correggi ordine.
UPS non supporta l'intero set di caratteri Unicode e converte i caratteri speciali in caratteri "sicuri". Simboli, caratteri non latini e lettere accentate come è o ü possono apparire distorti sull'etichetta, quindi è meglio evitarli in indirizzi e descrizioni degli articoli.
Prenotate una demo e scoprite come ShippyPro gestisce etichette, tariffe e tracking delle vostre spedizioni UPS.