Frappe ERPNext/Webshop
Comfac Webshop
Open Source E-commerce Platform with Enhanced Discount Visibility & System Builder
Overview
The Comfac Webshop is an open-source e-commerce platform built on the Frappe Framework and integrated with ERPNext. It enables businesses to create online stores with product catalogs, shopping carts, and order management.
This documentation covers the complete architecture, codebase, and planned enhancements for the Comfac Webshop fork.
| Attribute | Value |
|---|---|
| Base Project | Frappe Webshop |
| Framework | Frappe Framework (Python 3.10+, MariaDB/PostgreSQL) |
| Dependencies | frappe, erpnext, payments |
| Module | Webshop (single module) |
| Build System | Flit |
| Codebase Size | ~172 files, ~988KB |
Documentation Chapters
Core Architecture & Codebase
Understanding how the webshop works:
| Chapter | Title | Description |
|---|---|---|
| 01 | Architecture Overview | Framework stack, app integration, data flow |
| 02 | DocTypes | Custom DocTypes and ERPNext DocTypes |
| 03 | Shopping Cart & Quotation Deep Dive | Cart-quotation relationship, hidden fields |
| 04 | Product Pages & Browsing | /all-products, /shop-by-category |
| 05 | Variant Selector | Item variants, configurator, Redis caching |
| 06 | Pricing & Discounts | Price lists, pricing rules, coupon codes |
| 07 | Checkout & Orders | Place order flow, payment, tracking |
| 08 | Templates & Frontend | Jinja templates, JS, SCSS |
| 09 | Hooks & Events | App hooks, doc_events, CRUD handlers |
Feature Requirements & Plans
| Chapter | Title | Description | Status |
|---|---|---|---|
| 10 | Feature Gap: Cart Discounts | Missing discount visibility | 🔴 Not Implemented |
| 11 | Feature Plan: System Builder | Multi-component configurator | 🔴 Not Implemented |
Development & Deployment
| Chapter | Title | Description |
|---|---|---|
| 12 | Staging Sandbox | Testing environment, Phase 0/1/2 approach |
| 13 | Discount Visibility & Urgency | UI specs, urgency indicators |
| 14 | Implementation Hypothesis | Exact plan with code |
Missing Features for Comfac
🔴 Feature 1: Cart Discount Visibility
Status: Not Implemented | Priority: High | Effort: Medium
Problem: Discounts are calculated on the Quotation but hidden from customers. They only see final prices without understanding savings or offer deadlines.
What's Missing:
- Original price display with strikethrough
- Discount percentage badges
- "You save" amounts
- Offer deadline display
- Urgency indicators
Key Insight: All data already exists on the Quotation document. ERPNext populates these fields. This is purely a frontend/template display issue.
See: Chapter 10 | Chapter 13 | Chapter 14
🔴 Feature 2: System Builder
Status: Not Implemented | Priority: High | Effort: Large
Problem: No way to configure multi-component systems with compatibility checking and bundle pricing.
New DocTypes Required:
- System Builder Template
- Component Slot
- Compatibility Rule
- Saved Configuration
See: Chapter 11
Quick Technical Reference
The Cart IS a Quotation
The shopping cart is literally an ERPNext Quotation document with `order_type="Shopping Cart"`. All pricing features work automatically - we just need to display the fields.
Key Hidden Fields
Every Quotation Item already has:
- `price_list_rate` - Original price
- `rate` - Final price
- `discount_percentage` - Discount %
- `pricing_rules` - JSON of applied Pricing Rules
No Backend Changes Needed
For discount visibility: read existing fields, enrich decorator, update templates, style with CSS. ERPNext does all calculations.
Resources
Last Updated: March 2026 Section: Frappe ERPNext > Webshop