Instruction ReturnItemUpdate
Cette instruction met à jour les informations relatives à l'article retourné et peut être appelée pour plusieurs articles de l'autorisation de retour de marchandise.

Valeur des paramètres
- http://host_name/path/
- (Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce Server et chemin de configuration
- langId
- Affecte ou réinitialise la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG.
- storeId
- (Obligatoire) Référence du magasin.
- forUser
- ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
- forUserId
- ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne jouant le
rôle de représentant du service clientèle peut spécifier ce paramètre. L'utilisateur est identifié par un ID utilisateur interne, tel qu'il se présente dans la table
USERS.
- creditAdjustment_i
- Montant par lequel ajuster le crédit du produit. Le format de ce nombre doit suivre les règles de l'objet
java.math.BigDecimal. La décimale doit être marquée par un point. Ce montant va remplacer tous les montants calculés par l'instruction d'activité
CalculateReturnItemAdjustmentCmd. Ce paramètre est optionnel et correct lorsque le paramètre
forUserId ou forUserId est spécifié.
- receive_i
- Précise si le retour doit être réceptionné par le magasin. Par exemple, les articles d'épicerie périmés ne doivent pas être retournés au magasin, à l'inverse des tricots abîmés.
- RMAItemId_i
- (Obligatoire) L'identificateur RMAItem.
- quantity_i
- Quantité retournée.
- UOM_i
- Unité de mesure pour quantity_i. Cette valeur doit correspondre à une des clés principales de la table
QTYUNIT. Lorsqu'elle n'est pas précisée, alors la valeur de la colonne
QUANTITYMEASURE de la table CATENTSHIP pour la rangée avec la même CATENTRY_ID que celle utilisée par OrderItem,
et la valeur du paramètre quantity_i est multipliée par la colonne NOMINALQUANTITY de la même rangée dans la table
CATENTSHIP.
- comment_i
- Commentaire concernant l'article retourné.
- reason_i
- Raison du retour, telle qu'elle est donnée par l'acheteur. Cette valeur est disponible dans la colonne CODE de la table RTNREASON avec le type de raison 'B' ou 'C'.
- URL
- (Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
- outRMAName
- Nom à utiliser pour la paire nom-valeur transmise à l'URL de réacheminement. Ce paramètre est utile pour les instructions de chaînage. Si ce paramètre n'est pas spécifié, alors "RMAId" est utilisé.
Exemple
L'exemple suivant met à jour le RMAItem 123 pour indiquer un retour de 2 unités et met à jour le RMAItem 456 pour indiquer
un retour de 3 unités." A l'issu de l'exécution, la RMA s'affiche.
http://myhostname/webapp/wcs/stores/servlet/ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456
&quantité_1=1&quantité_2=3&URL=ReturnDisplay&storeId=1
Comportement
- Met à jour un article retourné et peut être appelée pour plusieurs articles RMA. Si cette instruction est appelée
avec de multiples articles de la RMA, alors tous les articles doivent appartenir à la même RMA.
- L'indicateur PREPARED de la RMA est réglée sur 'N'. Si les paramètres forUser ou forUserId sont indiqués, la
RMA doit démarrer avec les états 'EDT', 'PND', 'APP' et les états sont définis sur 'EDT'.
Autrement, la RMA doit démarré avec l'état 'PRC' et l'état devient 'PRC'.
- Chaque article va être traité comme suit :
- Vérifie que les articles soumis à l'autorisation de retour de marchandise n'ont pas été préalablement mis au crédit
du client.
- Met à jour l'article RMA. Lorsque les paramètres de quantité ou de réception sont indiqués pour un article,
alors les composants (dans la table RMAITEMCMP ) sont mis à jour .
- Si l'article retourné est basé sur un OrderItem, l'instruction appelle l'instruction d'activité
CalculateReturnItemCreditCmd
pour calculer le montant du crédit par défaut, puis définit celui de l'article RMA.
- Si l'article retourné est fondé sur une entrée de catalogue, alors l'instruction appelle l'instruction d'activité
CalculateReturnItemCreditForCatEntryCmd
.
- Appelez l'instruction d'activité AutoApproveReturnItemCmd
pour vérifier l'approbation automatique de l'article et indiquer que l'article de la RMA est soit
"approuvé par le système" soit "en cours d'approbation" en fonction du résultat de
l'instruction d'activité.
- A la fin de l'exécution, réachemine jusqu'à l'URL indiquée.
- Appel de l'instruction d'activité ExtendReturnItemUpdateCmd.
Conditions d'exception
- Si l'état de la RMA n'est pas défini sur 'PRC' (ce qui signifie que les paramètres forUser ou forUserId ne sont pas
utilisés) ou n'est pas défini sur 'EDT', 'PND', 'APP' (si les paramètres forUser ou forUserId ne sont pas
utilisés), alors se déclenche une ECApplicationException avec le message
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND.
- Si un article RMA n'est pas dans la même RMA que d'autres articles RMA traités précédemment, une
ECApplicationException se déclenche avec le message _ERR_BAD_MISSING_CMD_PARAMETER.
- Si un article RMA a déjà été crédité, une ECApplicationException se déclenche avec le
message _ERR_BAD_MISSING_CMD_PARAMETER.