Reference > Shop flow URLs > Order Management subsystem URLs > Returns and refunds
ReturnItemDelete URL
This URL deletes an order item from a return merchandise authorization (RMA).
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.
- RMAItemId
- Required: The RMAItem identifier to be deleted.
- 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.
- URL
- Required: The URL to be called when the command completes successfully.
Example
The following example deletes RMA item 25 and 26 from an RMA and then displays the RMA
http://myhostname/webapp/wcs/stores/servlet/ ReturnItemDelete?&RMAId=25&RMAItemID=26&URL=ReturnDisplay&storeId=1
Behavior
- Each RMA item deleted can be from a different existing RMA.
- If this command is being run with a value specified for either the forUser
or the forUserId parameter, then the RMA must be in status "EDT", "APP", or
"PND" otherwise the status of the RMA must be "PRC".
- If no part of the item has been received and if the item has not been
credited yet then the RMA item and its components are deleted. The status
of each RMA is set to "EDT", if either the forUser or the forUserId parameter
is specified, or "PRC" otherwise.
- On successful completion, set up to redirect to the specified URL.
- Call the task command ExtendReturnItemDeleteCmd.
Exception condition
Command execution fails for the following conditions:
- If the RMA is not in the correct status, the command generates an ECApplicationException
with message _ERR_RMA_IN_INVALID_STATE_FOR_COMMAND
- If the RMA item has already been at least partially received or credited, the command generates an ECApplicationException with message _ERR_CANNOT_DELETE_RETURN_ITEM
Related concepts
Related reference
ReturnCreditAndCloseScan command
Order Management subsystem URLs