Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Authorize merchandise returns

Describes how to request to return material or merchandise back to the client site in Optimizely Configured Commerce.

Return Merchandise Authorization is a feature that provides users the option to request to return material or merchandise back to the client site. This feature is configurable and may be turned on or off per site.

Returns are initiated from the Order History Detail page on the website/storefront. The Order Status must correctly map to an existing RMA-enabled Order Status. See the Order Status Mapping article for more information on how to set this up. Orders must have a status of Complete in order to display the Return Request (RMA) button. The RMA process is as follows:

  1. Go to the website and from the My Account menu, select Order History.

  2. Click the order link for the order that needs to be returned.

  3. Click the Return Request button to initiate the return process.

  4. A pop-up appears, containing the Return Request form for the User to fill out. Enter the Quantity Returned and select the Return Reason Code from the drop down. The User can enter Order Notes explaining their return.

    • Users cannot request to return more than the quantity ordered

    • The list of valid Return Reason Codes can be managed in the Admin Console

      📘

      Note

      Return Reason codes are global in a multi-site implementation.

    • Return Reason Codes may be configured as required or optional per site

  5. The User then clicks Submit Return Request to complete the order request. The User will be presented an on-screen confirmation. The Return Request, including header and line details, is then emailed to the internal address populated in the RMA Destination Email Setting.

Set up

SettingDescriptionValue
RMA Destination EmailDefault email recipient for RMA requestString in the form of a valid email address: (e.g.,[email protected])
RequestRma.ReturnReasonsDetermines whether or not a reason is required for the returnBoolean Value (True/False)

Enable order status to allow RMA

RMA is enabled via Order Status Mapping in the Admin Console. This allows Administrators to correctly map ERP order status to the correct display name as well as the appropriate behavior.

  1. Go to Admin Console > Administration > System > Order Status Mapping.

  2. Click Edit for the desired order status.

  3. Change the Allow RMA toggle to display YES.

  4. Click Save.

Reason codes

Reason codes are provided to the user via a menu to indicate the reason for the return. An example of the reason codes can be seen in the Description column below. The codes are found in the Admin Console > Administration > System > System Lists > RmaReasonCode. To view the codes, click the Edit button for RmaReasonCode and then click the Values finger tab. If no reason codes are defined, the menu will not be displayed on the website and therefore not required to submit the RMA.

Code ClassCodeDescription
RmaReasonCodeRmaCode01Item Not Working
RmaReasonCodeRmaCode02Ordered Wrong Item
RmaReasonCodeRmaCode03Don't Like Item

Upon successful setup of RMA, orders will display the Return Request (RMA) button at the top of the Order Details page.

After clicking the Return Request (RMA) button the Return Request (RMA) page is displayed with the field to state the number of items being returned and the reason code choice menu: