Add Purchase Menu

Purpose

The Add Purchase page is used to create a new purchase transaction: select a supplier, select a warehouse, add items to the cart, set price/qty/discount/tax per item, and then save the purchase.

Prerequisites

• A supplier must be selected first (without a supplier, product search/scan is locked).
• A warehouse must be selected.
• At least 1 product must be in the cart before you can save.

Main sections

1. Select supplier

   • Use “Search supplier…” to find a supplier.
   • A dropdown suggestion list appears while typing. Tap a supplier name to select.
   • Tap ✕ to clear the selected supplier.

2. Select warehouse

   • Tap “Warehouse” to open the warehouse list.
   • Tap a warehouse to select.

3. Add products to cart

   • Use “Scan / search products…” to find products.
   • 🎤 Voice Search: search by voice (available after selecting supplier).
   • 📷 Scan Barcode: open barcode scanner (available after selecting supplier).
   • Search results appear as a list; tap an item to add it to the cart.
   • If there is only one result, it may be added automatically.

4. Cart list

   • Each row shows product name, price/unit summary, qty, and subtotal.
   • Qty can be edited directly in the qty field on the right.
   • Tap product info area to open the edit item modal.

Edit item (modal)

When you tap an item in the cart, the “Edit Item” modal appears.

Available fields:

1. Qty: purchase quantity.
2. Unit: choose a unit (if the product has multiple units).
3. Cost (HPP): purchase price per unit.
4. Calculate: total calculator to help derive unit cost (calculate ÷ qty = cost/unit).
5. Discount: per-item discount (numeric).
6. Tax: choose a tax from the list (or no tax).
7. Serial Number: optional serial number.
8. Expiry Date: optional expiry date (YYYY-MM-DD).

Action buttons:

• Cancel: close without saving changes.
• Delete: remove item from cart.
• Save: save item changes back to the cart.

Bottom summary & actions (summary bar)

At the bottom you’ll see the summary and action buttons:

1. Invoice Discount
   • Discount applied to the whole purchase invoice.
2. Total
   • Final total = item totals (incl. item taxes) − invoice discount.
3. Notes & Attachments
   • Opens the Notes & Attachments modal.
4. Action buttons
   • 🌙/☀️: toggle dark/light theme.
   • ↺: clear the cart (reset cart).
   • 💾 Save Purchase: save the purchase transaction.

Notes & attachments (modal)

1. Notes
   • Purchase notes (optional).
2. Attachments
   • Attachment placeholder (file picker may not be available yet in the app).

How to save a purchase

1. Select a supplier.
2. Select a warehouse.
3. Add products to the cart (search/voice/scan).
4. Edit items if needed (qty/unit/cost/discount/tax).
5. Fill “Invoice Discount” if needed.
6. Tap “Save Purchase”.

On success, the cart will be cleared.

Auto draft

This page saves an automatic draft (supplier, warehouse, cart, invoice discount, notes, theme). If the app is closed, the draft can be restored when you return.

Tips

• Start by selecting a supplier—this is required to enable product search and scanning.
• Use “Calculate” if you know the total cost; the app can help compute cost per unit based on qty.
• If tax differs per item, set it in the edit modal for each product.