Comando ReturnItemUpdate
Questo comando aggiorna le informazioni relative a un articolo restituito e può essere richiamato per più articoli della RMA.

Valori dei parametri
- http://nome_host/percorso/
- (Obbligatorio) Il nome completo del WebSphere Commerce Server e il percorso di configurazione.
- langId
- Imposta o reimposta la lingua prescelta per la durata della sessione; le lingue supportate per un negozio si trovano nella tabella STORELANG
- storeId
- (Obbligatorio) Il numero di riferimento del negozio.
- 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
- L'ID di collegamento dell'utente per conto del quale viene eseguito il comando; solo una persona con un ruolo di sicurezza di rappresentante del servizio clienti può specificare questo parametro. L'utente viene identificato mediante un ID utente interno, come rilevato nella tabella USERS.
- creditAdjustment_i
- La quantità mediante la quale rettificare il credito totale del prodotto. Il formato di questo numero deve adattarsi alle regole per un oggetto java.math.BigDecimal. Come separatore decimale per il numero, deve essere utilizzato un punto. Questa quantità sostituisce la quantità
calcolata dal comando di attività
CalculateReturnItemAdjustmentCmd. Tale
parametro è facoltativo e valido solo se è specificato il parametro
forUser o forUserId.
- receive_i
- Specifica se il negozio deve ricevere i componenti dell'articolo restituito. Ad esempio, per i negozi di generi alimentari non è necessario che la merce venga restituita, mentre un maglione deve essere restituito.
- RMAItemId_i
- (Obbligatorio) L'identificatore RMAItem.
- quantity_i
- La quantità restituita.
- UOM_i
- L'unità di misura per quantity_i. Tale valore deve corrispondere ad una delle chiavi principali nella tabella QTYUNIT. Quando
non viene specificato, viene utilizzato il valore della colonna QUANTITYMEASURE della tabella
CATENTSHIP per la riga con lo
stesso CATENTRY_ID di OrderItem
e il valore del parametro di quantity_i viene moltiplicato tramite la
colonnaNOMINALQUANTITY della stessa riga nella tabella CATENTSHIP.
- comment_i
- Un commento relativo all'articolo restituito.
- reason_i
- Il motivo della restituzione come fornito dall'acquirente. Tale valore può essere rilevato nella colonna CODE della tabella RTNREASON il cui tipo di motivo è in 'B' o 'C'.
- URL
- (Obbligatorio) L'URL da richiamare quando il comando viene eseguito correttamente.
- outRMAName
- Il nome da utilizzare per la coppia nome-valore che sarà trasferito all'URL di reindirizzamento. Tale parametro è molto utile per i comandi a catena. Se
questo parametro non viene specificato, viene utilizzato
"RMAId".
Esempio
Nel seguente esempio viene aggiornato RMAItem 123
per specificare la quantità di restituzione di 2 e viene aggiornato
RMAItem 456 per specificare la quantità di restituzione di 3." Al termine delle operazioni, verrà visualizzata la RMA.
http://myhostname/webapp/wcs/stores/servlet/ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456
&quantity_1=1&quantity_2=3&URL=ReturnDisplay&storeId=1
Azione
- Aggiorna un articolo restituito e può essere richiamato per più articoli
RMA. Se questo comando viene richiamato con più articoli
RMA, tutti gli articoli RMA devono appartenere alla stessa RMA.
- L'indicatore PREPARED della RMA è impostato su 'N'. Se è specificato il parametro
forUser o forUserId, la
RMA deve iniziare con stato 'EDT', 'PND', 'APP' e lo stato è impostato su
'EDT'.
In caso contrario,
la RMA deve iniziare con stato 'PRC' e lo stato viene modificato in 'PRC'.
- Ogni articolo sarà elaborato come riportato di seguito:
- Verifica che gli articoli della RMA non siano stati precedentemente accreditati al cliente.
- Aggiorna l'articolo della RMA. Se per un articolo vengono specificati
i parametri di ricezione o la quantità,
vengono aggiornati i componenti nella tabella RMAITEMCMP.
- Se l'articolo restituito si basa su un OrderItem,
il comando richiama il comando di attività CalculateReturnItemCreditCmd
per calcolare il credito predefinito e imposta il credito nell'articolo della RMA.
- Se l'articolo restituito si basa su una voce di catalogo,
il comando richiama il comando di attività CalculateReturnItemCreditForCatEntryCmd.
- Richiama il comando di attività AutoApproveReturnItemCmd
per verificare che l'articolo sia stato automaticamente approvato e
contrassegna l'articolo della RMA come "approvato dal sistema" o "approvazione in sospeso" a seconda dei risultati del comando di attività.
- Una volta completato, imposta il nuovo URL da utilizzare.
- Richiama il comando di attività ExtendReturnItemUpdateCmd.
Condizioni di eccezione
- Se lo stato della RMA non è impostato su 'PRC' (il parametro forUser o forUserId non è utilizzato)
o non è impostato su 'EDT', 'PND', 'APP' (se il parametro
forUser o forUserId è utilizzato)
viene generata un'eccezione ECApplicationException con messaggio
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND.
- Se l'articolo della RMA non è nella stessa
RMA degli altri articoli della RMA già elaborati, viene generata un'eccezione
ECApplicationException con messaggio _ERR_BAD_MISSING_CMD_PARAMETER.
- Se un articolo della RMA è già stato accreditato,
viene generata un'eccezione ECApplicationException con messaggio _ERR_BAD_MISSING_CMD_PARAMETER.