Buyers directory: the registered buyer roster

The Buyers directory is the market's roster of everyone cleared to bid. Every Buyer is stamped with a buyerNumber — the short number the ring clerk calls out and writes on the ticket — which is unique within your market. Alongside it sits the displayName the clerk recognizes and an optional legalName for paperwork.

The money side of the record is two figures that move together:

• creditLimit — the ceiling this buyer is allowed to owe at any one time.

• creditUsed — how much of that ceiling is currently tied up in unpaid invoices.

The gap between them is the buyer's available room. Their paymentTerms (CASH_AT_PICKUP, NET_7, NET_15, or NET_30) set when the money is actually due.

A buyer record also carries the switches that gate loadout:

• holdLoadout — a hard stop. When true, no animals leave for this buyer until the office clears it, and holdReason records why.

• idOnFile — whether their identification has been captured.

• dealerLicense and dealerLicenseExpires — a licensed dealer's number and when it lapses.

• taxExempt and taxExemptCertNumber — whether sales to them skip tax, and the certificate that proves it.

• status — ACTIVE, INACTIVE, or BANNED. A banned buyer stays on the roster (so history holds) but can't transact.