| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Sales (sale_management) |
| Lines of code | 2803 |
| Technical Name |
omni_referral_base |
| License | OPL-1 |
| Website | https://selstudio.id |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Sales (sale_management) |
| Lines of code | 2803 |
| Technical Name |
omni_referral_base |
| License | OPL-1 |
| Website | https://selstudio.id |
Omni Referral Base
Multi-Level Referral Network & Commission Management for Odoo 19
Build, automate, and monitor a complete multi-tier referral network directly inside Odoo. From member registration to commission payout - everything in one place.
Key Features
Gross Profit-Based Commission Calculation
Commissions calculated from actual gross profit (Unit Price - Cost Price) instead of total transaction amount. Protects business margin and ensures profitability on every sale.
Multi-Level Commission Rules
Define commission percentages per referral depth level based on gross profit. Unlimited levels with unique percentage per level.
Referral Member Management
Complete member lifecycle - Draft, Active, Suspended, Terminated - with sponsor hierarchy, member code, and contact linking.
Interactive Dashboard
Real-time KPI cards, commission trend & member growth charts, top members leaderboard, and one-click pending withdrawal approval.
Referral Tree Visualization
Interactive expandable network tree - see the full downline hierarchy with status badges, member avatars, and commission balance.
Commission Withdrawal
Full withdrawal request & approval workflow. Balance tracked automatically. Commissions auto-cancelled if Sales Order is cancelled.
Profit Margin Tracking
Track and monitor profit margin percentage for each transaction. Identify high-margin and low-margin sales for business analytics.
Flexible Settings
Customize member code prefix, commission auto-approval rules, inactive upline handling, and active period directly from Odoo Settings.
Member Card Report
Printable digital member card for each active member, complete with member code and contact details.
Native Odoo Integration
Deeply integrated with Odoo Sales, Contacts, Accounting, and Settings. No third-party service required - fully self-hosted.
Gross Profit-Based Commission Calculation
Why Gross Profit?
Traditional commission systems calculate commissions from total transaction amount, which can be problematic when products have different profit margins. This can lead to unprofitable situations where the commission paid out exceeds the actual profit earned on a sale.
Omni Referral Base solves this by calculating commissions from gross profit (Unit Price - Cost Price), ensuring that business profitability is always protected.
Commission Calculation Example
| Scenario | Unit Price | Cost Price | Gross Profit | Profit Margin % | Commission (15%) | Net Profit |
|---|---|---|---|---|---|---|
| Premium Product | Rp 100.000 | Rp 60.000 | Rp 40.000 | 40% | Rp 6.000 | Rp 34.000 |
| Standard Product | Rp 100.000 | Rp 85.000 | Rp 15.000 | 15% | Rp 2.250 | Rp 12.750 |
| Economy Product | Rp 100.000 | Rp 95.000 | Rp 5.000 | 5% | Rp 750 | Rp 4.250 |
- Result: All products remain profitable after commission payout, regardless of margin differences.
Screenshots
Interactive Dashboard
Referral Network Tree
Member List
Commission List with Profit Analysis
Commission Rules Configuration
Commission Settings
How It Works
- Configure Settings : Set member code prefix, commission auto-approval rules, and active period in days
- Set up Commission Rules : Define commission percentage per level based on gross profit (e.g., Level 1 = 15%, Level 2 = 8%)
- Set Product Cost Prices : Ensure each product has accurate cost price (standard_price) to calculate gross profit correctly
- Register Members : Create referral members linked to existing Odoo contacts
- Assign Sponsor : Connect each member to their upline to build the network
- Sales Order Confirmed : System calculates gross profit from all line items, then distributes commissions across upline chain based on profit (not transaction total)
- Commission Analysis : View profit margin %, net profit after commission, and other metrics for each commission record
- Approve Commissions : Manager approves or rejects pending commissions from dashboard or commission list (filters by margin profile available)
- Process Withdrawals : Members submit withdrawal requests, manager reviews and pays
- Sales Order Cancelled : All pending commissions automatically cancelled
What's Included
- - Full module source code (OPL-1)
- - Gross profit-based commission calculation
- - Profit margin tracking & analytics
- - Lifetime access to purchased version
- - Demo data included
- - Compatible with Odoo 19 Community & Enterprise
- - Email support via support@selstudio.id
- - Bug fix updates included
- - Advanced commission filtering & reporting
- - Member Portal (coming in next version)
Technical Information
| Odoo Version | 19.0 |
|---|---|
| License | OPL-1 (Odoo Proprietary) |
| Dependencies | base, sale_management, mail, account |
| Frontend | OWL JS (Odoo Web Library) |
| Charts | Apache ECharts 5 (bundled, no CDN) |
| Models | referral.member, referral.commission, commission.rule, commission.withdraw |
|---|---|
| Views | List, Form, Kanban, Dashboard, Tree Widget |
| Reports | Member Card (HTML/PDF) |
| Commission Calculation | Based on Gross Profit (Unit Price - Cost Price) |
| Profit Tracking | Margin %, Net Profit After Commission |
New Computed Fields (v19.0.2.0.0+)
| Field | Model | Description |
|---|---|---|
total_gross_profit |
sale.order | Sum of (Unit Price - Cost Price) x Qty for all line items |
gross_profit_amount |
referral.commission | Gross profit base used for commission calculation |
profit_margin_percent |
referral.commission | Transaction profit margin percentage: (Gross Profit / Total Amount) x 100 |
net_profit_after_commission |
referral.commission | Net profit remaining after commission: Gross Profit - Commission Amount |
Support & Contact
For support, bug reports, or feature requests, reach us at:
support@selstudio.id
|
https://selstudio.id
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module