{"id":544847,"date":"2026-06-22T07:40:14","date_gmt":"2026-06-22T07:40:14","guid":{"rendered":"https:\/\/webkul.com\/blog\/?p=544847"},"modified":"2026-06-22T07:40:24","modified_gmt":"2026-06-22T07:40:24","slug":"user-guide-for-erpnext-return-merchandise","status":"publish","type":"post","link":"https:\/\/webkul.com\/blog\/user-guide-for-erpnext-return-merchandise\/","title":{"rendered":"User Guide for ERPNext Return Merchandise Authorization"},"content":{"rendered":"\n
\n

Introduction<\/h2>\n<\/div><\/div>\n\n\n\n

ERPNext Return Merchandise Authorization (RMA)<\/a> helps businesses manage product returns and exchanges through a simple and organized process. Customers can submit return requests directly from the website for products they have purchased.<\/p>\n\n\n\n

The module allows customers to select return reasons, specify product quantities, and add remarks while creating a request. This helps businesses collect all the required information before reviewing the request.<\/p>\n\n\n\n

ERPNext Return Merchandise Authorization (RMA) also helps administrators manage return requests, create custom return stages and reasons, track request progress, and keep customers informed throughout the return process.<\/p>\n\n\n\n

\n

Features<\/h2>\n<\/div><\/div>\n\n\n\n
    \n
  1. Allow customers to submit product return and exchange requests directly from the website.<\/li>\n\n\n\n
  2. Create return requests for single or multiple products in one submission.<\/li>\n\n\n\n
  3. Let customers select return reasons and add remarks for better request details.<\/li>\n\n\n\n
  4. Generate a unique RMA reference number for every return request.<\/li>\n\n\n\n
  5. Manage return requests directly from the ERPNext Return Merchandise Authorization (RMA) backend.<\/li>\n\n\n\n
  6. Create and manage custom return stages based on business requirements.<\/li>\n\n\n\n
  7. Create custom return reasons for a structured return process.<\/li>\n\n\n\n
  8. Track return requests through stages such as Pending, Approved, and Rejected.<\/li>\n\n\n\n
  9. Maintain a centralized system for managing all return and exchange activities.<\/li>\n\n\n\n
  10. Support structured return and exchange workflows for better request handling<\/li>\n<\/ol>\n\n\n\n
    \n

    Installation<\/h2>\n<\/div><\/div>\n\n\n\n
      \n
    1. After purchasing the app from the Webkul store, you will receive a link to download the module ZIP file.<\/li>\n\n\n\n
    2. Extract the downloaded ZIP file, and you will see a folder named \u2018wk_product_brand\u2019.\u00a0<\/li>\n\n\n\n
    3. Set up the module in your Git repository.<\/li>\n\n\n\n
    4. If the app is hosted on GitHub, fetch it using the command:\u00a0<\/li>\n<\/ol>\n\n\n\n

                   bench get-app –branch dev <\/p>\n\n\n\n

                   https:\/\/git.webkul.com\/erpnext-apps\/webkul-rma.git<\/a> rma<\/p>\n\n\n\n

      (Replace \u201cmain\u201d with your branch name and replace the \u201cHTTPs URL\u201d with your HTTPS clone URL.)<\/p>\n\n\n\n

        \n
      1. Install the app on your site using the command:\u00a0<\/li>\n<\/ol>\n\n\n\n

        bench –site <your-site_name> install-app rma<\/p>\n\n\n\n

          \n
        1. Finally, run the \u201cbench migrate\u201d command to complete the installation.<\/li>\n<\/ol>\n\n\n\n
          \n

          Workflow<\/h2>\n<\/div><\/div>\n\n\n\n

          1. Access ERPNext Return Merchandise Authorization (RMA) <\/strong>dashboard to manage returns and perform the required operations.<\/p>\n\n\n\n

          \"RMA<\/figure>\n\n\n\n
            <\/ol>\n\n\n\n

            2. To review existing product return requests, click Review RMA Requests<\/strong> from the menu on the left side.\u00a0<\/p>\n\n\n\n

            After clicking it, you can view all return requests that are pending review by the administrator.<\/p>\n\n\n\n

            \"Review<\/figure>\n\n\n\n

            3. To create an inspection for an RMA request, click RMA Inspection<\/strong> from the menu on the left side.\u00a0<\/p>\n\n\n\n

            After clicking it, a new page will open where you can create an inspection by filling in the required details related to the RMA request. This allows you to inspect the product before approving or rejecting the request.<\/p>\n\n\n\n

              <\/ol>\n\n\n\n
              \"RMA<\/figure>\n\n\n\n
              \n

              Return Request Creation (Admin End)<\/strong><\/h3>\n<\/div><\/div>\n\n\n\n
                <\/ol>\n\n\n\n

                4. First, click RMA Request<\/strong> from the menu on the left side. A new page will open displaying all existing return requests, including approved and pending requests. From this page, click the Add RMA Request<\/strong> button to create a new return request.<\/p>\n\n\n\n

                \"RMA<\/figure>\n\n\n\n

                5. To create a new return request, click the Add RMA Request<\/strong> button. A new request form will open where you need to fill in the required details to create a return request from the Admin end.<\/p>\n\n\n\n

                \"Add<\/figure>\n\n\n\n
                \n

                Return Request Creation (Customer End)<\/strong><\/h3>\n<\/div><\/div>\n\n\n\n

                6. To create a return request from the customer end, navigate to the Return Page or the Order Page on the webshop. From there, you can create a return request for your product.<\/p>\n\n\n\n

                Next, fill in the required details in the request form, including Order Type, Order, Return Reason, Additional Details, and the Products you want to return. Once all the information is entered, submit the form to create the return request.<\/p>\n\n\n\n

                You can return any number of items or multiple products from your original order as you need.<\/p>\n\n\n\n

                  <\/ol>\n\n\n\n
                    <\/ol>\n\n\n\n
                    \"return<\/figure>\n\n\n\n

                    7. After creating a return request, you can view it on the same Return Page where the request was submitted.\u00a0<\/p>\n\n\n\n

                    The Return Page displays all the return requests you have created, along with their current status and updates.<\/p>\n\n\n\n

                      <\/ol>\n\n\n\n
                      \"Request's<\/figure>\n\n\n\n

                      8. To view all the stages of a return request, click RMA Stages<\/strong> from the menu on the left side.\u00a0<\/p>\n\n\n\n

                      This will open a page where you can see all the created stages along with their related details and information.<\/p>\n\n\n\n

                        <\/ol>\n\n\n\n
                        \"RMA<\/figure>\n\n\n\n

                        9. To add a new stage, click Add RMA Stage<\/strong> in the top-right corner of the RMA Stages page.\u00a0<\/p>\n\n\n\n

                        A new page will open where you need to fill in details such as Stage Name<\/strong>, Sequence<\/strong>, Related Status<\/strong>, and Portal Message<\/strong>. <\/p>\n\n\n\n

                        You can also use the Customer Visible<\/strong> checkbox to control whether the stage is visible to customers or remains hidden.<\/p>\n\n\n\n

                          <\/ol>\n\n\n\n
                          \"Add<\/figure>\n\n\n\n

                          10. To view all return reasons, click RMA Return Reasons<\/strong> from the menu. This will open a page displaying the complete list of return reasons along with their related information.<\/p>\n\n\n\n

                            <\/ol>\n\n\n\n
                            \"RMA<\/figure>\n\n\n\n

                            11. By clicking the Add RMA Return Reason<\/strong> button, a new page will open where you need to fill in details such as Default Return Action<\/strong>.\u00a0<\/p>\n\n\n\n

                            You can also use the Disable<\/strong> checkbox to activate or deactivate the return reason and the Require Inspection<\/strong> checkbox to enable or disable inspection for that specific return reason.<\/p>\n\n\n\n

                              <\/ol>\n\n\n\n
                              \"Add<\/figure>\n\n\n\n
                              \n

                              RMA Configuration<\/h3>\n<\/div><\/div>\n\n\n\n

                              You can set up the ERPNext Return Merchandise Authorization (RMA)<\/strong> module according to your needs from the Settings page.<\/p>\n\n\n\n

                              To open the settings, go to the main dashboard, find the menu on the left side, and click Settings<\/strong> to open the configuration page.<\/p>\n\n\n\n

                              Here you will find the following sections:<\/p>\n\n\n\n

                                <\/ol>\n\n\n\n

                                1. RMA Number Configuration: –\u00a0<\/strong><\/p>\n\n\n\n

                                Here you can configure the RMA Naming Series<\/strong>.<\/p>\n\n\n\n