Come funziona la chiamata API Check Address

Scopri come verificare e correggere i tuoi indirizzi di spedizione con un'unica chiamata API

Con l'API CheckAddress di ShippyPro puoi verificare e validare automaticamente gli indirizzi di spedizione per oltre 240 paesi – con un'unica chiamata per tutti i tuoi Corrieri.

💡 Verificare gli indirizzi di spedizione ti permette di ridurre:

Errori durante il processo di spedizione e risparmiare tempo operativo
Le eccezioni di spedizione e offrire ai tuoi clienti la migliore esperienza di spedizione
I costi di giacenza delle spedizioni presso i corrieri, in caso di indirizzi non recapitabili

In questo articolo imparerai come funziona l'API CheckAddress, come interpretare le risposte e vedrai alcuni esempi.

Sommario:

Prima di iniziare
Come funziona
Riferimento API CheckAddress
Errori e FAQ

1. Prima di iniziare

Se non hai mai implementato le API di ShippyPro, fai riferimento alla sezione "Getting Started" della documentazione API di ShippyPro. Devi prima generare una API Key per autenticarti con l'API di ShippyPro.
Per utilizzare l'API CheckAddress, devi avere almeno un Corriere collegato al tuo account ShippyPro, per poter inviare i parametri ShippyPro richiesti come CarrierID e CarrierName. Se hai bisogno di recuperare il nome e l'ID del tuo corriere, li trovi in fondo alla pagina API Keys del tuo account ShippyPro.

2. Come funziona la validazione

L'API CheckAddress fornisce validazioni degli indirizzi sia lato Corriere sia tramite GeoCoding. Se il Corriere lo consente, la validazione sfrutta quella del Corriere; in caso contrario, la validazione dell'indirizzo avviene tramite geocoding.

I Corrieri che attualmente supportano la validazione degli indirizzi tramite il proprio web service sono UPS (Stati Uniti e Porto Rico), TNT e GLS Italia. In entrambi i casi, il processo di validazione fornisce un punteggio di accuratezza che indica quanto è preciso l'indirizzo restituito.
Questa API è in grado di ricostruire un indirizzo cercando di indovinare le parti di un indirizzo errato.

Ad esempio, se la risposta restituisce un'accuratezza del 95%, questa si riferisce ai suggerimenti restituiti e proviene dall'API di Google (oppure dall'API del corriere – vedi l'elenco sopra). La risposta non può mai essere del 100% perché il sistema non può mai essere completamente sicuro che le nuove informazioni corrette siano effettivamente quelle desiderate dall'utente. Più l'API è incerta su questo, più basa sarà la percentuale di accuratezza del nuovo indirizzo.

Saltare la validazione lato Corriere

Puoi saltare la validazione dell'indirizzo lato Corriere impostando Generic come parametro Carrier. Dai un'occhiata qui se hai bisogno di aiuto per configurare il Corriere Generico di ShippyPro.

Validare indirizzi internazionali

L'API Check Address supporta indirizzi internazionali, inclusi indirizzi asiatici e russi. Tieni presente che il formato dell'indirizzo può variare da paese a paese e che potrebbero applicarsi regole specifiche a tali indirizzi e ai relativi parametri da compilare.
Ti preghiamo di verificare e testare i risultati della validazione degli indirizzi prima di iniziare a spedire.

3. Riferimento API CheckAddress

Visita la nostra Documentazione API per vedere un esempio di richiesta e risposta dell'API Check Address. Per ogni indirizzo validato, puoi ottenere i seguenti elementi nella risposta:

Messaggi di Validazione dell'Indirizzo: possono essere restituiti (se presenti) dalla risposta dell'API dei Corrieri, così come dal GeoCoding.
Suggerimenti di Indirizzo: possono essere restituiti (se presenti) solo dalla risposta dell'API dei Corrieri, non dal GeoCoding.
Nuovo Indirizzo: è composto sostituendo nell'indirizzo iniziale i campi segnalati come errati con i nuovi valori suggeriti.
Accuratezza: è un campo calcolato dall'API CheckAddress basato sul Geocoding. Rappresenta il livello di accuratezza dell'indirizzo.

4. Errori e FAQ

Perché riscontro l'errore CHECK_ADDRESS_NOT_ENABLED?
Significa che hai esaurito le tue 500 richieste gratuite mensili oppure non hai un piano attivo.