DolicraftRMA

DolicraftRMA - Complete Return Merchandise Authorization for Dolibarr

The most complete RMA module for Dolibarr. Manage customer returns, supplier returns, inspections, refunds, replacements, and store credits - all from within Dolibarr. 45 files, 11,500+ lines of PHP, 8-status workflow, 7 disposition types, and a public self-service portal. No other Dolibarr module offers this level of return management.

Core Return Management

Customer & Supplier Returns

Create return requests from orders, shipments, or invoices. Supports both customer returns (products coming back) and supplier returns (sending defective goods back to your supplier). Each return tracks the source document, return reason, and all associated lines with quantities.

8-Status Workflow

A complete lifecycle for every return:

Draft - Return request created, can be edited

Validated - Submitted for review

Approved - Return authorized (manual or auto-approval)

Denied - Return rejected with reason

Received - Products physically received at warehouse

Inspected - Line-by-line quality inspection completed

Closed - Resolution applied (refund, replacement, etc.)

Cancelled - Return cancelled

Line-Level Inspection

Inspect each returned product individually. Mark lines as pass, fail, or partial. Add detailed inspection notes per line. The inspection result drives the final disposition for each item.

7 Disposition Types

Flexible resolution options for each return:

Refund - Full monetary refund via credit note

Replace - Auto-create a replacement order

Repair - Send for repair and track status

Restock - Return to inventory

Scrap - Mark as unsalvageable

Store Credit - Generate a voucher for future purchases

Credit Note - Create a credit note with optional restocking fee deduction

Automation Engine

Auto Stock Movements

When a return is received, stock is automatically adjusted in the correct warehouse. No manual stock entry needed.

Auto Credit Note Generation

Generate credit notes automatically from approved returns. Configurable restocking fee deduction (percentage or fixed amount) is applied before the credit note is created.

Auto Replacement Orders

When the disposition is "replace", a new order is automatically created with the same products, ready for shipment.

Auto Store Credit / Voucher

Generate store credit vouchers automatically. The voucher amount and validity are configurable.

Auto-Approval Rules Engine

Define rules to automatically approve returns based on conditions: maximum amount threshold, delay since purchase, and return reason. Returns matching all conditions are approved instantly without manual review.

Email Notifications

Automatic email notifications sent at each status change. Keep customers and internal teams informed throughout the return process.

Customer Self-Service Portal

Public Return Request Page

Customers can submit return requests through a public page - no login required. They enter their order reference, select products to return, specify the reason, and upload photos of damaged items.

Public Return Tracking

Customers track their return status in real time through a public tracking page using their return reference number.

Monitoring & Analytics

SLA Tracking with Escalation

Define SLA targets for return processing time. Returns approaching or exceeding the SLA are automatically escalated with alerts.

KPI Dashboard

Real-time dashboard showing: total open return value, average days to close, return rate percentage, and SLA compliance rate. Widgets available on the Dolibarr home page.

Statistics Page

Detailed analytics: returns by reason, by resolution type, by month, top returned products, and top returning clients. Export data for further analysis.

Agenda Events

Every status change and action creates an event in the Dolibarr agenda for full traceability.

Administration

Return Reason Configuration

Admin page to manage return reasons (defective, wrong item, not as described, changed mind, etc.). Each reason can be linked to auto-approval rules.

8 Granular Permissions

Fine-grained access control: create, read, update, delete, approve, inspect, close, and configure. Assign permissions by user role.

PDF Return Authorization

Generate a professional PDF return authorization document that customers can print and include with their return shipment.

REST API

Full REST API for integration with external systems: create returns, update status, retrieve return data programmatically.

Technical Highlights

45 files, 11,500+ lines of PHP - Production-ready, thoroughly tested

6 languages - French, English, Spanish, German, Italian, Portuguese (BR)

Dolibarr 16+ - Compatible with Dolibarr 16 through 23

PHP 7.4 - 8.3 - Works with all modern PHP versions

Zero dependencies - No external libraries, pure Dolibarr module

Standard Dolibarr patterns - Uses hooks, triggers, and standard class architecture

Dashboard widgets - KPI widgets on the Dolibarr home page

Requirements

Dolibarr 16.0+

PHP 7.4 - 8.3

Stock module activated (for auto stock movements)

Installation

Copy to htdocs/custom/dolicraftrma/

Activate in Home > Setup > Modules

Configure return reasons and restocking fees in the Settings tab

Start managing returns professionally!

Developed by Dolicraft - Professional Dolibarr modules. Support: contact@dolicraft.com