Implementazione dell'acquisizione e della visualizzazione degli indirizzi

Gli indirizzi dei clienti sono necessari per creare, modificare ed evadere un ordine. Un collaboratore del negozio può acquisire gli indirizzi validi dei clienti e Sterling Store Engagement visualizza gli indirizzi nei formati appropriati. Questa sezione descrive le API, le uscite utente, i servizi e altri componenti utilizzati per implementare l'acquisizione e la visualizzazione degli indirizzi e per supportare i modelli e i moduli di acquisizione degli indirizzi basati sul paese.

Nota: per ulteriori informazioni sull'estensione della funzionalità di acquisizione e visualizzazione degli indirizzi, vedere Estensione dell'acquisizione degli indirizzi ed Estensione della visualizzazione degli indirizzi.

Soluzione

Un associato di negozio può aggiungere o modificare l'indirizzo di un cliente durante la creazione dell'ordine o la modifica dell'ordine.

Durante l'acquisizione dell'indirizzo, se il paese e il codice postale del cliente non vengono acquisiti, vengono utilizzati come paese predefinito e codice postale del negozio corrente.
Tuttavia, se il cliente desidera fornire un indirizzo con un paese diverso, il negozio associato può selezionare un paese dall'elenco Paese / Regione .
Per popolare l'elenco di paesi, l'API getCommonCodeList viene richiamata con CodeType come COUNTRY.
L'API getRegionList restituisce un elenco di regioni che soddisfano i criteri di input. Questa API determina lo schema dell'area dalla regola Schema dell'area da utilizzare per la selezione dello stato e restituisce un elenco delle aree che devono essere utilizzate dall'attributo State nell'elemento PersonInfo dell'entità.
Quando l'associazione del negozio seleziona il paese, vengono visualizzati i campi di acquisizione dell'indirizzo appropriati e l'elenco corrispondente di stati viene richiamato utilizzando l'API getRegionList . Se non viene richiamata alcuna area, l'elenco viene sostituito da un campo di testo.
Lo stato e la città vengono popolati automaticamente utilizzando l'API getRegionList quando viene fornito un codice postale valido.

Verifica indirizzo

Gli indirizzi dei clienti vengono verificati prima di salvarli nell'ordine. L'API verifyAddress viene richiamata per verificare l'indirizzo. L'API a sua volta richiama l'uscita utente YCDVerifyAddressWithAVSUE che convalida l'input fornito dall'utente.

Se tutti gli attributi sono validi e l'indirizzo è verificato correttamente, l'indicatore IsAddressVerified viene aggiornato in modo appropriato. L'applicazione utilizza l'uscita utente per interagire con AVS (Address Verification System) e restituisce i valori appropriati all'API verifyAddress .

I seguenti valori vengono restituiti come risultato della verifica dell'indirizzo:

VERIFIED. La schermata viene chiusa e l'indirizzo viene contrassegnato come verificato.
FAILED. I motivi dell'errore restituiti dall'API verifyAddress vengono visualizzati nella schermata per l'associazione del negozio da risolvere. Se l'associato del negozio seleziona Applica, l'indirizzo viene considerato valido e restituito come verificato.
AVS_DOWN. La schermata è chiusa e l'indirizzo è contrassegnato come non verificato, ma considerato valido.

Se vengono restituiti più indirizzi o se l'attributo ProceedWithSingleAVSResult viene restituito con il valore N, la schermata passa a una modalità di selezione di più indirizzi, in cui l'associazione del negozio viene presentata con un elenco di risultati insieme all'indirizzo originale, da cui l'associazione può selezionare un indirizzo.

Le seguenti API vengono utilizzate per verificare gli indirizzi:

getCommonCodeList. Richiama l'elenco di paesi con CodeType come COUNTRY.
getRegionList. Richiama l'elenco di stati in base al paese selezionato e allo schema di aree dalla regola Region Schema To Use For State Selection . Inoltre, recupera lo stato e la città in base al codice postale.
verifyAddress. Convalida l'indirizzo di input rispetto a un AVS (address verification system).

Componente UI di cattura indirizzo

Il componente condiviso di acquisizione degli indirizzi viene creato in app-common-module per acquisire gli indirizzi in Sterling Store Engagement. È possibile utilizzare questo componente per aggiungere o modificare gli indirizzi dei clienti durante l'acquisizione dell'ordine.

Per impostazione predefinita, sono supportati i modelli di cattura degli indirizzi per Stati Uniti e Canada. È possibile aggiungere modelli di acquisizione indirizzo per altri paesi e associare i campi indirizzo ai paesi. Per ulteriori informazioni sull'estensione dell'implementazione dell'acquisizione degli indirizzi, vedere Estensione dell'acquisizione degli indirizzi.