Comando OrderProcess

Questo comando inoltra un ordine. L'ordine deve essere stato bloccato dal comando OrderPrepare. Una volta avviato il comando OrderProcess, non è possibile annullare l'ordine con il comando OrderCancel.  

proproce.gif (7483 byte)

Valori dei parametri

http://nome_host/percorso/
(Obbligatorio) Il nome completo del WebSphere Commerce Server e il percorso di configurazione.
forUser
L'ID di collegamento dell'utente per conto del quale viene eseguito il comando; solo una persona con l'autorizzazione per elaborare ordini può specificare questo parametro.
forUserId
Come per forUser, ma con identificazione dell'utente mediante l'ID utente interno, come rilevato nella tabella USERS.
langId
Imposta o reimposta la lingua prescelta per la durata della sessione; le lingue supportate per un negozio si trovano nella tabella STORELANG
storeId
Il numero di riferimento del negozio a cui mandare l'ordine. Questo valore viene ignorato a meno che non si verifichi un errore prima che l'ordine sia stato risolto. Viene utilizzato solo per richiamare il programma adatto per la gestione eccezioni del negozio.
orderId
(Obbligatorio) Il numero di riferimento dell'ordine.
billtoAddressId
Il numero di riferimento dell'indirizzo per la fatturazione.
field1, field2 e field3
Campi personalizzabili
notifyMerchant
Se il negozio deve essere notificato al termine dell'inoltro dell'ordine
1=Sì
0=No
notifyShopper
Se il cliente deve essere notificato al termine dell'inoltro dell'ordine
1=Sì
0=No
quoteExpiredURL
Specifica l'URL a cui effettuare il reindirizzamento se il totale dell'ordine è scaduto secondo i criteri di scadenza specificati dal parametro quoteExpiryPolicy.
quoteExpiryPolicy
Definisce il comportamento del comando se il totale dell'ordine scade o un centro di evasione ordini di un articolo ordinato viene modificato durante un'assegnazione di inventario. L'ordine scade se la data e l'ora correnti sono successivi alla data e l'ora dell'ultimo aggiornamento più il numero di secondi specificati nella colonna QUOTEGOODFOR della tabella STORE. Questo parametro può avere tre valori:
notifyOrderSubmitted
Se il cliente deve ricevere notifica al termine dell'inoltro dell'ordine.
1
=Yes
0=No (predefinito)
availabilityChangeURL
Specifica l'URL a cui vengono reindirizzate le informazioni se il tempo disponibile stimato più l'offset di spedizione per un articolo dell'ordine viene posticipato (come risultato dell'assegnazione o backorder dell'inventario) per un periodo superiore all'intervallo specificato dal parametro maxAvailabilityChange. Questo parametro viene ignorato se l'assegnazione di inventario ATP non è abititata.
maxAvailabilityChange
Specifica l'intervallo di tempo, in secondi, specificato nella descrizione del parametro availabilityChangeURL. Il valore predefinito è 3600 secondi )un'ora). Questo parametro viene ignorato se il parametro availabilityChangeURL non viene specificato o se l'assegnazione di inventario ATP non è abilitata.
noInventoryURL
Specifica il nuovo URL da utilizzare se non è possibile assegnare o respingere alcuni articoli dell'ordine. Questo parametro viene ignorato se l'assegnazione di inventario ATP non è abititata.
tcId
L'identificativo dell'oggetto termini e condizioni (consultare la tabella TERMCOND). Se specificato e se identifica un PaymentTC e il PaymentTC specifica un memberId ed un nickName indirizzo (associazione PaymentTC) il memberId e il nickName indirizzo vengono utilizzati per determinare l'indirizzo di fatturazione; in tal caso il parametro billToAddressId viene ignorato.

Note sui pagamenti
Il comando OrderProcess non gestisce da solo i pagamenti.  Per gestire i pagamenti, utilizzare la classe di interfaccia DoPaymentCmd, implementata dai comandi di attività DoPayment. I parametri che vengono trasferiti da OrderProcess a questo comando possono essere di qualsiasi tipo, anche se, generalmente, implementano le informazioni sulla carta di credito.

WebSphere Commerce include due classi di implementazione del comando di attività  OH, DoPaymentCmdImpl e DoPaymentMPFCmdImpl. La classe DoPaymentCmdImpl è una implementazione di esempio utilizzata per mostrare come scrivere un'implementazione del comando DoPaymentimplementation che funziona con il comando OrderProcess. La classe DoPaymentMPFCmdImpl è la classe di implementazione DoPaymentCmd standard progettata per essere utilizzata con IBM WebSphere Payment Manager, Versione 3.1 ed include il supporto per le funzioni Business-to-Business introdotte con questo rilascio di WebSphere Commerce Business Edition.

Note sulla notifica degli ordini

Per configurare la funzione di notifica degli ordini, è necessario:

  1. Attivare la messaggistica in uscita.
  2. Creare le maschere di composizione messaggi per la composizione dei messaggi di notifica degli ordini. 

Esempio 1
Il seguente comando elabora un ordine con un numero di riferimento 3.
    http://myhostname/webapp/wcs/stores/servlet/OrderProcess?orderId=3

Esempio 2
Partendo dal presupposto che Payment Manager sia già stato impostato, questo comando trasferisce le informazioni relative al pagamento del cliente a Payment Manager.  Il parametro criterioId=200 si riferisce al metodo OfflineCard che il modello del negozio utilizza per impostazione predefinita per Payment Manager.
    http://myhostname/webapp/wcs/stores/servlet/OrderProcess?storeId=34
    &orderId=556677&criterio=200&cardBrand=Visa
    &cardNumber=41111111111111111&cardExpiryMonth=12&cardExpiryYear=2001

Nota: Il parametro payMethodId è supportato soltanto per compatibilità verso il basso. Per nuove Payment Manager Cassettes e nuove funzioni Business-to-Business, utilizzare invece il parametro criterioId  (come nell'Esempio 2). Per un elenco dei criteri di pagamento definiti, fare riferimento ai relativi link associati di seguito riportati.

La classe DoPaymentMPFCmdImpl supporta un parametro aggiuntivo chiamato tcId, che viene utilizzato per specificare l'ID dei termini e delle condizioni del pagamento da utilizzare per un ordine. I termini e le condizioni devono essere quelli specificati nel contratto associato agli articoli ordinati. Per semplificare la selezione del file JSP dei termini e delle condizioni dei pagamenti comuni, utilizzare UsablePaymentTCListDataBean. Il parametro tcId è obbligatorio se ai contratti utilizzati per gli OrderItem sono associati termini di pagamento e condizioni.

Azione

Condizioni di eccezione

Argomenti correlati

Riferimento correlato

IBM copyright