Gestire gli indirizzi degli Stati Uniti

Questo documento riguarda la convalida degli indirizzi specifica per gli Stati Uniti:

Dati USPS nel workflow

Quando convalidi gli indirizzi negli Stati Uniti, l'API Address Validation può anche compilare la parte uspsData della risposta.

Poiché questo oggetto non viene sempre compilato, non devi fare affidamento su questa proprietà come unico mezzo per convalidare gli indirizzi, ma devi incorporare anche il verdetto e i componenti dell'indirizzo nel tuo sistema.

Verifica del punto di consegna USPS (DPV)

Nell'ambito della risposta uspsData, il campo dpvConfirmation restituisce un singolo carattere per indicare se USPS può consegnare all'indirizzo fornito.

Puoi utilizzare questo campo per determinare quanto segue:

  • Validità dell'indirizzo.
  • Se nell'indirizzo manca un numero di unità.
  • Se il numero di unità non esiste nel sistema di dati USPS.

Il servizio restituisce uno dei quattro valori dpvConfirmation oppure non restituisce alcun valore dpvConfirmation. La tabella seguente mostra il comportamento consigliato che la tua logica dovrebbe utilizzare per ciascuno dei 5 risultati possibili. Per maggiori dettagli su questa logica, consulta la panoramica del workflow in Crea la logica di convalida.

Valore

Comportamento

Descrizione

No

o vuoto

Correggi l'indirizzo

L'indirizzo non è stato confermato da DPV.

Ciò significa che USPS non riconosce il numero di unità inserito esistente sulla via (percorso) inserita e non può consegnare all'indirizzo.

D

Correggi l'indirizzo

L'indirizzo è stato confermato da DPV solo per il numero principale e le informazioni sul numero secondario non erano presenti.

Ciò significa che il numero di unità inserito esiste sulla via inserita, ma per raggiungere un indirizzo completamente verificato/idoneo per la consegna, è necessario fornire anche un numero di unità valido. In altre parole, l'unità mancava nell'input.

S

Conferma l'indirizzo

L'indirizzo è stato confermato da DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non sono state confermate.

Ciò significa che il numero di unità inserito esiste sul percorso inserito, ma l'unità fornita non esiste all'interno dell'edificio, secondo USPS.

Sì

Accetta l'indirizzo

L'indirizzo è stato confermato da DPV per il numero principale e per tutti i numeri secondari.

Ciò significa che l'indirizzo è completamente idoneo per la consegna da parte di USPS, incluso il numero di unità, se applicabile.

Il resto di questa sezione illustra scenari reali che utilizzano i codici DPV.

Esempio di DPV N: correggi l'indirizzo

Questo esempio utilizza un numero civico inesistente su un indirizzo altrimenti valido.

  • Indirizzo inserito: 12 Amphitheatre Parkway, Mountain View, CA, 94043, USA
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: N

Questo è un indicatore estremamente forte che questo numero di unità non esiste su questo percorso. Come per altri indirizzi problematici, il sistema dovrebbe chiedere all'utente di apportare correzioni.

Esempio di DPV D: correggi l'indirizzo

Questo esempio utilizza l'ufficio Google di New York, ma non contiene un'unità, che è una parte obbligatoria dell'indirizzo. Puoi verificarlo utilizzando l'indirizzo nella demo senza informazioni sull'unità.

  • Indirizzo inserito: 111 8th Avenue, New York, NY, 10011, USA
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: D

Ciò conferma che l'unità mancava nell'input. Per ottenere un DPV di Y, è necessario includere un'unità valida nell'input. Ad esempio, puoi includere un'unità valida di FL 4 (4° piano) per ottenere un valore dpvConfirmation di Y.

Esempio di DPV S: conferma l'indirizzo

Questo esempio utilizza un numero di unità che non esiste all'interno dell'edificio:

  • Indirizzo inserito: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043, USA
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: S

Ciò indica che, sebbene 1600 Amphitheatre Parkway esista come indirizzo che può accettare la posta, l'unità Ste 101 non è una parte valida dell'indirizzo. Il sistema dovrebbe confermare queste informazioni all'utente e offrire l'opportunità di apportare una correzione.

Esempio di DPV Y: accetta l'indirizzo

Questo esempio utilizza l'indirizzo del Googleplex a Mountain View, CA, come indirizzo di qualità nota.

  • Indirizzo inserito: 1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: Y

L'indirizzo è completamente idoneo per la consegna da parte di USPS. Questo ti dà un grado di certezza molto elevato che l'API ha restituito un indirizzo di buona qualità e puoi utilizzarlo così com'è.

Nota: il DPV non indica se l'API Address Validation ha apportato modifiche all'input, ad esempio una correzione ortografica.

Messaggi di sicurezza per gli indirizzi statunitensi

Questa sezione illustra i flag di sicurezza forniti nei dati USPS per gli indirizzi creati artificialmente. Questa misura di sicurezza è progettata per impedire la creazione artificiale di un elenco di indirizzi rilevando quando un indirizzo inviato sembra essere stato creato artificialmente e non ottenuto legittimamente. Questo dovrebbe essere un evento molto raro.

Quando USPS identifica un indirizzo creato artificialmente, il errorMessage campo della proprietà uspsData della risposta contiene un messaggio di errore che descrive il problema. Ad esempio:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.