Manage Receipts, Tax Invoices, and Voids

/pos/receipt is the history screen for bills that have already reached payment-complete or voided states. It supports search, date-based review, detail lookup, tax invoice printing, medical bill printing, and void handling.

Which Bills Appear Here

Based on the current implementation, Receipt currently loads only:

• PAID
• VOID

It does not directly manage unpaid ISSUED bills or general debt lists.

Screen Structure

• top search bar
  • search term
  • date range
  • Reset
• receipt table
• bill detail modal
• tax invoice modal
• void confirmation modal

Read the Receipt Table

Common columns include:

• created date
• payment date
• Bill ID
• customer name
• status
• total amount
• payment method
• memo

Sortable columns include:

• createdAt
• lastPaymentDate
• billDisplayId
• customerName
• netAmount

Search and Filter

Search

Use the search field to narrow the bill history.

Date range

The date range is useful for day-close review or dispute investigation.

Reset

Clear both search and date filtering.

Bill Detail Review

Opening a bill shows the detailed billing breakdown again. This is useful when reviewing payment method, memo, or billed items.

Print a Tax Invoice

Tax invoice printing has stricter preconditions than ordinary receipt reprint.

Typical flow

1. Convert the bill to Full Tax if needed.
2. Reload the customer information.
3. Validate whether the customer address is complete enough.
4. Open the tax invoice modal and print.

If the address is missing

The tax invoice flow stops when address data is insufficient.

Warning: If the customer address is incomplete, do not treat the failure as just a printer problem. Confirm the address first.

Print a Medical Bill

The Receipt screen can also print a Medical Bill PDF. The current implementation groups medical-bill rendering around date-grouped billing context.

Void a Bill

Void is a reason-required cancellation action, not simple deletion.

Step 1. Confirm the target

Review the already PAID bill that should be voided.

Step 2. Enter the reason

The void modal requires a non-empty reason.

Step 3. Execute the void

If successful, the list refreshes and the bill moves into VOID.

Warning: Void without a traceable reason is not allowed. The reason should be meaningful enough for audit and dispute review.

Practical Tips

• if a bill is missing from Receipt, check first whether it is actually PAID or VOID
• when tax invoice printing fails, review address completeness, customer information, and full-tax conversion in that order
• after a void, recheck closing and receipt interpretation before end of day

Related Docs