KTPV5 Retail POS

Glossary

Key terms used across the retail POS docs.

TermMeaning
Terminal (터미널)A POS register, identified by its ipAddress. Resolves company/store/shift per request.
Shift (교대)One open→close session on a terminal. Exactly one open per terminal; all sales/cash movements are scoped to it.
SaleInvoiceThe transaction document. type is SALE, REFUND, or SPEND.
SALE / REFUND / SPENDA sale; a return of a prior sale; internal store consumption (zero money).
Repay (재결제)Within 10 min, fully refund a sale and re-create it with new tenders (one transaction).
TenderA payment method: CASH, CREDIT, VOUCHER, GIFTCARD.
SurchargeCredit-card fee added to CREDIT tenders only (rate credit_surcharge_rate, permille). GIFTCARD = credit without surcharge.
Rounding5¢ cash rounding, applied only when an invoice is paid entirely in cash.
GSTAustralian 10% tax. Applies only to taxable items (most are non-taxable); for those the price includes GST, extracted as round(total / 11).
Member (회원)A loyalty customer held in the CRM. The POS snapshots id/name/level/phoneLast4 onto invoices.
Member levelPricing tier; selects which entry of a prices[] array applies.
Staff voucherLocal store-credit balance for a staff user (Voucher + VoucherEvent).
Customer voucherMember voucher held in the CRM (POINT_EXCHANGE / REFUND kinds).
PointsLoyalty points earned on member sales, reversed on refund; balance lives in the CRM.
HotkeyConfigurable quick-add product buttons on the sale screen (local + cloud templates).
RFDItem class — Retail / Food / Draft (ItemRFD).
GTIN / PLUNormalized barcode forms used for item matching (BarcodeType).
ScopeA permission string on a User (e.g. sale, refund); admin grants all. See Roles & Scopes.
Cloud syncFire-and-forget push of invoices/shifts to the data-server; tracked by cloudId.
MONEY_SCALE / QTY_SCALEMoney in cents (×100); quantity ×1000. See Scales & money.