DolicraftRMA - Complete Return Merchandise Authorization for Dolibarr

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

1. Copy to htdocs/custom/dolicraftrma/
2. Activate in Home > Setup > Modules
3. Configure return reasons and restocking fees in the Settings tab
4. Start managing returns professionally!

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