URL ReturnItemUpdate

Structure de l'adresse URL

http:// host_name/path/

Nom hôte entièrement qualifié de votre serveur HCL Commerce Server et du chemin de configuration.

Valeurs des paramètres

langId

Définit ou redéfinit la langue préférée pour la durée de la session. Les langues prises en charge pour un magasin sont répertoriées dans la table STORELANG

storeId

Obligatoire : Numéro de référence du magasin.

forUser

ID de connexion de l'utilisateur pour lequel l'adresse URL sera exécutée.

forUserId

The logon ID of the user on whose behalf the command will be run; only a person with a security role of Customer Service Representative can specify this parameter. L'utilisateur est identifié par un ID utilisateur interne, tel qu'il se trouve dans le tableau USERS.

creditAdjustment_ i

Montant auquel ajuster le montant du crédit du produit. Le format de ce nombre doit s'adapter aux règles d'un objet java.math.BigDecimal. Le nombre doit utiliser un point comme pour séparateur de décimale. Ce montant remplacera tout montant calculé par l'instruction de tâche CalculateReturnItemAdjustmentCmd. Ce paramètre est facultatif et uniquement valide si le paramètre forUser ou le paramètre forUserId est spécifié.

receive_ i

Spécifie si les composants de l'article de retour doivent être reçus par le magasin. Par exemple, il n'est pas nécessaire de retourner des produits alimentaires abîmés, alors qu'il le faudrait pour un sweatshirt.

RMAItemId_i

Obligatoire : Identificateur RMAItem.

quantity_ i

La quantité retournée.

UOM_ i

Unité de mesure pour quantity_i. Cette valeur doit correspondre à l'une des clés primaires du tableau QTYUNIT. Lorsqu'elle n'est pas spécifiée, la valeur de la colonne QUANTITYMEASURE du tableau CATENTSHIP pour la ligne ayant la même CATENTRY_ID que l'OrderItem est utilisée, et la valeur du paramètre quantity_i est multipliée par la colonne NOMINALQUANTITY de la même ligne dans le tableau CATENTSHIP.

comment_ i

Un commentaire sur l'article en cours de retour.

reason_ i

Le motif de retour, tel que fourni par l'acheteur. Cette valeur se trouve dans la colonne CODE du tableau RTNREASON avec le type de motif 'B' ou 'C'.

URL

Obligatoire : Adresse URL à appeler une fois que la commande a abouti.

outRMAName

Nom à utiliser pour la paire nom-valeur qui sera transmise à l'URL redirigée. Ce paramètre est utile pour les commandes de chaînage. Si ce paramètre n'est pas spécifié, "RMAId" est utilisé.

Exemple

L'exemple suivant met à jour le RMAItem 123 pour spécifier la quantité de retour sur 2 et met à jour le RMAItem 456 pour spécifier une quantité de retour sur 3. Une fois l'opération terminée, la RMA sera affichée.

 http://myhostname/webapp/wcs/stores/servlet/ ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456&quantity_1=1&quantity_2=3&URL=ReturnDisplay&storeId=1 

Comportement

• Met à jour un article retourné et peut être appelé pour plusieurs articles de RMA. Si cette commande est appelée avec plusieurs articles de RMA, tous les articles RMA doivent appartenir à la même RMA.
• Le drapeau PREPARED de la RMA est défini sur 'N'. Si le paramètre forUser ou le paramètre forUserId sont spécifiés, la RMA doit démarrer avec le statut 'EDT', 'PND', 'APP' et le statut est défini sur 'EDT'. Dans le cas contraire, la RMA doit commencer avec le statut "C" et le statut est changé pour "PRC".
• Chaque article sera traité comme suit :
  1. Vérifie que les articles de RMA n'ont pas été préalablement crédités au client.
  2. Met à jour l'article de RMA. Si la quantité ou les paramètres de réception sont spécifiés pour un article, les composants (dans le tableau RMAITEMCMP) sont mis à jour.
     • Si l'article retourné est basé sur un OrderItem, la commande appelle l'instruction de tâche CalculateReturnItemCreditCmd pour calculer le montant du crédit par défaut et définit le montant du crédit sur l'article de RMA.
     • Si l'élément retourné est basé sur une entrée de catalogue, la commande appelle la commande De CalculateReturnItemCreditForCatEntryCmd.
  3. Appelle l'instruction de tâche AutoApproveReturnItemCmd pour voir si l'élément est automatiquement approuvé et marque l'article de RMA comme étant "approuvé par le système" ou "approbation en attente" en fonction du résultat de l'instruction de tâche.
• Une fois l'opération terminée, appelle l'adresse URL indiquée.
• Appelez l'instruction de tâche ExtendReturnItemUpdateCmd.

Conditions d'exception

• Si le statut RMA n'est pas défini sur 'PRC' (c'est-à-dire que les paramètres forUser ou forUserId ne sont pas utilisés) ni sur 'EDT', 'PND', 'APP' (si les paramètres forUser ou forUserId sont utilisés), une ECApplicationException est levée 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 déjà traités, une ECApplicationException est générée avec le message _ERR_BAD_MISSING_CMD_PARAMETER.
• Si un article de RMA a déjà été crédité, une ECApplicationException est générée avec le message _ERR_BAD_MISSING_CMD_PARAMETER.