POS and sales

Check in a customer, build a cart, take payment, cancel, and review receipts and refunds.

POS

/dashboard/platform/pos is the counter screen. You need an open register shift (Cash).

  1. Check in the customer. See Customers. This calls checkInCannabisCustomer and creates a cart with createPosCannabisCart.
  2. Price and add a product and quantity. The server quotes the line (cannabisCartAllocationQuote), choosing the package. You review the price, then addCannabisCartLine reserves stock. If the quote changed you see Reviewed quote changed; retain the original command and review a separate....
  3. Prepare the order if needed with transitionCannabisCartPreparation: reserved, picking, staged.
  4. Take payment with finalizeCannabisSale. The button reads Complete sale · <total> and asks for confirmation.
  5. Cancel with cancelCannabisCart to return reserved items to stock.

Payment fields

TenderField
CashCash received. Tendered less change must equal the applied amount
Debit, ACH, wallet, otherTerminal approval code (providerReference)

Caregiver sales ask for a second authority check at payment.

Cart statuses

draft, preliminarily_eligible, reserved, picking, staged, final_verification, completed, expired, cancelled, rejected.

Limits applied on every line

Purchase limits, tax rule and discount rules from the active rule pack. A breach returns, for example, Configured <window> purchase limit exceeded for <category>. A sale also needs exactly one active traceability installation (Exactly one externally validated active traceability installation is required before sale).

Sales

/dashboard/platform/sales lists receipts with status tabs and search. /sales/[id] shows lines, tenders, state-reporting state and refunds.

Sale statuses: finalized, state_queued, state_accepted, state_rejected, reconciled, reversal_pending, reversed, partially_refunded, refunded.

Refund

On the receipt page choose Refund.

FieldNotes
Original paymentThe tender to refund against
AmountUp to the remaining refundable total
Reason codeLowercase code such as damaged_product
Returned productNothing returned, Quarantine, Waste, Returned to the authority
Terminal refund referenceNon-cash only
Approver email and passwordA second finance person

refundCannabisSale needs canManageFinance.

On this page