Reference > Shop flow URLs > Order Management subsystem URLs > Returns and refunds
ReturnItemUpdate URL
This URL updates information about a returned item and can be called for multiple return merchandise authorization (RMA) items.
URL structure
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
name-value pair with the &
character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />
Parameter values
- langId
- Sets or resets the preferred language for the duration of the session; the supported languages for a store are found in the STORELANG table
- storeId
- Required: The store reference number.
- forUser
- The logon ID of the user on whose behalf the command will be run; only a person with the authority to process orders can specify this parameter.
- 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. The user is identified by an internal user ID, as found in the USERS table.
- creditAdjustment_ i
- The amount by which to adjust the product credit amount. The format of this number must fit the rules for a java.math.BigDecimal object. The number must use a period for a decimal place. This amount will override any amount calculated by the CalculateReturnItemAdjustmentCmd task command. This parameter is optional and only valid if either the forUser or the forUserId parameter is specified.
- receive_ i
- Specifies whether the return item components should be received by the store. For example, spoiled groceries do not need to be returned to the store, whereas a sweater would.
- RMAItemId_i
- Required: The RMAItem identifier.
- quantity_ i
- The quantity being returned.
- UOM_ i
- The unit of measure for quantity_i. This value should match one of the primary keys in the QTYUNIT table. When it is not specified, then the value of the QUANTITYMEASURE column of the CATENTSHIP table for the row with the same CATENTRY_ID as the OrderItem is used, and the value of the quantity_i parameter is multiplied by the NOMINALQUANTITY column of the same row in the CATENTSHIP table.
- comment_ i
- A comment about the item being returned.
- reason_ i
- The reason for the return, as provided by the purchaser. This value can be found in the CODE column of the RTNREASON table with reason type in 'B' or 'C'.
- URL
- Required: The URL to be called when the command completes successfully.
- outRMAName
- The name to use for the name-value pair which will be passed to the redirected URL. This parameter is useful for chaining commands. If this parameter is not specified then "RMAId" is used.
Example
The following example updates RMAItem 123 to specify the return quantity of 2 and updates RMAItem 456 to specify a return quantity of 3." On successful completion, the RMA will be displayed.
http://myhostname/webapp/wcs/stores/servlet/ ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456&quantity_1=1&quantity_2=3&URL=ReturnDisplay&storeId=1
Behavior
- Updates a returned item and can be called for multiple RMA items. If this
command is called with multiple RMA items then all RMA items must belong to
the same RMA.
- The PREPARED flag of the RMA is set to 'N'. If the forUser or forUserId
parameter are specified the RMA must start in status 'EDT', 'PND', 'APP' and
the status is set to 'EDT'. Otherwise the RMA must start in status 'PRC' and
the status is changed to 'PRC'.
- Each item will be processed...
- Checks that the RMA items have not been previously credited to the customer.
- Updates the RMA item. If the quantity or receive parameters are specified
for an item, then the components (in the RMAITEMCMP table) are updated.
- If the returned item is based on an OrderItem, then the command calls
the CalculateReturnItemCreditCmd task command to calculate
the default credit amount, and sets the credit amount on the RMA item.
- If the returned item is based on a catalog entry, then the command calls the CalculateReturnItemCreditForCatEntryCmd task command.
- If the returned item is based on an OrderItem, then the command calls
the CalculateReturnItemCreditCmd task command to calculate
the default credit amount, and sets the credit amount on the RMA item.
- Calls the AutoApproveReturnItemCmd task command to see if the item is automatically approved and marks the RMA item as either "system approved" or "approval pending" depending on the result from the task command.
- Checks that the RMA items have not been previously credited to the customer.
- On successful completion, set up to redirect to the specified URL.
- Call the task command ExtendReturnItemUpdateCmd.
Exception conditions
- If the RMA status is not set to 'PRC' (that is, the forUser or forUserId
parameters are not used) or not set to 'EDT', 'PND', 'APP' (if the forUser
or forUserId parameters are used) then an ECApplicationException is raised
with message _ERR_RMA_IN_INVALID_STATE_FOR_COMMAND.
- If an RMA item is not in the same RMA as other already processed RMA items, an ECApplicationException is generated with message _ERR_BAD_MISSING_CMD_PARAMETER.
- If an RMA item has already been credited, an ECApplicationException is generated with message _ERR_BAD_MISSING_CMD_PARAMETER.
Related concepts
Related reference
ReturnCreditAndCloseScan command
Order Management subsystem URLs