Learn how to build your product catalog, configure multi-UOM conversions, set pricing per unit, and bulk import via CSV — all managed from the portal and synced to the cashier app.
The Product Catalog is the single source of truth for everything you sell. You manage products in the Management Portal (app.kaswarung.com) — categories, product details, variants (sizes, colors), and units of measurement (UOM). All data automatically syncs to the Android cashier app. KasWarung's unique multi-UOM system lets you sell the same product in different units (pcs, box, carton) with automatic conversion and per-unit pricing.
The building blocks of your product catalog
Organize products into color-coded categories for easy browsing. Categories appear as filter tabs in both the portal and POS app catalog.
💡 Example:
Food, Beverages, Snacks, Personal Care — each with a distinct color for quick visual identification
Each product is a catalog entry with a name, description, category, and optional image. Products can have one or more variants, and each variant can be sold in multiple units of measurement.
💡 Example:
Product: "Indomie Goreng" — Category: Food, Image: product photo, with variants for different flavors
Variants represent different versions of a product — different sizes, flavors, or colors. Each variant has its own selling price, cost price, and stock level.
💡 Example:
Product "T-Shirt" → Variants: S (Rp 75,000), M (Rp 80,000), L (Rp 85,000), XL (Rp 90,000)
KasWarung supports multi-UOM per product. Define a base UOM (e.g., pcs) and conversion UOMs (e.g., box = 12 pcs, carton = 48 pcs). All stock is stored in the base UOM internally.
💡 Example:
Aqua 600ml: base UOM = pcs → Box = 24 pcs, Carton = 48 pcs. Cashier can sell in any unit
Each product variant has its own selling price and barcode. When selling in a larger UOM (e.g., box), the price is calculated using the variant price multiplied by the UOM conversion ratio.
💡 Example:
Indomie (Regular variant): sell price Rp 3,500/pcs. Box = 40 pcs → cashier sells 1 box, system charges Rp 3,500 × 40 = Rp 140,000 and deducts 40 from base stock
Step-by-step guide in the Management Portal
Go to Products → Categories → click "Add Category". Give it a name (e.g., "Beverages") and pick a color. Categories help organize products for easy browsing in the portal and POS app.
Go to Products → click "Add Product". Fill in the product name, select a category, optionally upload an image and enter a barcode/SKU. Toggle "Track Stock" if you want inventory tracking for this product.
In the product form, add one or more variants. Each variant needs a name (e.g., "Regular", "Large"), selling price, and cost price. For simple products, just use a single default variant.
Go to Products → UOM to manage your unit definitions. Then on a product, add additional UOMs with conversion ratios (e.g., 1 Box = 12 pcs). The selling price is computed automatically from the variant price × conversion ratio.
Assign unique barcodes to each product variant. When the cashier scans a barcode, the system automatically identifies the product and variant — ready for checkout.
For large catalogs, use the CSV Import feature under Products → Import. Download the template, fill in your products, and upload. The system creates products, variants, and UOMs in bulk.
Behind the scenes: storage, conversion, and pricing
All stock quantities are stored in the base UOM (e.g., pcs) in the database. When a cashier sells 1 box (= 12 pcs), the system deducts 12 from base stock. This ensures stock accuracy regardless of which UOM is used for selling or purchasing.
Storage Layer
Stock is always stored in base UOM (e.g., pcs). All operations — sales, adjustments, transfers — are converted to base UOM before updating stock.
Display Layer
The portal and POS app show stock in the most appropriate UOM. The cashier can choose which UOM to sell in, and the price adjusts automatically.
When a product is added to the cart, the system uses the variant's selling price. If the cashier selects a larger UOM (e.g., box), the price is calculated as variant price × conversion ratio. The cashier can switch UOM on the fly, and the price updates instantly.
Changing a UOM conversion ratio (e.g., 1 box was 12 pcs, now 24 pcs) only affects future transactions. Past transactions retain the conversion ratio that was active at the time of sale. Always double-check conversion ratios before saving.
Your catalog is visible across the entire ecosystem
Full CRUD for products, categories, variants, and UOM. Search, filter, paginate, and bulk edit your entire catalog from the web dashboard.
Products appear as browsable cards with images, prices, and category tabs. The cashier can search by name or scan a barcode to find products instantly.
Products in the cart show the selected UOM, quantity, unit price, and line total. The cashier can change UOM or quantity directly in the cart.
Receipts show each item with product name, variant, quantity, UOM, unit price, and line total. Discounts are shown as strikethrough pricing.
Product performance reports show top sellers, slow movers, and category breakdown. All quantities are aggregated in base UOM for consistency.
When creating POs, you select products and specify quantity in any UOM. The system converts to base UOM when receiving goods and updating stock.
Get the most out of your product catalog
If you have 50+ products, use the CSV Import feature instead of adding one by one. Download the template, fill in all products with categories, variants, prices, and barcodes, then upload in one go. You can also use CSV export to back up your catalog.
Assign barcodes to each product variant (e.g., Regular, Large). When the cashier scans a barcode, the system instantly identifies the correct product and variant — speeding up checkout.
Products with images are easier to find in the POS catalog grid. Use clear, well-lit photos. The system accepts JPEG and PNG formats. Images sync automatically to all cashier devices.
If a product is discontinued, deactivate it instead of deleting. Deactivated products are hidden from the catalog and POS but preserved in historical transactions and reports. You can reactivate them anytime.
Changes only affect future transactions. Past sales retain the conversion ratio active at the time of the transaction. Stock levels are recalculated based on the new ratio going forward.
Yes. Deactivating a product hides it from the catalog and POS, but all past transactions, reports, and stock history are preserved. You can reactivate it anytime.
Go to Products → Import, download the CSV template, fill in your products (name, category, variant, price, barcode), and upload. The system creates everything in bulk. Existing products with matching barcodes can be updated.
Yes. When adding a product to the cart, the cashier can tap to switch between available UOMs (pcs, box, carton, etc.). The price updates automatically based on the selected UOM.
Currently, each product belongs to one category. This keeps the catalog clean and prevents confusion. If you need a product in multiple groups, consider using a broader category name.
Log in to the portal and start adding products. Your catalog syncs automatically to all cashier apps.
