Skip to main content

Invoice Lifecycle

Invoices represent what the customer owes. They should remain readable, auditable, and aligned with Bukku.

How to Review an Invoice

  1. Go to Finance, then Invoices.
  2. Search by invoice number, customer name, or customer email.
  3. Open the invoice detail page.
  4. Review the header for invoice number, status, customer, and balance.
  5. Check line items, discounts, SST, payments, allocations, and remarks.
  6. Open Preview Invoice to review the customer-facing invoice.

Primary Model

The primary model is one invoice with multiple payments.

This applies to:

  • Deposit plus installment
  • Manual payment collection
  • Partial payment
  • Payment retry after failure
  • Membership renewal payment

Older transactions may still have multiple invoices and multiple payments. Finance screens should support those records while making the one-invoice flow the default.

Invoice Status

StatusMeaning
DraftInvoice is prepared but not finalized
UnpaidNo payment has been allocated
Partial PaidSome payment has been allocated
PaidInvoice balance is fully settled
VoidInvoice should no longer be collected

Statuses should use color icon plus label.

Invoice Details

Invoice detail views should include:

  • Invoice number
  • Status
  • Customer name, email, phone, and address
  • Company name, address, email, phone, and tax numbers
  • Line items
  • Discounts
  • SST
  • Payments
  • Allocations
  • Remarks
  • Audit trail
  • Preview and PDF download actions

Remarks

Remarks are finance notes that require traceability. A remark should include:

  • Remark text
  • Added by
  • Timestamp
  • Related invoice

Use "Remarks" instead of "Notes" in finance-facing invoice screens.