Instruction ReturnItemAdd

Cette instruction ajoute des articles à une autorisation de retour de marchandise (RMA). 

osrtnitad.gif (9639 octets)

Valeurs des paramètres

http://host_name/path/
(Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce Server et chemin de configuration
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
Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'il est indiqué 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 se trouve dans la colonne ADJUSTMENT de la table RMAITEM. Ce paramètre est optionnel et correct lorsque le paramètre forUserId est spécifié uniquement.
langId
Définit ou restaure 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.
orderItemId_i
(Obligatoire) ID de l'OrderItem, s'il est disponible. Pour retourner un composant qui ne fait pas partie du kit dynamique, ou du kit complet issu d'OrderItem, une valeur doit être spécifiée pour ce paramètre. Pour retourner la partie du kit dynamique disposant d'un OrderItem, une valeur doit être spécifiée pour ce paramètre et pour catEntryId_i.
catEntryId_i
(Obligatoire) Entrée de catalogue retournée. Il doit s'agir d'un produit ou d'un article. D'autres valeurs d'entrée de catalogue ne sont pas prises en charge et vont lancer une exception BAD_MISSING_CMD_PARAMETER. Pour retourner un composant qui n'est pas un OrderItem, une valeur doit être spécifiée pour ce paramètre. Pour retourner une partie du kit dynamique qui dispose d'un OrderItem, une valeur doit être spécifiée pour ce paramètre et orderItem_i.
attrName_i
Tout attribut distinct défini pour l'article.
attrValue_i
Valeur de l'attribut du produit.
ID RMA
L'identificateur d'un RMA existant et dont on doit y ajouter les articles retours. Pour créer un nouveau RMA, utilisez "**" comme valeur. Si aucune valeur n'est spécifiée pour ce paramètre, ** est utilisé par défaut.
quantity_i
(Obligatoire) 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
(Obligatoire) 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'.
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é, la valeur du paramètre RMAId est utilisée.
URL
(Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
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.

Exemple
L'exemple suivant ajoute 5 unités aux 15 articles de commande à une nouvelle RMA. Le code de cause du retour est DEFECT. Une fois la RMA créée, elle s'affiche.
    http://myhostname/webapp/wcs/stores/servlet/ReturnItemAdd?
    orderItemId_1=15&quantité_1=5&cause_1=DEFECT&RMAId=**&storeId=1
    &URL=ReturnDisplay

Comportement

Conditions d'exception

 Rubrique connexe

Référence connexe

IBM copyright