Crea la tua logica di convalida

Questo documento descrive la procedura per creare un sistema di controllo degli indirizzi per gestire una serie di risposte dell'API Address Validation. Spiega come sviluppare la logica per utilizzare correttamente la risposta, esaminare altri indicatori dell'API e quando e come chiedere ai clienti ulteriori informazioni.

In generale, la risposta dell'API determina i seguenti modi in cui il sistema deve gestire un indirizzo:

• handyman Correzione: l'indirizzo è di bassa qualità. Dovresti chiedere maggiori informazioni.
• edit Conferma: l'indirizzo è di alta qualità, ma presenta alcune differenze rispetto all'indirizzo inserito. Potresti dover confermare.
• check Accetta: l'indirizzo è di alta qualità. Puoi accettare l'indirizzo fornito.

Scopo principale

Questo documento ti aiuta a modificare il sistema per analizzare al meglio la risposta dell'API e determinare le azioni successive da intraprendere con gli indirizzi forniti. Il seguente pseudocodice illustra un possibile flusso.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

La logica esatta dipende dalla situazione. Per ulteriori dettagli, consulta le indicazioni sull'implementazione. Puoi anche utilizzare la nostra implementazione open source di questa logica, che si trova nella libreria dei componenti estesi.

Panoramica del flusso di lavoro

La tabella seguente riassume due azioni per il tuo sistema:

1. Il flusso di lavoro da utilizzare in base al comportamento di correzione, conferma e accettazione.
2. Il primo indicatore da verificare nella risposta. Gli indicatori descritti qui provengono dalla proprietà verdict e non sono gli unici indicatori da verificare, ma forniscono un indicatore iniziale della qualità dell'indirizzo. Ogni tipo di comportamento corrisponde a una sezione di questo documento che descrive ulteriori indicatori che potresti dover esaminare.

Linee guida per l'implementazione

Durante la progettazione del modo in cui il sistema risponde agli indicatori dell'API Address Validation, i seguenti suggerimenti possono aiutarti a creare un modello di risposta più efficace. Tuttavia, questi sono solo suggerimenti, quindi tieni presente che l'implementazione dovrebbe essere adatta al tuo modello di business.

Correggere un indirizzo

Correggi un indirizzo quando i risultati indicano chiaramente che l'indirizzo non è recapitabile. Il sistema può quindi chiedere al cliente di fornire le informazioni necessarie, dopodiché puoi riemettere il flusso di lavoro per ottenere un indirizzo di recapito.

Correggere gli indicatori

L'API Address Validation fornisce una serie di indicatori per informarti se un indirizzo deve essere corretto.

1. Granularità della convalida e componenti mancanti

Questi due segnali forniscono la migliore indicazione di un indirizzo problematico:

• Ogni volta che il campo validationGranularity è OTHER, il sistema deve esaminare gli indicatori dei componenti degli indirizzi per scoprire dove si è verificato l'errore e come correggerlo.
• Ogni volta che l'oggetto address post-processato restituisce un campo missingComponentTypes, il sistema deve verificare la presenza di quel componente. Anche i componenti mancanti rendono un indirizzo incompleto e non recapitabile.

2. Altri indicatori

L'API Address Validation fornisce anche altri indicatori per aiutarti a diagnosticare problemi specifici:

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi statunitensi forniscono un indicatore utile che indica che l'indirizzo non è valido e deve essere corretto. Per un indirizzo che deve essere corretto, dovresti vedere quanto segue:

Per informazioni dettagliate su dpvConfirmation, consulta Gestire gli indirizzi degli Stati Uniti.

Esempi di indirizzi corretti

Conferma un indirizzo

Confermi un indirizzo quando il verdetto indica che l'API Address Validation ha dedotto o apportato modifiche ai componenti dell'indirizzo per produrre un indirizzo convalidato. In questi casi, hai un indirizzo a cui è possibile consegnare, ma preferisci una maggiore sicurezza che l'indirizzo risultante sia quello previsto dal cliente.

Per fornire al cliente il prompt corretto, la logica identifica i componenti segnalati dal servizio per determinare quale azione o indicatore l'API ha applicato al componente, ad esempio inferred, replaced o spellCorrected. Consulta AddressComponent nella documentazione di riferimento.

Conferma indicatori

L'API Address Validation fornisce una serie di indicatori per informarti se un indirizzo deve essere confermato.

1. Granularità della convalida

Un valore validationGranularity pari o superiore a ROUTE è accettabile, ma il valore validationGranularity ROUTE o validationGranularity SUBPREMISE fornisce un segnale più forte di recapito.

2. Altri indicatori

Quando decidi di confermare l'inserimento dell'indirizzo con il cliente, il verdetto fornisce anche quanto segue per determinare quali componenti esaminare:

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi statunitensi indicano che la logica deve confermare i dettagli con il cliente. Si applica una delle seguenti condizioni:

Esempi di indirizzi di conferma

Accettare un indirizzo

Accetti un indirizzo quando il verdetto fornisce un elevato grado di certezza che l'indirizzo sia recapitabile e possa essere utilizzato senza ulteriore interazione del cliente nel processo a valle.

Accettare gli indicatori

L'API Address Validation fornisce una serie di indicatori che ti informano se un indirizzo deve essere confermato.

1. Granularità della convalida

Un valore validationGranularity di PREMISE o superiore è accettabile, ma in alcuni casi, ROUTE indica comunque un indirizzo recapitabile.

2. Altri indicatori

Un esito relativo a un indirizzo di alta qualità dovrebbe anche fornire quanto segue:

• Nessun dato sostituito. In questo caso, hasReplacedComponents: FALSE.
• Nessun componente dedotto. In questo caso, hasInferredComponents: FALSE.

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi negli Stati Uniti indicano un indirizzo di alta qualità a cui è possibile consegnare. Per un indirizzo statunitense accettabile, dovresti vedere quanto segue:

Esempi di indirizzi accettati