Piattaforma legacy

Verifica dell'indirizzo

Potrebbero esservi diversi scenari, come l'acquisizione di un ordine o la modifica dell'indirizzo di un ordine, per cui è necessario verificare gli indirizzi. L'applicazione fornisce un agente di verifica indirizzi per verificare gli indirizzi sull'ordine ed emettere gli avvisi per indicare agli utenti di eseguire l'azione appropriata.

Soluzione

La seguente sezione descrive le API, le uscite utente, i servizi e altri componenti.

Durante l'acquisizione o la modifica di un indirizzo, l'API verifyAddress prende ottiene le informazioni dell'indirizzo e prova a verificarlo in anticipo, mediante un sistema di verifica indirizzi. La comunicazione con il sistema di verifica indirizzi viene gestito dall'uscita utente YCDVerifyAddressWithAVSUE. Viene restituito lo stato del processo di verifica. I valori possibili sono:
  • UE_MISSING: un'implementazione per l'uscita utente YCDVerifyAddressWithAVSUE non è stata trovata.
  • AVS_DOWN: il sistema di verifica indirizzi non risponde.
  • FAILED: il sistema di verifica indirizzi non è stato in grado di verificare questo indirizzo.
  • VERIFIED: questo indirizzo è stato verificato dal sistema di verifica indirizzi.

Durante la creazione dell'ordine, se l'attributo IsAddressVerified è impostato su N e viene inoltrato all'input all'API createOrder, il sistema di verifica indirizzi convalida l'indirizzo. Se l'uscita utente YCDVerifyAddressWithAVSUE indica un indirizzo non valido, l'ordine viene sospeso con una sospensione di tipo YCD_VERIFY_ADDRESS. Gli ordini con una sospensione di verifica indirizzi non possono essere pianificati o rilasciati.

L'agente di verifica indirizzi seleziona gli ordini che hanno una sospensione di verifica indirizzi. Per ogni indirizzo in un ordine che deve essere convalidato, l'agente richiama l'API verifyAddress, che a sua volta richiama l'uscita utente YCDVerifyAddressWithAVSUE per interagire con il sistema di verifica indirizzi.

Se il sistema di verifica indirizzi conferma che tutti gli indirizzi sono validi, l'agente rimuove la sospensione sull'ordine.

Se l'indirizzo non è valido, l'agente rifiuterà la sospensione. Quando un indirizzo non è valido, il sistema di verifica indirizzi restituisce più corrispondenze possibili. L'agente gestisce questa situazione nello stesso modo in cui farebbe se il sistema di verifica indirizzi avesse riportato un indirizzo non valido: rifiuterà la sospensione sull'ordine ed emetterà un avviso. L'agente non rielabora di nuovo l'ordine a meno che l'indirizzo non sia modificato manualmente.

Se il sistema di verifica indirizzi non è online, l'agente può essere configurato per rimuovere la sospensione dall'ordine e per elaborarlo o rifiutarlo, in modo che sia elaborato di nuovo dall'agente in un secondo momento.

Figura 1. Agente di verifica indirizzi

L'agent di verifica indirizzo

I dettagli per l'agente di verifica indirizzi sono:

Tabella 1. Attributi
Attributo Valore
ID transazione di base PROCESS_ORDER_HOLD_TYPE
Tipo di documento di base 0001 (ordine di vendita)
Tipo di processo di base ORDER_FULFILLMENT (evasione ordine)
Transazioni astratte N
API richiamate verifyAddress
Tabella 2. Parametri critici
Parametro Descrizione
Azione Questo campo è utilizzato internamente dall'applicazione. L'unico valore valido è Get. Non modificare questo campo.
Numero di record da inserire nel buffer Facoltativo. Il numero di record da richiamare ed elaborare in una sola volta. Se vuoto o specificato come 0 (zero), il valore predefinito è 5000.
CollectPendingJobs

Se questo parametro è impostato su N, l'agente non raccoglie informazioni sui lavori in sospeso per questa transazione temporale. Le informazioni sui lavori in sospeso vengono utilizzate per monitorare l'agente in System Management Console.

Per impostazione predefinita, CollectPendingJobs è impostata su Y. Può essere utile impostarlo su N se una particolare transazione temporale sta eseguendo un numero significativo di query getPendingJobs e il costo del sovraccarico è troppo elevato.
Intervallo coda attività successivo

Il numero di ore da attendere prima di provare a elaborare di nuovo un indirizzo. Questo valore viene utilizzato con la regola MUST_VERIFY_ADDRESS. Se non viene impostato, sarà utilizzato il valore predefinito di 5 ore dall'ora corrente.

Statistiche tracciate

Nessuno.

Conteggio lavori in sospeso

Il numero di ordini che devono avere indirizzi verificati.

Tabella 3. Eventi generati dall'agente di verifica degli indirizzi
Transazione/Evento Dati chiave Dati pubblicati Supporto modello? 
VERIFY_ADDRESS_FAILED
 
OrderHeaderKey,
OrderNo
 
VERIFY_ADDRESS.0001
.VERIFY_ADDRESS_
FAILED.001.xml
 Vero

Il servizio YCD_VerifyAddressFailedAlert_1.0 viene richiamato per emettere avvisi di tipo YCD_VERIFY_ADDRESS. Mediante questi avvisi, gli utenti ricevono una notifica degli indirizzi che non hanno superato la verifica, in modo che possano risolvere la sospensione.

Gli utenti possono aprire l'avviso e visualizzarne i dettagli. L'API getExceptionDetails viene richiamata per visualizzare i dettagli dell'avviso. L'API getCompleteOrderDetails viene richiamata per richiamare un elenco di indirizzi non verificati su un ordine. Viene fornito un link per consentire agli utenti di aggiornare gli indirizzi dell'ordine come richiesto.

Implementazione

Per utilizzare la funzione di verifica indirizzi, è necessario effettuare le seguenti operazioni:
  1. Assicurarsi che il tipo di sospensione YCD_VERIFY_ADDRESS sia implementato per l'azienda che esegue la verifica dell'indirizzo. Effettuare le seguenti operazioni per implementare un tipo di sospensione di verifica indirizzi:
    1. Avviare Applications Manager -> Distributed Order Managemente caricare l'azienda che esegue la verifica.
    2. Vai a Distributed Order Management -> < Document Specific> -> < Document Type> -> Fulfillment -> Hold Types.
    3. Fare clic sull'icona Crea per creare il tipo di sospensione di verifica indirizzi con i seguenti dettagli:
      • Nel campo Tipo di sospensione, inserire YCD_VERIFY_ADDRESS.
      • Nella scheda Creazione sospensione, selezionare le seguenti opzioni:
        • Alla conferma ordine provvisorio
        • Alla creazione dell'ordine
      • Nella scheda Risoluzione sospensione, selezionare Verifica indirizzo come transazione temporale che elaborerà le sospensioni create.
      • Nella scheda Effetti sospensione, è possibile specificare le transazioni che smetteranno di elaborare gli ordini con questa sospensione.
    4. Fare clic su Salva. Il tipo di sospensione sarà salvato.
    Nota: gli attributi menzionati nella procedura sono importanti. Inoltre, è possibile specificare altri attributi per il tipo di sospensione in base alle proprie necessità aziendali.
  2. Implementare l'uscita utente YCDVerifyAddressWithAVSUE per verificare l'indirizzo con il sistema di verifica indirizzi.
  3. Configurare l'agente di verifica indirizzi. Per configurare il comportamento dell'agente quando l'AVS non è online, consultare i concetti di modellazione dell'organizzazione e dei partecipanti.
  4. Configurare il tempo che l'agente deve attendere per rielaborare un indirizzo. Utilizzare l'Applications Manager per configurare il tempo che l'agente deve attendere prima di provare a eseguire di nuovo l'elaborazione di un indirizzo che non è stato verificato. Per ulteriori informazioni sulla configurazione dei parametri dei criteri degli agenti, consultare i concetti di modellazione dell'organizzazione e dei partecipanti.

Impatto sull'utente finale

Gli utenti possono verificare l'indirizzo e aggiornarlo se necessario, in modo che gli ordini siano spediti e fatturati all'indirizzo corretto.