L'API Address Validation rappresenta una soluzione smart per correggere dati di contatto imprecisi e consentire una consegna più rapida dei colli, senza errori. Questa API formatta in modo appropriato le informazioni relative all'indirizzo di destinazione quando queste sono molto simili a un indirizzo valido, restituendo un indirizzo reale che è probabilmente quello che il mittente avrebbe voluto inserire.

L'API fornisce inoltre annotazioni sulle lacune dell'indirizzo di input o sulle modifiche apportate all'input per arrivare a quell'indirizzo reale. È possibile utilizzare questa API per convalidare e correggere le informazioni relative all'indirizzo di destinazione prima di spedire un collo.

Nota: non usate quest'API per determinare la possibilità di consegnare a un determinato indirizzo. FedEx non offre il servizio di consegna a tutti gli indirizzi validi. FedEx non effettua consegne a caselle postali (P.O. Box), a eccezione delle spedizioni effettuate tramite FedEx Ground® Economy (in precedenza FedEx SmartPost®).

Questa API consente di convalidare e correggere le informazioni relative all'indirizzo di destinazione prima di spedire un collo. Indirizzi precisi sull'etichetta di spedizione contribuiranno a eliminare i ritardi nelle consegne e a evitare l'applicazione di supplementi per la correzione dell'indirizzo (a causa di indirizzi non corretti).

Nota:

• I risultati della risoluzione degli indirizzi variano in base al Paese.
• L'indirizzo inserito nella richiesta viene confrontato con i dati di riferimento nel database FedEx e viene restituito l'indirizzo corrispondente.

Funzionalità dell'API Address Validation

• Fornisce corrispondenze di indirizzi a livello stradale.
• Riceve aggiornamenti mensili al suo database di indirizzi.
• Distingue tra indirizzi aziendali e residenziali nel caso in cui venga trovata una corrispondenza esatta.
• Al momento non verifica i numeri di suite o appartamenti.

Funzionalità dell'API Address Validation

• Completa gli indirizzi di destinazione incompleti. In alcuni casi, l'API Address Validation sarà in grado di aggiungere le informazioni mancanti, a seconda della verifica delle informazioni fornite rispetto ai dati di riferimento. L'API Address Validation non può aggiungere informazioni secondarie mancanti (ad esempio, appartamento o suite) in questo momento.
• Riceve aggiornamenti mensili al suo database di indirizzi.
• Corregge gli indirizzi di destinazione non validi. Ad esempio, può correggere un codice postale errato affinché sia corrispondente al resto dell'input.
• Determina se un indirizzo è relativo a un'azienda o un'abitazione privata, per aumentare la precisione del calcolo delle tariffe. Si applica solamente agli indirizzi statunitensi e canadesi.
• Conferma la validità e la completezza degli indirizzi in molti Paesi di queste regioni: Stati Uniti, Canada, America Latina, Europa, Medio Oriente e Asia Pacifica. Ora è possibile convalidare le informazioni relative a indirizzi nazionali e internazionali prima di spedire un collo, eliminando inutili ritardi di consegna e costi di servizio aggiuntivi.
• Fornisce corrispondenze a livello stradale.
• È possibile controllare fino a 100 indirizzi in una richiesta API.

Paesi/territori che supportano l'API Address Validation

È possibile utilizzare l'API FedEx Convalida indirizzi nei seguenti Paesi per convalidare e correggere gli indirizzi di destinazione e avere consegne efficienti.

Nota: le informazioni restituite dalla Richiesta di Convalida indirizzi costituiscono solo un suggerimento.

Disclaimer legale: I dati qui presentati sono informazioni riservate e proprietarie di FedEx, fornite a titolo di cortesia su richiesta dell'utente. Nessuno di questi dati può essere distribuito o divulgato in qualsiasi forma a terzi senza il permesso scritto di FedEx. Riflette l'attuale classificazione utilizzata da FedEx a livello di indirizzo (aziendale/residenziale) nel database degli indirizzi di consegna ed è soggetto a modifiche. Fornendo queste informazioni, FedEx non ne garantisce l'accuratezza presente o futura, e non garantisce che i colli spediti a questi indirizzi saranno fatturati secondo la classificazione aziendale/residenziale qui fornita. Il conferimento di tali informazioni non altererà i termini del rapporto tra le parti. Si rimanda alla Guida ai Servizi FedEx e a eventuali accordi tariffari applicabili per i termini e le condizioni che regolano le spedizioni FedEx shipping e le spese.

Convalida indirizzo

Utilizzare questo endpoint per convalidare e correggere indirizzi di input e restituire indirizzi del mondo reale. I dettagli dell'indirizzo vengono forniti e convalidati per risolvere un indirizzo. Un indirizzo viene dichiarato risolto quando l'indirizzo di input corrisponde ai dati di riferimento noti.

Le informazioni di input richieste associate a questa richiesta sono:

• Righe indirizzo
• Città (opzionale)
• Codice Stato o Provincia (opzionale)
• Codice postale (opzionale)
• Codice del paese

Nota: il codice dello stato o il nome della città è sufficiente quando il cliente spedisce in un Paese che non dispone di un codice postale.

L'API Address Validation restituisce un indirizzo reale eseguendo le seguenti operazioni sull'indirizzo di input:

• Come prima cosa, l'API tenta di normalizzare l'indirizzo di input. Può quindi procedere alla sostituzione di identificatori stradali comuni quali street e parkway con le loro abbreviazioni standard come ST e PKWY, nonché al riordino dei componenti dell'indirizzo. Se un indirizzo di input non può essere normalizzato, gli indirizzi risolti restituiti coincideranno con l'indirizzo di input. I valori non legati all'indirizzo vengono scartati.
• Nella seconda fase, l'API tenta di standardizzare l'indirizzo normalizzato trovando un indirizzo possibile o effettivo che sia probabilmente quello inteso dall'utente. Se la standardizzazione fallisce, gli indirizzi risolti restituiti coincideranno con la forma normalizzata dell'indirizzo di input. Fare riferimento agli elementi restituiti per contribuire a determinare i problemi con l'indirizzo inviato.
• Verranno restituiti anche alcuni elementi di quell'indirizzo normalizzato. Se la standardizzazione ha esito positivo, gli indirizzi risolti restituiti coincideranno con quell'indirizzo del mondo reale. In questo caso, vengono restituiti anche vari elementi aggiuntivi dell'indirizzo standardizzato e informazioni su come è stato ricavato dall'indirizzo normalizzato.

Valori di ritorno API convalida indirizzo

Se l'indirizzo restituito include i seguenti valori per gli attributi seguenti, l'indirizzo è valido:

• Lo Stato dell'indirizzo è standardizzato
• Gli attributi dell'indirizzo risolto sono veri
• Il punto di consegna valido (DPV) è vero
• L'indirizzo interpolato è falso

Se questi non sono elencati, utilizzare gli attributi aggiuntivi per determinare i possibili problemi con i valori dell'indirizzo.

Per ulteriori informazioni sugli attributi degli indirizzi, consultare Attributi indirizzo.

Se l'output restituito dal messaggio del cliente è INTERPOLATED.STREET.ADDRESS, è possibile che l'indirizzo non sia valido. Per ulteriori informazioni sul codice del messaggio del cliente, fare riferimento alla descrizione dell'elemento del messaggio del cliente.

Annotazioni

L'API Address Validation restituisce annotazioni per ogni indirizzo convalidato e restituito. Le annotazioni forniscono informazioni sulle eventuali lacune e sulle modifiche apportate all'indirizzo di input per arrivare a quell'indirizzo reale.

L'API Address Validation utilizza i dati di riferimento per determinare la classificazione di un determinato indirizzo. La classificazione per un indirizzo funzionale viene calcolata indipendentemente dal processo di convalida dell'indirizzo e si basa sul feedback del personale operativo, con fonti di dati commerciali utilizzate solo per la conferma.

L'API Address Validation ha solo quattro possibili classificazioni per gli indirizzi: sconosciuto, aziendale, residenziale e misto. Tutti gli indirizzi iniziano con una classificazione "sconosciuta" e rimangono tali fino a quando le regole aziendali di convalida degli indirizzi stabiliscono la necessità di un cambio di categoria. La classificazione di "misto" è assegnata solo se si tratta di un indirizzo con più locatari e contiene sia unità commerciali che residenziali.

Nota: FedEx Express fornisce una riga indirizzo aggiuntiva (riga indirizzo 3) per gli indirizzi di destinazione. Tali informazioni aggiuntive forniscono dettagli più completi e accurati sulla posizione, migliorando le possibilità di ottenere un indirizzo preciso.

Gli indirizzi del mondo reale sono classificati come segue:

Indirizzi aziendali

L'indirizzo aziendale è quello utilizzato per designare la sede principale di un'attività lavorativa. Si tratta del luogo da dove presumibilmente opera l'attività, anche se potrebbe non essere sempre così.

L'indirizzo aziendale coincide con la posizione ufficiale dei locali di un'azienda. Potrebbe essere un indirizzo di casa privato o persino un campus multimilionario, come quelli scelti dalle grandi aziende tecnologiche, o qualsiasi altra cosa.

Indirizzo residenziale

Verrà applicato un supplemento alle spedizioni su territorio statunitense per consegne ad abitazioni o residenze private, comprese le sedi in cui l'attività è gestita da casa. Utilizzate il servizio FedEx Home Delivery per consegne a domicilio in 1 giorno lavorativo tramite FedEx Ground in base alla destinazione.

Esempio:

• Casa parrocchiale
• Convento
• Casa del pastore
• Residenti in condomini, quali:
  • Palazzo di appartamenti
  • Condomini
  • Dormitori universitari

• Una residenza dove i prodotti vengono venduti e/o distribuiti

Di seguito sono riportati alcuni suggerimenti utili per l'utilizzo dell'API Address Validation (convalida indirizzo):

• Usare la spaziatura corretta: assicuratevi che gli spazi siano posizionati correttamente ed evitate spazi inutili.
• Usare lo spelling corretto: evitate errori di ortografia e tipografici. Inoltre, assicuratevi di utilizzare correttamente il numero zero (0) e la lettera O.
• Evitare i caratteri speciali: astenetevi dall'utilizzare caratteri speciali non richiesti per l'indirizzo, come i punti dopo le abbreviazioni (Ave vs. Ave.).
• Fornire indirizzo aggiuntivo e informazioni sulla via: fornendo ulteriori informazioni sull'indirizzo, è possibile aumentare la precisione dei risultati.
  • Numero civico della casa/dell'edificio - 1, 1A, 1½, Uno
  • Nome della via - Principale, George Washington, 42esima
  • Suffisso via - Strada, Viale, Rd, Ave
• Inserire città, stato/provincia e CAP o codice postale: fornire tutti e tre aumenterà la precisione dei risultati dell'indirizzo.
• Inserire via e indirizzo nel seguente ordine: gli elementi dell'indirizzo stradale di solito seguono un formato che inizia con l'edificio o il numero civico seguito da un elemento predirezionale, il nome della via, il tipo di strada o il suffisso, un elemento post-direzionale, la designazione dell'appartamento, il numero dell'appartamento e/o la designazione della casella di posta privata e numero.
• Usare le abbreviazioni corrette: il servizio postale degli Stati Uniti e il Canada Post hanno abbreviazioni standard per ciascuno Stato/provincia, suffisso stradale e designazioni di appartamenti o unità.
  • Un'abbreviazione non standard può causare risultati di ricerca imprecisi.
  • Se non siete sicuri di un'abbreviazione, non usatela.

Ad esempio:

• Numero civico della casa/dell'edificio, come 1, 1A, Uno
• Nome della via, come Principale, George Washington, 42esima
• Suffisso della via, come Strada, Viale, Rd, Ave.
• Inserire città, stato/provincia e codice postale: fornire tutte le informazioni aumenterà la precisione dei risultati ottenuti. La parte CAP+4 del codice postale non è necessaria per controllare un indirizzo.
• Usare le abbreviazioni corrette: il servizio postale degli Stati Uniti e il Canada Post hanno abbreviazioni standard per ciascuno Stato/provincia, suffisso stradale e designazioni di appartamenti o unità. L'uso di un'abbreviazione non standard può portare a risultati di ricerca scadenti. Se non siete sicuri di un'abbreviazione, non usatela.
• Considerare la possibilità di restituire un feedback sulla risposta di convalida dell'indirizzo all'utente per dare la possibilità di scegliere l'indirizzo più corretto.

• Non usate quest'API per determinare la possibilità di consegnare un collo a un determinato indirizzo. FedEx non offre il servizio di consegna a tutti gli indirizzi validi. FedEx non effettua consegne a caselle postali (P.O. Box), a eccezione delle spedizioni effettuate tramite FedEx Ground® Economy (in precedenza FedEx SmartPost^®).
• Le informazioni restituite dall'indirizzo risolto costituiscono solo un suggerimento.
• È possibile controllare fino a 100 indirizzi in una richiesta.
• I campi minimi richiesti variano da Paese a Paese.

  Ad esempio, per gli indirizzi negli Stati Uniti, sono richiesti almeno una riga dell'indirizzo e un codice postale o una città e un codice dello Stato, ma per gli indirizzi AUS (formato dell'indirizzo Australia), il codice dello Stato può essere omesso anche senza un codice postale.

• I risultati della risoluzione degli indirizzi possono variare in base al Paese.

Nota: l'API di convalida degli indirizzi potrebbe non essere applicabile a tutti i Paesi. Fare riferimento alla sezione Paesi/territori che supportano l'API Address Validation.