View source for Webshop-10-Feature-Gap-Cart-Discounts

= 10 - Feature Gap: Cart Discounts =

'''Parent:''' [Webshop-Index Webshop Index]  
'''Previous:''' [Webshop-09-Hooks-and-Events 09 - Hooks & Events]  
'''Next:''' [Webshop-11-Feature-Plan-System-Builder 11 - Feature Plan: System Builder]  
'''Source:''' [https://github.com/Comfac-Global-Group/comfac-webshop/wiki/10-Feature-Gap-Cart-Discounts Comfac Webshop Wiki - Chapter 10]

'''Status:''' 🔴 Not Implemented | '''Priority:''' High

----

== Problem Statement ==

Discounts (from Pricing Rules, Coupon Codes, etc.) are calculated on the Quotation backend but are NOT displayed to the customer in the shopping cart UI. Customers see only the final price without understanding what promotions are active or how much they're saving.

== Current State ==

=== What the customer sees in the cart: ===

- Item name, code, image
- Quantity (editable)
- Rate (final price per unit)
- Amount (total for that line)
- Net Total, Taxes, Grand Total
- Coupon code badge (if applied)

=== What exists on the Quotation but is HIDDEN: ===

- Original price (<code>price_list_rate</code>) before discount
- Discount percentage (<code>discount_percentage</code>)
- Per-item discount amount
- Total savings
- Which pricing rules are active
- Additional discount on total (<code>discount_amount</code>, <code>additional_discount_percentage</code>)

== Where the Fix Needs to Happen ==

=== 1. <code>cart_items.html</code> - Per-item discount display ===

'''Current:''' Shows only <code>rate</code> and <code>amount</code>
'''Needed:''' Show <code>price_list_rate</code> struck through when it differs from <code>rate</code>, plus discount badge

<pre>jinja2
{% if item.price_list_rate and item.price_list_rate != item.rate %}
    <span class="original-price text-muted" style="text-decoration: line-through;">
        {{ item.get_formatted('price_list_rate') }}
    </span>
    <span class="discount-badge text-success ml-1">
        -{{ item.discount_percentage }}%
    </span>
{% endif %}
<pre>

=== 2. <code>cart_payment_summary.html</code> - Savings total ===

'''Current:''' Net Total, Taxes, Grand Total only
'''Needed:''' Add "You Save" row

=== 3. <code>cart_items_total.html</code> - Pre-discount subtotal ===

'''Current:''' Shows <code>doc.total</code> only
'''Needed:''' Optionally show original total and savings

=== 4. <code>cart_items_dropdown.html</code> - Navbar mini-cart ===

'''Current:''' Shows <code>amount</code> only
'''Needed:''' Strike-through price when discounted

=== 5. Quotation DocType Modifications ===

To "better reflect discounts" per the requirements:

- Consider adding a '''child table or virtual field''' that summarizes all active pricing rules per item
- Add a "Discount Summary" section to the Quotation print format
- Potentially add <code>total_savings</code> as a computed field on Quotation

== No Backend Changes Needed ==

All discount data is already computed by ERPNext's pricing engine during:
- <code>apply_cart_settings()</code> 
- <code>set_price_list_and_item_details()</code> 
- <code>calculate_taxes_and_totals()</code>

This is purely a '''frontend/template display issue'''.

== Files to Modify ==

{| class="wikitable"
|-
| File
| Change
|}
|--------|----------|
{| class="wikitable"
|-
| <code>templates/includes/cart/cart_items.html</code>
| Add original price, discount % display
|-
| <code>templates/includes/cart/cart_payment_summary.html</code>
| Add savings row, discount summary
|-
| <code>templates/includes/cart/cart_items_total.html</code>
| Add pre-discount total
|-
| <code>templates/includes/cart/cart_items_dropdown.html</code>
| Add strike-through price
|-
| <code>public/scss/webshop_cart.scss</code>
| Styles for discount badges, strike-through
|}

== Edge Cases to Handle ==

1. '''Free items''' (<code>is_free_item=True</code>) - already handled with "FREE" badge
2. '''Items with no discount''' (<code>price_list_rate == rate</code>) - no change needed
3. '''Additional discount on total''' (<code>doc.discount_amount</code>) - show separately
4. '''Multiple pricing rules per item''' - show highest or combined
5. '''Margin-based pricing''' - <code>rate_with_margin</code> field

== Related Documentation ==

- [Webshop-13-Discount-Visibility-and-Urgency Chapter 13: Discount Visibility & Urgency] - UI specifications
- [Webshop-14-Hypothesis-Discount-Deadline-Visibility Chapter 14: Hypothesis - Discount Deadline Visibility] - Exact implementation plan

----

'''Navigation:''' [Webshop-Index Webshop Index] | [Webshop-09-Hooks-and-Events Previous: 09 - Hooks & Events] | [Webshop-11-Feature-Plan-System-Builder Next: 11 - System Builder]