Un'etichetta di spedizione vale quanto l'indirizzo che contiene. Eppure i problemi di indirizzo sono tra le cause più comuni di mancata generazione delle etichette, spedizioni in ritardo e richieste di assistenza da clienti che chiedono dove sia il loro ordine. Secondo la ricerca sul last mile delivery 2025 di SmartRoutes, gli errori di indirizzo sono il principale fattore di fallimento delle consegne, responsabili del 45% dei mancati recapiti al primo tentativo, e un'azienda su tre non verifica i dati di indirizzo prima della spedizione.
Questa guida analizza tutti i tipi di errore di indirizzo che bloccano la generazione delle etichette per spedizioni, il loro significato e come risolverli. Mostra inoltre come l'Automazione Spedizioni IA di ShippyPro possa intercettare e correggere i problemi più frequenti prima che blocchino la creazione di un'etichetta.
📋 In questo articolo
Quando l'API di un corriere rifiuta una richiesta di etichetta con un messaggio come "indirizzo di destinazione non valido" o "impossibile spedire a questo indirizzo", significa che uno o più campi dell'indirizzo del destinatario non hanno superato la validazione nel database del corriere. L'errore non proviene dal vostro negozio o dalla piattaforma di spedizione: proviene dal sistema del corriere. Questa distinzione è importante perché la correzione deve avvenire a livello di dati, non nelle impostazioni della piattaforma.
I corrieri gestiscono database di indirizzi con regole rigide e impongono limiti di caratteri, regole di formato e requisiti per i campi che variano per paese e livello di servizio. Un indirizzo valido per le spedizioni domestiche di Poste Italiane può essere rifiutato da DHL Express per una spedizione internazionale allo stesso CAP. Se si tenta di generare un'etichetta con dati che non superano questi controlli, l'API del corriere restituisce un errore e l'etichetta non viene creata.
La conseguenza pratica: l'ordine rimane in stato di attesa, il team operativo deve investigare manualmente e la spedizione del cliente subisce un ritardo. A volumi elevati, ad esempio 4.000-5.000 ordini al mese, anche un tasso del 2% di problemi di indirizzo significa 80-100 ordini problematici al mese che richiedono intervento manuale.
Codici di errore come "030009", "Invalid field length" o "State/Province missing" non sono avvisi generici del sistema. Ognuno indica un problema specifico e risolvibile. Ritentare la generazione dell'etichetta senza correggere i dati sottostanti produrrà lo stesso rifiuto ogni volta. Registrate il codice di errore, identificate il campo coinvolto, correggete i dati, poi riprovate.
Gli errori di indirizzo che bloccano la generazione delle etichette per spedizioni rientrano in sei categorie. Capire con quale tipo si ha a che fare determina come correggerlo e se può essere prevenuto automaticamente in futuro.
Un errore di CAP non valido indica in genere che il codice postale inserito non corrisponde al formato atteso per il paese di destinazione, oppure non corrisponde alla città o allo stato specificati. I CAP italiani sono composti da 5 cifre (es. 20121 per Milano). I codici postali UK seguono il formato AA9 9AA. I codici ZIP statunitensi sono di 5 cifre con estensione +4 opzionale. Una cifra mancante, uno spazio nel posto sbagliato o una lettera nella posizione errata causeranno un rifiuto da parte del corriere.
Il CAP deve inoltre corrispondere alla città e alla provincia/stato sulla stessa etichetta. Se un cliente ha digitato la città in modo errato o ha selezionato la provincia sbagliata dal menu a tendina, la combinazione CAP/città non supererà la validazione anche se entrambi i valori sono tecnicamente validi singolarmente.
Soluzione: Verificate il CAP tramite l'autorità postale del paese di destinazione (Poste Italiane, USPS, Deutsche Post) o utilizzate uno strumento di verifica del corriere come il DHL Capability Tool. Per operazioni ad alto volume, un workflow di formattazione automatica può rimuovere gli spazi in eccesso e standardizzare il formato del CAP prima che venga tentata la generazione dell'etichetta.
Questo errore viene restituito quando l'indirizzo completo (via + città + CAP + paese) non può essere abbinato a un punto di consegna valido nel database del corriere. Le cause comuni includono numeri civici che superano il limite di caratteri del campo indirizzo, dettagli di appartamento o unità inseriti nel campo sbagliato, e nomi di vie con abbreviazioni che il corriere non riconosce.
Per le spedizioni internazionali, i campi indirizzo devono tipicamente utilizzare caratteri dell'alfabeto romano (A–Z, 0–9) soltanto. Caratteri speciali, lettere accentate o scritture non latine vengono rifiutati dalla maggior parte dei corrieri internazionali, inclusi FedEx, DHL Express e UPS, anche se il paese di destinazione utilizza nativamente un sistema di scrittura diverso.
Ogni corriere impone un limite di caratteri per ciascun campo indirizzo. DHL Express, ad esempio, consente fino a 35 caratteri per riga di indirizzo. Se un cliente inserisce una ragione sociale lunga, una descrizione completa dell'appartamento o punteggiatura non necessaria nella Riga Indirizzo 1, la richiesta di etichetta fallisce con un errore "riga indirizzo troppo lunga" o "lunghezza campo non valida".
Soluzione: Spostate il testo in eccesso nella Riga Indirizzo 2. Utilizzate abbreviazioni standard (Via, V.le, P.za, C.so, Snc). Rimuovete qualsiasi testo che non faccia strettamente parte dell'indirizzo di consegna.
Alcuni corrieri richiedono campi che sono opzionali in un modulo di checkout standard. Il numero di telefono è obbligatorio per la maggior parte dei servizi dei corrieri: se un cliente lo lascia vuoto o inserisce "0" come segnaposto, l'etichetta non può essere generata. L'indirizzo email è richiesto per molti servizi transfrontalieri. Lo stato/provincia è obbligatorio per USA, Canada, Australia, Cina e Messico, ma spesso viene lasciato vuoto quando il modulo di checkout non lo impone.
Questo è il tipo di errore più facilmente gestibile tramite automazione. Un workflow che rileva un campo telefono vuoto o non valido e sostituisce un numero di riserva prima della creazione dell'etichetta risolve completamente il problema senza alcun intervento umano.
I corrieri che operano in USA, Canada, Australia e mercati simili richiedono un codice stato/provincia standard di due o tre lettere piuttosto che il nome completo. Inserire "California" invece di "CA", o "Queensland" invece di "QLD", causa il rifiuto dell'indirizzo da parte del corriere. Lo stesso vale per alcuni mercati europei in cui le regioni sono referenziate con codice nei sistemi dei corrieri.
Simboli come #, &, /, trattini insoliti, caratteri accentati ed emoji nei campi indirizzo causano errori di codifica quando i dati vengono inviati all'API del corriere. Questo è particolarmente comune quando gli indirizzi vengono copiati da ordini marketplace o importati da sistemi esterni che non impongono restrizioni sui caratteri in fase di inserimento. L'API del corriere riceve i dati, non riesce ad analizzarli e restituisce un errore "caratteri non supportati nel campo indirizzo".
| Tipo di errore | Messaggio tipico | Causa principale | Soluzione |
|---|---|---|---|
| CAP non valido | "Formato codice postale non valido per il paese di destinazione" | Formato errato, lunghezza errata, o mancata corrispondenza CAP/città | Validare rispetto al formato del paese di destinazione; rimuovere spazi in eccesso |
| Indirizzo di destinazione non valido | "Indirizzo non trovato", "Indirizzo di destinazione non valido" | Caratteri non latini, abbreviazione di via non riconosciuta, indirizzo non presente nel database | Romanizzare i caratteri, espandere le abbreviazioni, verificare tramite strumento del corriere |
| Riga indirizzo troppo lunga | "Lunghezza campo non valida: Via/Indirizzo 1" | Il campo supera il limite di caratteri del corriere (es. 35 caratteri per DHL Express) | Abbreviare con standard; spostare il testo in eccesso nell'Indirizzo 2 |
| Numero di telefono mancante | "Numero di telefono obbligatorio", "Contatto destinatario richiesto" | Campo telefono vuoto o con valore zero | Aggiungere un numero di riserva tramite workflow di automazione |
| Stato/provincia non valido | "Stato/Provincia mancante o non corretto" | Nome completo invece del codice (es. "California" vs "CA") | Utilizzare il codice ISO corretto per stato/provincia del paese di destinazione |
| Caratteri speciali | "Caratteri non supportati nel campo indirizzo" | Simboli, accenti, emoji nella stringa indirizzo | Rimuovere o sostituire i caratteri non validi prima della chiamata API |
L'errore 030009 (scritto anche come "Could not create label. Error: 030009") è un errore di validazione restituito dal corriere che appare più comunemente nella generazione di etichette tramite FedEx. Indica che un campo indirizzo obbligatorio è mancante, formattato in modo errato, o contiene un valore che il sistema del corriere non riesce a validare.
I trigger più frequenti dell'errore 030009 sono:
FedEx richiede un numero di telefono valido del destinatario per la maggior parte dei tipi di servizio. Se il campo telefono è vuoto, contiene solo un segnaposto come "0" o "000-000-0000", o è formattato in modo errato per il paese di destinazione (ad es. manca il prefisso internazionale per le spedizioni internazionali), la creazione dell'etichetta viene bloccata con questo errore.
Per le spedizioni nazionali negli USA e per le spedizioni internazionali verso paesi con requisiti di stato/provincia, FedEx valida il codice stato rispetto a un lookup interno. Inserire il nome completo dello stato, una forma abbreviata non riconosciuta, o lasciare il campo vuoto attiveranno tutti l'errore 030009.
Se la Riga Indirizzo 1 supera il limite di caratteri del corriere, o se i campi indirizzo combinati superano i limiti totali di lunghezza, FedEx restituisce questo codice di errore. È particolarmente comune con gli ordini B2B in cui il nome dell'azienda e il numero dell'unità sono entrambi inseriti nella prima riga dell'indirizzo.
Per risolvere un errore 030009: verificate prima il campo del numero di telefono (la causa più comune), poi il codice stato/provincia, poi la lunghezza di ciascuna riga dell'indirizzo.
Se vedete errori 030009 su più ordini contemporaneamente, esportate tutti gli ordini falliti in un foglio di calcolo e raggruppateli per campo di errore. I pattern emergono rapidamente: una specifica integrazione marketplace potrebbe inviare sistematicamente i nomi degli stati per esteso invece dei codici, oppure gli ordini da un determinato paese potrebbero arrivare sempre senza numero di telefono. Correggere la fonte dei dati una volta sola è molto più efficiente che correggere i singoli ordini uno per uno.
Il formato corretto dell'indirizzo di spedizione varia per paese di destinazione, corriere e tipo di servizio. La tabella seguente copre i mercati di destinazione più comuni e i loro requisiti.
| Destinazione | Formato CAP | Stato/Provincia obbligatorio | Telefono obbligatorio | Restrizioni caratteri |
|---|---|---|---|---|
| Italia | 5 cifre (20121) | No (codice provincia opzionale) | Sì (DHL, GLS) | Caratteri accentati accettati per spedizioni domestiche; solo alfabeto romano per internazionali |
| Stati Uniti | 5 cifre (12345) o ZIP+4 (12345-6789) | Sì — codice ISO a 2 lettere (CA, NY, TX) | Sì (DHL, FedEx, UPS) | Solo alfabeto romano per etichette internazionali |
| Regno Unito | Formato AA9 9AA (es. SW1A 1AA) | No | Sì (DHL, FedEx) | Alfabeto romano; nessun simbolo speciale |
| Germania | 5 cifre (10115) | No (stato opzionale) | Sì (DHL, DPD) | Umlaut (ä, ö, ü) accettati dai corrieri domestici tedeschi; alfabeto romano per etichette internazionali |
| Francia | 5 cifre (75001) | No | Sì (internazionali) | Caratteri accentati accettati per spedizioni domestiche; solo romano per internazionali |
| Australia | 4 cifre (2000) | Sì — codice a 2-3 lettere (NSW, VIC, QLD) | Sì (internazionali) | Solo alfabeto romano |
| Canada | A1A 1A1 — alternanza lettera/cifra | Sì — codice ISO a 2 lettere (ON, BC, QC) | Sì (DHL, FedEx, UPS) | Solo alfabeto romano |
| Giappone | XXX-XXXX (7 cifre con trattino) | Prefettura obbligatoria | Sì (tutti i corrieri) | Caratteri giapponesi accettati da Japan Post / Yamato domestico; solo romano per FedEx/DHL/UPS |
I workflow di automazione di ShippyPro rilevano i numeri di telefono mancanti, formattano i campi indirizzo e correggono gli errori di spedizione prima che una singola etichetta fallisca.
La correzione manuale funziona a bassi volumi di ordini. Non è scalabile a 4.000 o 5.000 spedizioni al mese, dove un tasso del 2% di problemi di indirizzo significa decine di ordini che richiedono attenzione individuale ogni giorno. L'Automazione Spedizioni IA di ShippyPro utilizza un modello trigger/condizione/azione per intercettare i problemi di indirizzo al momento dell'importazione dell'ordine, correggere i dati e passare record puliti alla generazione delle etichette.
Un esempio di workflow utilizzato da un merchant reale di ShippyPro: quando un nuovo ordine viene importato, l'automazione verifica se il numero di telefono del destinatario è vuoto o uguale a zero. Se una delle condizioni è vera, aggiunge automaticamente un numero di telefono di riserva. Una seconda azione — "Formatta info destinatario" — viene quindi eseguita su Città, Stato, CAP, Indirizzo 1 e Indirizzo 2 per correggere problemi comuni come nomi di via troppo lunghi, caratteri non validi e numeri civici fuori posto. Il risultato: le etichette vengono generate senza che un operatore tocchi l'ordine.
La regola per il numero di telefono è l'automazione con il maggiore impatto per la maggior parte dei merchant che gestiscono errori di spedizione. Ecco come è strutturata, basandosi sui template documentati di ShippyPro:
Il workflow si attiva ogni volta che un ordine arriva da qualsiasi negozio o marketplace collegato.
Intercetta gli ordini in cui il cliente ha lasciato il campo telefono vuoto al checkout.
Intercetta gli ordini in cui il checkout richiedeva l'inserimento del telefono e il cliente ha digitato "0" come segnaposto.
Inserisce il numero del vostro servizio clienti o del magazzino come numero di riserva. Questo soddisfa il requisito del corriere senza bloccare l'ordine.
Corregge i problemi di indirizzo più comuni, inclusi nomi di via troppo lunghi, caratteri non validi e numeri civici fuori posto, sui campi Città, Stato, CAP, Indirizzo 1 e Indirizzo 2.
Utenti Shopify: un'impostazione importante. Se il vostro negozio è su Shopify e volete che l'automazione gestisca le attività pre-spedizione come la formattazione dell'indirizzo o l'aggiunta del numero di telefono, selezionate la configurazione "Solo creazione" nella sezione Store del workflow. Questo garantisce che le modifiche vengano preservate e non sovrascritte dalla sincronizzazione di Shopify. Questa impostazione è documentata nell'Help Center di ShippyPro alla sezione Come funziona l'Automazione.
I template di casi d'uso dell'Help Center includono workflow dedicati per ciascun problema di indirizzo comune. Oltre alla regola per il numero di telefono, potete configurare:
Potete creare ognuno di questi dalla sezione Automazione — casi d'uso e template nell'Help Center, oppure accedervi tramite la sezione Automazione nella Piattaforma Spedizioni ShippyPro.
La differenza tra correggere gli errori di indirizzo manualmente e gestirli tramite automazione non è solo una questione di velocità. È la differenza tra un processo reattivo che dipende dal fatto che qualcuno noti un errore, e uno proattivo che previene la maggior parte dei fallimenti prima che si verifichino.
Un'etichetta fallisce. Il team se ne accorge (forse ore dopo). Qualcuno ricerca l'ordine, identifica l'errore, modifica l'indirizzo, ritenta l'etichetta e va avanti — fino al prossimo. Con oltre 80 ordini problematici al mese, questo occupa ore di tempo operativo e ritarda le spedizioni per i clienti coinvolti ogni giorno.
Ogni ordine viene controllato all'importazione. I numeri di telefono mancanti vengono aggiunti, i campi indirizzo vengono formattati e i caratteri non validi vengono corretti prima che venga tentata la generazione dell'etichetta. La maggior parte degli ordini che avrebbero fallito ora riesce al primo tentativo, senza alcun intervento umano.
C'è anche un impatto diretto sull'esperienza del cliente. I dati del settore mostrano che il 22% di tutti i fallimenti di consegna al primo tentativo è causato da informazioni di indirizzo inaccurate, e il 70% degli acquirenti afferma di non voler tornare da un retailer dopo una consegna fallita. Prevenire gli errori di indirizzo non è solo una misura di efficienza operativa: influisce direttamente sui tassi di acquisto ripetuto.
I merchant che vogliono andare oltre possono combinare l'automazione degli indirizzi con ShippyPro Track & Trace per monitorare le spedizioni dopo la spedizione, e con le Notifiche di Spedizione per avvisare proattivamente i clienti in caso di problemi di consegna a valle.
Alcuni problemi di indirizzo non possono essere risolti automaticamente perché richiedono informazioni che solo il cliente possiede: un numero di appartamento mancante, un nome di via errato, o un indirizzo che non esiste nel database del corriere. Per questi casi, l'approccio migliore è aggiungere una nota o un tag all'ordine tramite automazione, in modo che il team operativo possa identificarlo e gestirlo rapidamente, anziché lasciarlo inosservato in stato di errore.
In ShippyPro, potete utilizzare un'azione Aggiungi nota o Aggiungi tag per contrassegnare gli ordini che necessitano di revisione manuale dell'indirizzo. Questo mantiene il team concentrato sugli ordini che richiedono davvero una decisione umana, mentre l'automazione gestisce il resto. Potete anche collegare le integrazioni ShippyPro per instradare gli ordini contrassegnati al vostro helpdesk o CRM per il contatto con il cliente.
Gli errori di indirizzo non riguardano solo il destinatario. Se l'indirizzo del magazzino o del mittente è configurato in modo errato nel vostro account corriere o in ShippyPro, le etichette verranno rifiutate lato origine. I problemi più comuni dell'indirizzo mittente includono righe di indirizzo che superano i limiti di caratteri, CAP non aggiornati e discrepanze tra l'indirizzo registrato nell'account corriere e quello inviato tramite la richiesta di etichetta. Verificate gli indirizzi del magazzino nella Piattaforma Spedizioni ShippyPro e confrontateli con il portale di ciascun corriere almeno una volta al trimestre.
Create workflow trigger/condizione/azione per correggere errori di indirizzo, aggiungere campi mancanti e formattare i dati automaticamente prima della generazione delle etichette.
Scopri l'Automazione →Gestite tutti gli ordini, i corrieri e le etichette da un'unica dashboard centralizzata. Correggete i dati di indirizzo in blocco prima della spedizione.
Vedi la Piattaforma →Monitorate le spedizioni su tutti i corrieri in tempo reale. Intercettate le eccezioni di consegna legate a problemi di indirizzo prima che i clienti contattino l'assistenza.
Vedi Track & Trace →Template passo-passo per workflow di automazione su numero di telefono, formato indirizzo, campo stato, campo città ed email in ShippyPro.
Sfoglia i template →Documentazione completa su come configurare i workflow di automazione, gestire le credenziali dei corrieri e risolvere gli errori di etichetta.
Apri l'Help Center →Specifiche dei campi indirizzo, limiti di caratteri e regole di validazione per paese per la creazione di etichette tramite API.
Leggi la documentazione API →Significa che il sistema del corriere non è riuscito a validare uno o più campi dell'indirizzo del destinatario nel suo database. Le cause più comuni sono un CAP che non corrisponde alla città, un codice stato/provincia mancante, un campo indirizzo che supera il limite di caratteri, o caratteri non latini in un campo che richiede solo alfabeto romano. L'errore proviene dall'API del corriere, non dalla piattaforma di spedizione.
Un CAP può sembrare corretto in isolamento ma non superare la validazione del corriere se non corrisponde alla città e allo stato sulla stessa etichetta. Verificate anche i problemi di formattazione: uno spazio in più, una cifra mancante, o un formato errato per il paese di destinazione attiveranno ciascuno un errore di CAP non valido.
L'errore 030009 è un errore di validazione lato corriere restituito da FedEx. Indica nella maggior parte dei casi un numero di telefono del destinatario mancante o non valido, un codice stato/provincia non riconosciuto, o un campo indirizzo che supera la lunghezza massima consentita. Iniziate verificando il campo del numero di telefono: è la causa nella maggior parte dei casi. Se il numero di telefono è presente e formattato correttamente, verificate il codice stato e poi la lunghezza di ciascuna riga dell'indirizzo.
Non tramite quel corriere senza prima correggere il campo specifico che causa il rifiuto. Correggete i dati (numero di telefono, formato CAP, codice stato o lunghezza del campo a seconda del caso) e riprovate. In alternativa, passate a un corriere diverso con requisiti di validazione meno restrittivi per quella destinazione. In ShippyPro, potete modificare i campi indirizzo direttamente sull'ordine prima di ritentare la generazione dell'etichetta.
L'Automazione di ShippyPro utilizza un modello trigger/condizione/azione. Impostate un trigger (es. "Ordine importato"), una o più condizioni (es. "Il numero di telefono del destinatario è vuoto" o "è uno di: 0"), e una o più azioni (es. "Aggiungi numero di telefono destinatario", "Formatta info destinatario"). Il workflow si esegue automaticamente su ogni ordine corrispondente e passa i dati corretti alla generazione dell'etichetta. Template pronti all'uso per numero di telefono, formato indirizzo, campo stato, campo città e altri errori di indirizzo comuni sono disponibili nell'Help Center di ShippyPro.
Il layer di automazione di ShippyPro intercetta i numeri di telefono mancanti, corregge i formati dei CAP e sistema i campi indirizzo non validi prima che le vostre etichette raggiungano il corriere. Configuratelo una volta, e funzionerà su ogni ordine da ogni canale.