Come risolvere gli errori UPS

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.

Come controllare e risolvere gli errori UPS in ShippyPro

Ogni ordine UPS non andato a buon fine finisce nella sezione Errori della dashboard. Ecco come trovare la causa e correggerla:

Una nota prima dell'elenco degli errori: ShippyPro non supporta il servizio UPS World Ease.

Errori UPS di account, credenziali e autenticazione

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.

"User Id and Shipper Number combination is not qualified to receive negotiated rates"

Le tariffe del vostro contratto non sono ancora state sincronizzate.

• Verificate che le credenziali siano corrette.
• Se lo sono, contattate UPS e chiedete di abilitare le vostre tariffe via API.

"The shipper number cannot be used for the shipment"

Il numero di account (Account Number) potrebbe essere errato o sospeso. 👉 Verificate con il vostro referente UPS.

"The Shipper's shipper number cannot be used for the shipment"

Per risolvere questo errore contattate il vostro referente UPS.

Errore UPS "Missing or invalid shipper number"

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:

• Accedete a ups.com con lo stesso User ID e la stessa password usati per l'API di spedizione.
• Andate su My UPS > Billing and Account Numbers.
• Verificate che il numero di account sia stato aggiunto e autenticato. In caso contrario, selezionate Add a UPS Account e seguite i passaggi.
• Assicuratevi che le eventuali lettere del numero di account siano maiuscole (es. 1A2345), altrimenti l'autenticazione non funziona.

Il numero di account dell'API di spedizione non è stato aggiunto al profilo ups.com

Le cause più comuni sono due:

1. Numero di account non configurato: l'Account Number del mittente usato per l'API di spedizione non è collegato al vostro profilo ups.com. Assicuratevi che sia associato correttamente al vostro account UPS.
2. Credenziali non coerenti con l'ambiente: state usando credenziali di produzione con la Modalità test attiva, o il contrario. Usate le credenziali di test con la Modalità test attiva e quelle di produzione con la Modalità test disattivata.

"Failure: Invalid Access License number (250003)"

La vostra chiave di accesso XML non è valida.

• Ricontrollate la chiave.
• Assicuratevi di avere l'accesso di produzione all'API di validazione indirizzi di UPS.

Errore UPS 250002: "Invalid Authentication Information"

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.

"The maximum number of user access attempts was exceeded (250006)"

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:

1. Controllate la password nella finestra di connessione.
2. Contattate UPS per sbloccare l'account.
3. Correggete l'ordine.

"Failure: The UserId is currently locked out, please try again in 30 minutes. (250007)"

Questo messaggio arriva direttamente dal server UPS. 👉 Contattate il vostro referente UPS o il servizio clienti del corriere per capire perché l'account è bloccato.

"Invalid Bill-To type. (120444)"

UPS non riconosce il numero di account usato per la fatturazione.

"Invalid/Missing Refresh Token"

Create una nuova connessione UPSv2 dalla pagina Corrieri.

"UPS account number that was provided as the payment method is missing or invalid"

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.

"The country associated with Shipper's ShipperNumber must be the same as the shipment's Shipper's country" (120120)

Ci sono due possibili soluzioni, a seconda della vostra configurazione:

• Attivate o disattivate Usa i dati della tua azienda come mittente fisso e Usa i dati della tua azienda come mittente fisso per i resi da Corrieri > UPS > Modifica.
• Se l'errore persiste, il codice cliente usato per la connessione potrebbe non consentire un indirizzo mittente estero. Verificate questo limite con il vostro referente del corriere.

Errori UPS di indirizzo, nome e limite di caratteri

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.

"Name and company fields must be shorter than 35 characters"

I campi Nome e Azienda non possono superare i 35 caratteri sulle etichette UPS.

Errore UPS sul CAP: "Postal Code length must be 5 numbers"

Il CAP deve contenere esattamente 5 cifre, senza caratteri speciali come "-" o "/".

"Province must be in the form of an abbreviation"

Nel campo Provincia del destinatario usate la sigla della provincia. Scrivere il nome per intero genera l'errore.

"Missing or invalid ship from StateProvinceCode (120306)"

• Disattivate Abilita Paperless se è attivo.
• Selezionate Usa i dati della tua azienda come mittente fisso da Corrieri > UPS > Modifica.
• Aggiornate la spedizione cliccando su Modifica e poi su Conferma nel menu Etichette di spedizione.

"Missing or invalid ship from state province code"

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.

"Missing or invalid ship to state province code"

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.

"Invalid sold to state province code. Valid length is 0 to 5 alphanumeric"

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".

"PR is not a valid state for the specified shipment"

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.

Errore di validazione indirizzo UPS: "Failure: Address Validation Error on ShipTo address (120802)"

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.

"Invalid Destination (111542)"

Controllate il CAP e la città.

"Invalid ShipFrom AddressLine2" e "Failure: Invalid ShipTo AddressLine2 (120203)"

Il campo Indirizzo 2 del mittente o del destinatario è troppo lungo. Il massimo è 35 caratteri.

"Missing or invalid ship from address line 1"

Se vedete questo errore con UPSv2, verificate che l'indirizzo del mittente:

• sia valido e geolocalizzabile;
• non superi i 35 caratteri spazi inclusi (35 per Indirizzo 1 e 35 per Indirizzo 2).

📌 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.

"Missing or invalid ship to address line 1"

• Accorciate Indirizzo 1 a massimo 35 caratteri, spazi inclusi.
• Eliminate il campo Indirizzo 2 per evitare discrepanze con la mappa stradale del corriere. UPS unisce Indirizzo 1 e Indirizzo 2, quindi usate Indirizzo 2 solo quando l'indirizzo principale non entra in Indirizzo 1.

📌 Il limite complessivo di Indirizzo 1 e Indirizzo 2 è di 35 caratteri, spazi inclusi.

"Missing or invalid shipper address line 1"

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.

"Missing or invalid ship from address"

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.

"Failure: The ShipFrom country must be the same as the Shipper country (120317)"

Potete risolverlo in tre modi:

• Andate su Corrieri > Connessione > UPS > Modifica e attivate Usa i dati della tua azienda come mittente fisso.
• Impostate l'ordine come etichetta di reso cliccando sul selettore del reso prima di crearla.
• Se usate l'API, aggiungete "IsReturn": true alla richiesta Ship.

"Invalid Unit of Measurement for the given country"

Togliete la spunta da Usa i dati della tua azienda come mittente predefinito in Corrieri > UPS > Modifica ed elaborate di nuovo la spedizione.

Errori su nome e ragione sociale

• "Missing or invalid ship from company name": verificate che il campo Azienda dell'ordine sia compilato correttamente.
• "Missing or invalid ship to company name": correggete il campo Nome destinatario in modo che non superi i 35 caratteri.
• "Missing or invalid Shipper AttentionName": il campo Nome mittente accetta al massimo 35 caratteri, spazi inclusi.

"ShipTo PhoneNumber must be at least 10 alphanumeric characters"

Il numero di telefono del destinatario deve avere almeno 10 caratteri alfanumerici. Tenete presente che:

• i numeri composti solo da zeri (es. 0000000000) o che iniziano con 0 non sono validi;
• il numero deve rispettare il formato telefonico del paese di destinazione.

Meno tempo a correggere le etichette UPS

Scoprite come ShippyPro collega UPS e gli altri corrieri al vostro negozio in un'unica piattaforma. Prenotate una demo con il nostro team.

Errori UPS di dogana, spedizioni internazionali e fattura commerciale

Le spedizioni UPS internazionali aggiungono dati doganali, dettagli CN22 e documenti ETD. Questi sono gli errori più frequenti.

"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 al massimo 35 caratteri. Verificate di non aver superato il limite.

"Failure: Invalid merchandise description of package (120623)"

UPS limita il campo descrizione articolo a 35 caratteri. Controllatene la lunghezza e accorciatelo se serve.

Errore UPS 10002: "To be reprocessed: Failure: The request is well formed but the request is not valid"

Eliminate tutti i caratteri speciali dalla descrizione degli articoli spediti, compresa la descrizione nel documento CN22.

"json_encode error: Malformed UTF-8 characters, possibly incorrectly encoded"

Eliminate tutti i caratteri speciali da indirizzi, descrizione della merce e dettagli CN22.

"Invalid or missing product origin country code for product number 1"

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.

"Missing or Invalid Vendor Collection ID Number"

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.

"The maximum declared amount was exceeded. Maximum value per package: 856 EUR. (121025)"

Il valore massimo supportato per i resi è di 999 USD, eventualmente convertiti in EUR.

"Invalid freight charges monetary value. Valid length is 0 to 15 numeric and can hold up to 2 decimal places"

Disattivate l'opzione Aggiungi spese di trasporto alla fattura commerciale nella finestra di connessione.

Perché le mie spedizioni verso il Messico vanno in errore?

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.

"Invalid number of products"

L'ordine supera il numero massimo di prodotti che UPS accetta in una singola spedizione:

"There was an error while uploading the file. Please try again later. Your UPS Account number is not authorized for user generated forms functionality"

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.

"A shipment can only contain one Commercial Invoice"

Succede quando per la stessa spedizione viene caricata più di una fattura commerciale. Verificate che:

• non ci siano documenti ETD caricati mentre l'opzione Genera fattura commerciale è attiva nella connessione del corriere (le due cose non sono compatibili);
• non abbiate caricato i documenti due volte tramite API.

👉 Rimuovete i documenti ETD da Gestione fatture e correggete l'ordine.

"ETD Documents Not Correctly Attached to the Order"

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.

"Invalid or missing international forms form type for shipment with return service. Valid value is 01 or 05"

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:

• Rimuovete l'ETD dalla sezione Gestione fatture.
• Attivate l'opzione corretta nella connessione UPS (sezione Corrieri) per generare correttamente la fattura commerciale UPS.
• Se caricate un vostro documento ETD, scegliete il tipo corretto. Se lo caricate come "Fattura" (Tipo 0), ShippyPro invia a UPS il FormType 01, ma per i documenti personalizzati UPS richiede il FormType 07 / Other (Customer Generated Forms). Caricatelo quindi come Tipo "99" / "Altro": ShippyPro lo convertirà in FormType 07 nella richiesta inviata a UPS.

I miei documenti non vengono inviati correttamente a UPS per le spedizioni internazionali

Quando caricate documenti per una spedizione UPS internazionale, scegliete il tipo di documento corretto:

• Sulla piattaforma ShippyPro, selezionate Altro dal menu a tendina.
• Tramite API, impostate FormType = 99.

UPS accetta il tipo "Altro" / "99" perché corrisponde alla categoria "07 - Customer Generated Forms" usata dai suoi sistemi.

"Shipment DocumentsOnly is invalid with the shipment's origin/destination pair"

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.

"The requested billing option is unavailable between the selected locations"

UPS non accetta l'incoterm usato (DDP, EXW, ecc.) per questa spedizione. Cambiatelo e riprovate.

Errori UPS su tariffe, servizi e tempi di transito

"Negotiated rates are unavailable at this time"

È un problema temporaneo del server UPS. Riprovate più tardi.

Cosa posso fare se le mie tariffe UPS non sono corrette?

Se le tariffe mostrate quando spedite con UPS non corrispondono a quelle negoziate nel vostro contratto, provate questi passaggi:

1. Se vedete l'errore "User Id and Shipper Number combination is not qualified to receive negotiated rates", chiedete a UPS di caricare le vostre tariffe via API.
2. Verificate se l'opzione Mostra tariffe senza IVA è attiva in Il mio profilo > Preferenze.
3. Provate a disattivare Visualizza tariffe con tempo di transito e ad attivare Usa i dati della tua azienda come mittente fisso da Corrieri > Modifica.
4. Se la Modalità test è attiva ma state usando credenziali di produzione, disattivatela da Corrieri > UPS > Modifica.

Perché ottengo tariffe sbagliate per alcuni paesi?

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.

"No matching rate and transit times available (111562)"

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.

Errore UPS 111598: "Unable to determine destination for Time in Transit Information"

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.

Perché il tempo di transito è sbagliato quando richiedo le tariffe?

Assicuratevi che l'opzione Visualizza tariffe con tempo di transito sia spuntata nella connessione del corriere.

"The requested service is unavailable between the selected locations"

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:

• il servizio di spedizione impostato nella finestra di connessione del corriere (Corrieri > UPSv2 > Modifica) sia corretto. Per vedere tutti i servizi che UPS restituisce per quella tratta, selezionate Tutti i servizi come tipo di servizio;
• il CAP sia corretto e corrisponda alla città;
• il CAP non contenga lettere o spazi in più;
• il CAP del mittente sia corretto.

📌 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.

"The requested service is invalid for the shipment origin"

L'errore dipende dal codice del servizio. Verificate che il servizio selezionato sia disponibile dall'indirizzo del mittente.

"Missing or invalid service code"

Controllate il tipo di servizio impostato nella connessione del corriere da Corrieri > UPS > Modifica. Se spedite tramite API:

• non selezionate Tutti i servizi;
• indicate il servizio specifico sia nella connessione sia nella chiamata API.

Perché non vedo UPS SurePost quando creo le spedizioni?

UPS SurePost non è disponibile nel creatore di etichette standard. Potete usarlo solo come servizio tramite una chiamata all'API di spedizione.

"Invalid return service. Check the selected service in carrier configuration"

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.

"The Delivery Confirmation option cannot be combined with the Return Services option"

La spedizione (di solito un reso) non è compatibile con l'opzione Firma richiesta selezionata nella connessione UPSv2 della pagina Corrieri.

Come imposto la firma obbligatoria per tutte le spedizioni UPS?

Andate su Corrieri > UPSv2 > Modifica e scegliete l'opzione che vi serve dal menu a tendina Opzione firma alla consegna.

"The accessory is invalid with the billing option"

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.

"Invalid Shipment Contents Value"

Se compare quando richiedete le tariffe UPS, verificate che il campo Valore totale non sia vuoto.

"Only one package is allowed for this movement"

UPS non accetta spedizioni multicollo per la destinazione selezionata. Contattate il vostro account manager per i dettagli su questa limitazione.

Errori UPS su etichette di spedizione, stampa e descrizioni

"Printing could not be managed for the selected orders, please try again with fewer orders"

Le cause più comuni sono due:

• Etichette ZPL con fattura commerciale UPS: la fattura viene sempre emessa in PDF, quindi i due formati non coincidono. 👉 Impostate il tipo di etichetta su PDF.
• Contrassegno: con il contrassegno UPS restituisce sempre un'etichetta GIF, che ShippyPro converte poi in PDF. Per questo la combinazione contrassegno + ZPL non è supportata. 👉 Usate il PDF.

Errore UPS sulla descrizione del pacco mancante: "Shipment Description is required for this shipment"

Questo errore può comparire anche come "Missing package description".

Per le spedizioni manuali:

• Se avete scelto di stampare "Numero ordine marketplace" in Il mio profilo > Preferenze > Descrizione del contenuto stampata sulle etichette, compilate il campo Numero ordine durante la creazione della spedizione (o il campo TransactionID se spedite tramite API).
• Se l'errore persiste, cambiate l'opzione in "Numero ordine ShippyPro" o "Descrizione ordine".

Per gli ordini da marketplace:

• Inserite SOLO l'ID transazione nel campo Descrizione (articoli).
• Se non basta, selezionate Numero ordine marketplace in Il mio profilo > Preferenze > Descrizione del contenuto stampata sulle etichette.

"Shipment Description cannot exceed the length of 50 characters"

L'errore dipende dall'opzione selezionata nella sezione Preferenze. 👉 Sceglietene un'altra, ad esempio il numero d'ordine.

"Invalid Package Reference Value"

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:

• non superi i 35 caratteri;
• non contenga caratteri speciali (es. /, -, @, lettere accentate).

Ho creato una spedizione UPS ma vedo solo il numero di tracking, non l'etichetta

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.

Perché le mie note UPS non compaiono sull'etichetta?

Le etichette UPS non stampano quel campo. 👉 L'informazione viene comunque trasmessa automaticamente al corriere compilando CarrierNote tramite API.

Perché Indirizzo 1 e Indirizzo 2 sono invertiti, o manca l'Indirizzo 2 del mittente, sull'etichetta?

Sono impostazioni dell'etichetta UPS che non si possono modificare. 👉 Nessun problema: tutte le informazioni vengono comunque trasmesse correttamente al corriere.

"International Shipments cannot be voided at the package level"

Non potete modificare una spedizione già creata. 👉 Create una nuova spedizione da zero.

"The Shipment was not voided"

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.

"Invalid or Missing ShipmentIdentificationNumber"

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.

Errori UPS su notifiche, punti di ritiro e prenotazione dei ritiri

"Missing or invalid Notification/NotificationCode"

Le cause possono essere diverse. Seguite questi passaggi in ordine:

1. Deselezionate tutte le notifiche attive in Corrieri > UPS v2 > Modifica > Notifiche email (usate Ctrl + clic).
2. Se sono già deselezionate, provate a selezionare solo:
   • QV Email Notification
   • QV Exception Notification
   • QV Delivery Notification Mail Innovation
3. Se l'errore persiste, il vostro numero di mittente (Account Number) potrebbe non essere collegato al profilo UPS.com.

Per verificarlo:

• Accedete a ups.com con lo stesso User ID e la stessa password dell'API di spedizione.
• Andate su My UPS > Account Summary.
• Verificate che il vostro account sia nell'elenco. In caso contrario, cliccate su Add a UPS Account e seguite le istruzioni.

Perché non ricevo le notifiche di tracking UPS?

Non tutti i servizi UPS inviano notifiche di tracking. Potete riconoscerle dal NotificationCode:

Volete aggiornamenti di tracking brandizzati per tutti i vostri corrieri? Scoprite ShippyPro Track & Trace.

"Point_mode is required when point_id is set and vice versa"

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.

"Missing or invalid shipment indication type code"

Se spedite tramite API con l'opzione corriere Modalità punto di ritiro, inserite il codice corretto nel parametro "value":

• 01: Hold for Pickup
• 02: Access Point Delivery

"UPS Account is not authorized for Hold for Pickup at UPS Access Point Shipment"

Quando spedite tramite API, selezionate l'opzione corriere Modalità punto di ritiro e impostate il valore 02.

"ADL notification code (012) and notification data (email or phone number) is required for UPS Access Point Delivery"

Compilate sia il numero di telefono sia l'indirizzo email nei campi to_address.

Errore UPS nella prenotazione del ritiro: "SYSTEM.UNEXPECTED.ERROR GENERIC.ERROR"

Se compare quando prenotate un ritiro:

• riprovate ancora un paio di volte, oppure
• disattivate la Modalità test dalla finestra di connessione.

"Invalid service designation"

Se lo vedete durante la prenotazione di un ritiro, il servizio che state usando non supporta i ritiri da quell'origine. 👉 Verificate con UPS.

"Error while booking the pickup: Closing time is less than the minimum window after ready time"

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:

1. Anticipate l'orario di disponibilità: programmate il ritiro al mattino o nel primo pomeriggio invece che nel tardo pomeriggio.
2. Posticipate l'orario di chiusura: se possibile, indicate un orario di chiusura più tardo per allargare la finestra.
3. Controllate gli orari della filiale: verificate che gli orari scelti rientrino negli orari di apertura della vostra filiale UPS locale.
4. Controllate i fusi orari: UPS usa l'ora locale per l'orario di chiusura (PickupAfternoonMaxtime), mentre l'orario di disponibilità (PickupTime) va inviato come timestamp GMT.

Errori temporanei dei server UPS

Alcuni errori UPS non dipendono dai vostri dati. Arrivano dai server UPS e di solito si risolvono da soli.

"Failure of Web Server bridge"

È un problema temporaneo del server UPS. Provate a confermare di nuovo l'ordine più tardi.

• Cliccate su Correggi ordine per riprovare, oppure
• usate Azioni > Correggi in blocco gli ordini in errore se gli ordini interessati sono più di uno.

"Client error: POST https://onlinetools.ups.com/ups.app/xml/Rate resulted in a 429 Too Many Requests"

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.

"RSS web service currently unavailable"

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.

Errori UPS su API e merci pericolose

Se collegate il vostro negozio o ERP tramite l'API di ShippyPro, questi sono gli errori dell'API UPS da tenere d'occhio.

"Invalid Carrier"

Il campo CarrierName nella chiamata API non è compilato correttamente. Con la connessione UPSv2 deve essere:

"Number of Packages must be specified"

Assicuratevi che l'opzione corriere Packaging Type Quantity sia indicata correttamente nella chiamata Ship.

Inviamo il tipo "lettera" via API, ma UPS lo elabora come pacco

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.

"Missing or invalid PackageIdentifier"

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.

Come uso l'opzione UPS per le merci pericolose? ("Shipper is not eligible to ship Hazardous Material / International Dangerous Goods")

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.

Spedite con UPS e tutti i vostri corrieri da un unico posto

Prenotate una demo e scoprite come ShippyPro gestisce etichette, tariffe e tracking delle vostre spedizioni UPS.