Manage POS Sales and Payment
/pos/shop is the POS working screen for both product sales and medical billing settlement. Users choose items or outstanding bills on the left, prepare the cart on the right, and complete payment through the payment modal.
Screen Structure
Top header
Transactions: opens/pos/receiptDebt Bills: opens outstanding billing reviewTop Up: opens the deposit top-up modal
Left-side selection area
- sale tab switcher
- search
- category selection
- item selection
- unpaid bill selection
Current sale tabs are:
MEDICAL_ORDERMEDICALEXTENDEDMEDICINEPRODUCT
If Hotel, Grooming, and Pet Taxi are all disabled for the branch, EXTENDED can be hidden.
Right-side cart
- selected items
- selected bills
- totals and discounts
- payment entry point
What Can Be Selected in POS
General sale items
Choose a category first and then add items.
Medical or service bills
When the current tab is MEDICAL_ORDER, the user selects unpaid ISSUED bills rather than ordinary products. Bills are grouped by customer, and choosing bills from a different customer resets the previous billing context.
That behavior strongly discourages mixing multiple customers into one cart.
Select Outstanding Bills
Step 1. Search for the bill
The search area also works for unpaid medical billing.
Step 2. Review customer-grouped bill cards
Each grouped card usually shows:
- Bill ID
- service type
- Hotel
- Grooming
- Pet Taxi
- Medical
- created time
- amount
Step 3. Keep the customer context clean
If the user selects a bill from another customer, the cart context changes. This is a major protection against front desk customer mix-up.
What the Payment Modal Supports
PaymentModal currently supports:
- single-bill payment
- multi-bill payment
Split PaymentInclude Debt- deposit usage
- deposit top-up linkage
Special Discount- note add / remove
- standard receipt printing
- Medical Bill printing
- Full Tax conversion followed by Tax Invoice printing
When multiple bills are selected together, the modal recalculates combined amount, VAT, discount, and deposit usage as one settlement view.
Multi-Bill and Split Payment
Selecting multiple bills combines them in the payment modal. Totals, VAT, discounts, and deposit usage are recalculated in that combined context.
Split payment is useful when the team needs to take multiple payment methods for one settlement.
Include Debt
When Include Debt is turned on, unpaid bills outside the currently selected bill are included in the calculation.
Warning:
Include Debtchanges the settlement scope beyond the current bill. Confirm the scope with the customer before using it.
Deposit Handling
Top Up
The top header opens the deposit top-up flow.
Deposit use during payment
The payment modal includes deposit usage in the calculation. Even if deposits are large, the displayed remaining amount does not drop below zero.
Discounts and Notes
Special Discount
Use special discount when a bill-level or item-level exceptional discount needs to be applied or reviewed.
Note
Notes can be added or removed for front desk context, dispute handling, or customer-specific settlement instructions.
Outputs After Payment
After payment success, the output flow may include:
- standard bill or receipt
- Medical Bill
- Tax Invoice
Tax Invoice may first require full-tax conversion.
Receipt review and void handling continue in .
Practical Tips
- when product and medical billing are mixed, read the combined total carefully
- keep checking the customer name while working because the outstanding-bill context can shift
- when using both
Include Debtand deposits, review the final total one more time