Gestire gli indirizzi degli Stati Uniti

Questo documento riguarda la convalida dell'indirizzo specifica per gli Stati Uniti:

Dati USPS nel flusso di lavoro

Quando convalida gli indirizzi negli Stati Uniti, il servizio API Address Validation può anche compilare la parte uspsData del reso.

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 (DPV) dell'USPS

Nell'ambito della risposta uspsData, il campo dpvConfirmation restituisce un singolo carattere per comunicarti se il servizio postale statunitense può effettuare la consegna 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 della proprietà secondaria 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 possibile comportamento che la tua logica potrebbe utilizzare per ciascuno dei 5 risultati possibili. Per ulteriori dettagli su questa logica, vedi Flussi di lavoro di esempio in Creare la logica di convalida.

Valore

Comportamento

Descrizione

N o vuoto

Correggi l'indirizzo

L'indirizzo non è stato confermato dal DPV.

Ciò significa che il servizio postale statunitense non riconosce il numero civico inserito esistente nella via (itinerario) inserita e probabilmente non può effettuare la consegna.

D

Aggiungere un locale secondario

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

Ciò significa che il numero di edificio inserito esiste nella via inserita, ma per raggiungere un indirizzo completamente verificato/recapitabile, è necessario fornire anche un numero di edificio secondario valido. In altre parole, l'edificio secondario non era presente nell'input.

S

Conferma l'indirizzo

L'indirizzo è stato confermato per il numero principale, mentre le informazioni sul numero secondario erano presenti ma non confermate.

Ciò significa che il numero civico inserito esiste nell'itinerario inserito, ma il numero civico secondario fornito non esiste all'interno dell'edificio, secondo l'USPS.

Y

Accetta l'indirizzo

L'indirizzo è stato confermato dal DPV per il numero principale e per eventuali numeri secondari.

Ciò significa che l'indirizzo è completamente consegnabile da USPS, incluso il numero della proprietà secondaria, se applicabile.

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

DPV N example - fix the address

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

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

Questo è un segnale molto forte che indica che questo numero civico non esiste su questo percorso. Come per altri indirizzi problematici, il sistema dovrebbe chiedere all'utente di apportare correzioni.

DPV D example - add a subpremises

Questo esempio utilizza la sede di Google a New York, ma non contiene un sottoindirizzo, che è una parte obbligatoria dell'indirizzo. Puoi verificarlo utilizzando l'indirizzo nella demo senza informazioni sulla sede secondaria.

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

Ciò conferma che la sottosede non era presente nell'input. Per ottenere un DPV di Y, deve essere inclusa una sottopremessa valida nell'input. Ad esempio, potresti includere un sub-locale valido FL 4 (4° piano) per ottenere un valore di dpvConfirmation pari a Y.

Esempio di DPV S: conferma l'indirizzo

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

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

Ciò indica che, sebbene 1600 Amphitheatre Parkway sia un indirizzo valido, la sotto-sede Suite 101 non è una parte valida dell'indirizzo. Ti consigliamo di confermare queste informazioni con l'utente e di fornirgli l'opportunità di correggere eventuali errori.

Esempio di DPV Y - accetta l'indirizzo

Questo esempio utilizza l'indirizzo del Googleplex a Mountain View, CA, come indirizzo valido noto.

  • 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. In questo modo, hai un'elevata certezza che l'API abbia restituito un indirizzo di buona qualità e puoi probabilmente utilizzarlo così com'è. Come sempre, considera il tuo livello di rischio quando decidi se chiedere o meno la conferma al tuo cliente.

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 tratta 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 l'USPS identifica un indirizzo creato artificialmente, il campo errorMessage 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.