Finance
Revenue (money in) is reported under Bookings. The Finance group is money
out, owned by the finance role and shared with admin / superadmin.
| Page | Purpose |
|---|---|
/admin/finance |
Finance dashboard |
/admin/finance/requisitions |
Payment requisitions, with [id] detail |
/admin/finance/bills |
Supplier bills, with [id] detail |
/admin/finance/expense-claims |
Expense claims, with [id] detail |
/admin/finance/payees |
Suppliers and payees |
Routers: financeDashboard, paymentRequisitions, supplierBills,
expenseClaims, financePayees.
Permissions
Section titled “Permissions”manage_payment_requisitions gates the admin pages and the approve / mark-paid
procedures. One deliberate exception: raising an expense claim needs no
permission — any signed-in staffer can do it through a protectedProcedure.
The gate is on approval, not on submission.
Bill status
Section titled “Bill status”Supplier bills move through draft → awaiting_approval → approved → paid, with
partially_paid when part of the amount has settled and void for cancellation.
A bill is marked paid only when the recorded payments reach the total —
otherwise it lands in partially_paid.
Auction payout statements
Section titled “Auction payout statements”A payout statement records the consignor/artist’s proceeds from a sold lot,
or the proceeds retained from a house-owned lot. It is supporting documentation,
not a tax invoice, and does not itself pay the artist. Only globally scoped
finance, admin or superadmin staff can issue or download statements;
event-scoped organizer staff cannot.
Before issuing
Section titled “Before issuing”Choose the Consignor field in the issue modal:
- Registered payee (
Payee): use when the consignor already has an active payee under Finance → Payees, with a bank name and account number. Select that payee; the PDF prints their snapshotted name and bank details, seller fee and net payout. - External consignor — payee not set up yet (
TBC): use when the external consignor has no payee yet. No payee selection is needed. The recipient is the lot’s artist name(s), or “Consignor” if none are recorded. The PDF shows the seller fee and net payout and says payout details are to be confirmed with the consignor. Void and reissue as a registered payee once the payee exists. - TCGKL Auction House (house lot) (
House): use for a house-owned lot. No payee selection is needed. The recipient is TCGKL Auction House (Hajoon Capital Sdn Bhd). The fee is locked at 0%, with no zero-fee confirmation required. The PDF records the full hammer amount as proceeds retained by Hajoon Capital Sdn Bhd; no consignor payout arises.
There are no free-text bank fields. Confirm the consignor and, for a registered payee, the bank details before issuing: statements snapshot these details and cannot be edited afterwards.
Preview, issue and download
Section titled “Preview, issue and download”- Open Auctions → event → Winners & payments.
- On the paid invoice, select Issue payout statement.
- Choose Consignor and, for Registered payee, select the payee.
- Enter the seller fee % (default
0%), confirm the payment method, and add an optional note. For registered payees and external consignors, confirm the zero-fee deduction when leaving the fee at0%. House lots lock the fee at0%and do not require that checkbox. The seller fee is separate from the buyer’s 4% platform fee; the buyer fee never appears on the statement. - Review the winning bid, seller fee and net payout (or proceeds retained for a house lot), then select Preview PDF. The preview is a draft, not an issued statement.
- Issue the statement. Download its PDF from the invoice or the event’s
Payout statements section using Download PDF / Download.
The issued number is
TCGKL-AS-YYYY-NNNNNN; later downloads use the saved snapshot, not current payee or lot details. Both locations show the recipient name and a Payee, TBC or House text label.
Issuance is blocked when the lot is not sold, the invoice is not paid or does not match the settled winner, the manual payment method is complimentary, the Stripe payment is refunded or disputed (or cannot be verified), or an issued statement already exists for the invoice or lot. Registered payee also requires an active payee with bank details; that requirement does not apply to external consignors awaiting a payee or house lots. Complimentary, house-funded consignor payouts use a normal payment requisition instead; they are not paid sales of house-owned lots.
Share with the consignor
Section titled “Share with the consignor”- In Winners & payments, select Share next to the issued statement’s Download PDF button, or open Payout statements and select Share on its issued row. Voided statements cannot be shared.
- Email: verify the artist/consignor’s address in To. It is prefilled from the registered payee’s contact email when there is one, and empty for external consignors without a payee; never use the buyer’s address. Add an optional message (up to 500 characters) and select Send PDF by email. The consignor receives a branded email with the issued PDF attached. Check the Sent to … confirmation; errors are shown without claiming a successful send.
- WhatsApp link: leave Expires after at 30 days, or choose 7 or 90 days, then select Create link & copy. Paste the copied URL into WhatsApp for the consignor. If clipboard access fails, use the displayed read-only Share URL and Copy button, or select and copy it manually. Copy it before closing: the complete URL is returned only once and cannot be retrieved from history.
- Review Deliveries for email recipients, creating staff/time, link expiry, opens and Active / Expired / Revoked status. Emails show Sent; this is not an email-read receipt. History refreshes after each action and every 30 seconds while the modal is open.
- If a link was shared by mistake, select Revoke on its active history row, then Confirm revoke. Cancel leaves the link active. To replace a lost or expired URL, create a new link; each link has its own expiry and revocation.
The artist can open an active link directly to view/download the issued PDF without signing in. It contains the same immutable payout details as the Finance download, including bank details for a registered payee. Anyone with the URL can access it until expiry or revocation, so send it only to the intended consignor. Opening a link increments its access count; that count does not identify who opened it or confirm a payout.
Voiding the statement immediately stops all its share links: expired, revoked and void-statement links return 410 Gone rather than a PDF. Revocation or voiding cannot recall an email attachment or a PDF already saved by its recipient. A replacement statement must be shared separately.
House lots have no consignor: the modal hides Email and shows a note, and share links cannot be created for them. Sharing is staff-driven; there is no artist portal or automatic artist-contact lookup.
Void and reissue
Section titled “Void and reissue”Statements are immutable. A globally scoped admin or superadmin other than the issuer must select Void and provide a reason. Finance staff cannot void, and an admin cannot void their own statement. The voided statement remains in the history and its downloaded PDF is marked VOID. After voiding, Finance may issue a replacement with a new number. For a TBC statement, create the active payee with bank details, then void the old statement and reissue with Consignor → Registered payee. Use the same void-and-reissue path to correct the recipient kind or snapshotted bank details.
Reconcile the payout
Section titled “Reconcile the payout”For a registered payee, raise a payment requisition to the same payee for the statement’s net amount, and quote the statement number in the requisition description or supporting notes. Reconcile the actual payment against that requisition. For an external consignor, set up the payee and void/reissue before arranging the payout. House lots record retained proceeds, not a consignor payment, so do not raise a consignor payout requisition for them. There is no statement-to-requisition linking UI yet.
Every approval, mark-paid and payee change is audit-logged. Finance actions are the first thing anyone looks at in a dispute, so the trail matters more here than anywhere else — see Audit trail.
