Generate Bill Screen

Generate Bill Screen (หน้าจอออกบิล)

The bill construction + settlement screen. For OPD self-pay this is the single atomic action point that emits Bill + Payment + Receipt + Financial Discharge in one call. Verified during TCK-001 UAT walkthrough (uat-recon/agent-uat-handoff) Phase 5c–5e.

Access Path

• Angular state: triangular.generatebill
• State params: {patientuid, patientvisituid, isipd:false, isinterim:false}
• Upstream: OP Cashier Worklist → Generate Bill icon

Modes

Key UI elements

• Bill Template selector — chooses which receipt/invoice template to render
• Total Billable Amount (vm.totalBillableAmount)
• Payments table (vm.payments) — defaults to one cash line equal to the total
• Amount To Pay (vm.amountToPay)
• SETTLE button (primary) — fires vm.settleBill()
• CLOSE button (secondary) — back to OP Cashier Worklist

UAT-verified behavior (2026-04-29)

• Auto-allocates payors and items on load — operator does not need to click Allocate manually for self-pay.
• Default payment line is one Cash entry with paidamount = totalBillable.
• vm.settleBill() calls POST /billing/generatebill/settle which:
  1. Creates the bill
  2. Records the cash payment
  3. Issues the receipt — format RO<YY><serial> (e.g. RO26001901)
  4. Auto-advances visit to Financial Discharge (no separate user action needed)
• Print preview opens automatically after settle. Close it to return.
• After settle, getvisitjourney shows two new rows: Billing Inprogress (from lock on Cashier Worklist) and Financial Discharge (from settle).

Auto-attached service charge

Every OPD visit gets ค่าบริการผู้ป่วยนอก ในเวลาราชการ automatically:

Implication: even a fake patient that walked the OP loop with zero orders will have a 150-baht line on the bill.

Endpoints

Common pitfalls

Related

• OP Cashier Worklist
• OP Billing Workflow
• Payor and Treatment Rights
• Payment Modes
• uat-recon/agent-uat-handoff §3.8, §5 Recipe Phase 5b–5e