Learn how to create promotional campaigns in the portal, how promos are automatically applied at the cashier, and how to view results in sales reports.
The Promotions feature lets you create various types of discounts that are automatically applied when the cashier processes transactions in the POS app. You create promotions in the Management Portal (app.kaswarung.com), and they automatically sync to the Android cashier app. When customers checkout, the system calculates and applies the best discount automatically — no manual input from the cashier needed.
KasWarung supports 5 promotion types that can be combined
Gives a discount based on a percentage of the item price. Great for general promos like "10% Off" or "Save 25%".
💡 Example:
10% off all Indomie products → customer buys Indomie Rp 3,500, pays Rp 3,150
Gives a fixed Rupiah amount off per item. Great for promos like "Rp 5,000 Off" or "Save Rp 2,000".
💡 Example:
Rp 2,000 off Teh Botol → customer buys Teh Botol Rp 5,000, pays Rp 3,000
For every 2 qualifying units of a product, 1 unit is free. The system calculates automatically based on items in the cart.
💡 Example:
BOGO on Aqua 600ml → customer buys 4 bottles, pays for only 2
Gives a discount when the customer buys ALL products in the package. Perfect for combo meals or value packs.
💡 Example:
Rice + Chicken + Tea combo = save Rp 5,000 → buy all three, total is reduced by Rp 5,000
Gives a percentage discount when the customer buys a minimum quantity. Great for encouraging bulk purchases.
💡 Example:
Buy 10+ Lifebuoy Soap, get 15% off → buy 12 units, save 15% on the total
Step-by-step guide in the Management Portal
Log in to app.kaswarung.com → click "Promotions" in the left sidebar → click the "Add Promotion" button.
Give the promotion a name (e.g., "10% Off Indomie"), select the promotion type (Percentage/Fixed/BOGO/Bundle/Volume), and enter the discount value.
Specify whether the promotion applies to specific products, specific categories, or all products. For bundles, select all products that must be in the package.
Set start and end dates for temporary promos. Set a maximum usage limit if you want to cap it (e.g., only 100 uses).
Click Save. The promotion is immediately active and automatically synced to all cashier apps in your outlets. Cashiers don't need to do anything — promos apply automatically.
Promotions are automatically applied at checkout
When the cashier adds products to the cart, the system automatically evaluates all active promotions and applies the best discount. The cashier sees strikethrough pricing (original price) and the discounted price directly on the cart screen.
Tier 1 — Per-Item Discounts
Percentage, Fixed, and Volume discounts are applied directly to each qualifying item. Each item gets the best available promo.
Tier 2 — Cart-Level Discounts
BOGO and Bundle discounts are calculated for the entire cart. The system picks the single best cart-level promo (highest discount).
Per-item discounts (Tier 1) and cart-level discounts (Tier 2) can apply simultaneously in a single transaction. Example: Indomie gets 10% off (Tier 1), while the Rice+Chicken+Tea bundle gives Rp 5,000 off (Tier 2). Both discounts are calculated and applied.
Manual discounts (entered by the cashier) can still be added on top of automatic promo discounts. So total discount = promo discount + manual discount.
Manual discounts activated by code
Coupon Codes are promotions that require manual code input by the cashier. Unlike auto-promotions that apply instantly, coupons only activate when the cashier enters the correct code. Coupons use the same discount types (percentage, fixed, BOGO, bundle, volume) but require manual activation.
💡 Example:
Coupon code "SAVE20" → cashier enters code → 20% discount applied to all qualifying items
Create coupons from the Coupon tab in the Promotions menu.
Cashiers enter the coupon code in the cart sidebar before processing payment.
When a coupon is active, all auto-apply promotions are temporarily suspended. This follows industry standards to prevent customers from receiving double discounts. When the coupon is removed, auto-promotions resume normally.
Promotions are visible in many places for full transparency
Strikethrough pricing on discounted items, promo name badges, and total savings are clearly visible on the cashier screen.
Printed and digital receipts show items with original price crossed out, subtotal after discount, and the applied promo name.
Transactions with discounts are marked with a green badge in the history list. Full details visible when tapping a transaction.
In the Sales menu, click a transaction to see details. Promotion names appear as badges in the transaction summary.
When exporting an invoice from the portal, promotion names and total discount are shown in the discount line of the invoice.
Transaction detail reports include the applied promotion names, making it easy to analyze the effectiveness of your promo campaigns.
Full control over promotion usage
Each promotion can be limited to a specific number of uses (e.g., max 100 times). Once the limit is reached, the promo automatically stops applying. Usage counts sync in real-time from cashier to portal.
Set start and end dates for temporary promotions. Outside this date range, the promo won't apply even if it's marked as active. Perfect for Ramadan, Eid, or flash sale promotions.
Some promo types (especially volume) can require a minimum purchase quantity. Example: "15% off when buying 10+ units". If the customer buys fewer than 10, the discount doesn't apply.
If a transaction that used a promo is voided or refunded, the promo usage count is automatically decremented. So usage limits remain accurate.
No. All active promos are automatically evaluated and applied when items are added to the cart. The cashier just scans/adds products as usual.
Yes. The system supports multi-promo stacking. Per-item and cart-level discounts can apply simultaneously. All promo names are recorded in the transaction.
The system stores promotion IDs, not names. So reports will always show the latest promo name when you view them. This ensures data consistency.
Currently, promotions apply to all outlets within a business. Per-outlet targeting will be added in a future version.
Promotions sync when the cashier app opens or during catalog sync (automatic). Usually within seconds after the promo is saved in the portal.
Auto-promotions apply automatically when items qualify. Coupons require a code manually entered by the cashier. When a coupon is active, auto-promotions are suspended to prevent double discounts.
The system shows a specific error message — whether the code is not found, expired, has reached its usage limit, or the cart doesn't meet requirements. Auto-promotions remain active until a valid coupon is applied.
Log in to the portal and create your first promo campaign. Discounts automatically apply across all outlets.
