Points Setup

A point is a line in bl_crm_membership_points_txn_line: a member, a currency, a signed value, a validity window and a source (a document line, an adjustment, an import, a commission run, a scanned receipt, an expiry). The balance a cashier sees is the sum of the unexpired lots. Setup is four decisions:

Where the points on a bill come from

Membership Admin holds the currency and the rate, but not the earning rate. The number of points on a document line is put there by one of three things:

1. a Pricebook price set with a Point treatment, evaluated by POS General or the sales document applet when the line is added (DEFAULT_PRICEBOOK, PRICEBOOK_POINTS_AUTO_APPLY);
2. the scheduled Commission Scheme membership-points run, which reads a scheme’s Membership Points treatment and Validity Period (Days);
3. the OCR Cash Bill processor, which evaluates a price book against a receipt the member photographed.

The backend then turns each line that has both a point_amount and a point_currency into a transaction line — REWARD when positive, REDEEM when negative (MembershipPointsTxnService, L648–L721) — but only for the document type and posting status in the company’s MEMBER_POINT configuration, which defaults to INTERNAL_SALES_ORDER at FINAL and has no screen (MemberPointConfigUow L16–L19, L71–L95; Organisation page). A tenant that sells at the till and leaves the default earns nothing.

What points are not

They are not a ledger entry. INTERNAL_MEMBERSHIP_POINT_REWARD and INTERNAL_MEMBERSHIP_POINT_REDEEM are declared with amount and quantity signum 0 (ServerDocTypes L56–L57) and have no JournalPostingTypeHandler entry. The previous version of this section described journal entries on issue and redemption and a breakage recognition step; none of that exists. The only ledger effect of a redemption is whatever the cash bill itself posts — the points settlement or the points-discount line on the bill — which belongs to POS General.