Point of Sale

Point of Sale

The counter screen: search a product, build a cart, take payment, print. Everything beyond the basic sale is a feature you can switch on individually.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/pos

Included freepos.quick_sale0 IQD

Overview

The POS screen is the busiest part of the system, so it is built to be worked at speed with a keyboard or a barcode scanner. pos.quick_sale is free and is what gives you the screen at all — without it the POS is unavailable. Every other POS capability is a separate paid feature, so a small shop can run on the free tier and add only what it needs.

Point of Sale — Quick POS screen
Quick POS screen
Quick POS screen — The product grid on the left, and the cart with the customer, totals and payment on the right.

What is on the screen

  • Search box — type a name, SKU or barcode, or scan. F2 puts the cursor back in it from anywhere.
  • Product grid — tap a card to add it. Filter by category, and choose how many cards sit on a row to suit the size of your screen. A product with no stock is marked Out of stock and cannot be added.
  • Custom — sell something that has no product record (needs pos.extra_sell).
  • Cart — quantity, price and discount per line, then the totals, the amount paid and the change or the remainder going on account.
  • Top bar — the active warehouse, the cashier shift and the lock button (Alt+L).
  • Complete — F12 opens the confirmation, where an optional note can be typed; the note is printed on the invoice.

Rules the till enforces

These are checked on the server every time a sale is saved, for the owner and for staff alike. None of them can be switched off.

A sale is refused when…
ParameterTypeRequiredDescription
Not in stockeveryoneRequiredA product's stock is shorter than the quantity in the cart. Counted in stock units — a carton counts as its pieces — and added up across lines.
Below costeveryoneRequiredA typed price is lower than what the product cost you. Discounts are separate and are not part of this check.
Over the credit limitpostpaidOptionalA postpaid sale would take the customer past their credit limit. Cash sales are never blocked.
No selling priceeveryoneOptionalThe product has no price yet — for example one created on a purchase and never priced.
No main currencynew businessOptionalThe owner has not chosen the business's main currency yet. See Main Currency.
NoteThe same stock and credit rules apply when a sales order is completed and when a finished invoice is edited — see Edit an Invoice. The price a cashier may type is covered in Quick Sale.

The POS features

These are the features in the POS module, with the monthly price of each. See Feature Store to subscribe.

POS module — monthly price in IQD
ParameterTypeRequiredDescription
pos.quick_sale0 IQDRequiredThe POS screen itself. Free, and required for any selling at all.
pos.customer_select2,000 IQDOptionalAttach a customer to the sale.
pos.discount_item2,000 IQDOptionalApply a discount to a single line in the cart.
pos.discount_total2,000 IQDOptionalApply a discount to the invoice total.
pos.extra_sell3,000 IQDOptionalSell an unregistered item by typing a name and price.
pos.postpaid3,000 IQDOptionalSell on credit instead of taking payment now.
pos.invoice_print5,000 IQDOptionalGenerate and print the sale invoice.
invoice.remove_watermark5,000 IQDOptionalRemove the DigitalKey mark from printed invoices.
Features that are no longer soldSearching by barcode is now part of the normal search box and needs no subscription. pos.change_calc (change calculator) and pos.low_stock_alert (low-stock warning at the counter) can no longer be bought; a business that already holds one keeps it working.
NoteFeature checks fail closed. While the system is still confirming what you are subscribed to, gated controls stay locked rather than flashing on and then disappearing. The server enforces the same rules independently, so a locked control cannot be worked around from the browser.

Owner permissions at the till

On top of the subscription, the owner decides what each staff member may do — see Team & Permissions. These five are all off for a new staff account except returns.

My Account → Team → Permissions → Quick POS
ParameterTypeRequiredDescription
Void a saleoff by defaultOptionalCancel a whole invoice.
Make a returnon by defaultOptionalTake goods back against an invoice.
Edit a finished invoice (INV)off by defaultOptionalChange a completed POS sale in place.
Change the price at the POSoff by defaultOptionalType a different price on a cart line.
Unlock another user's POSoff by defaultOptionalUse the manager override on a locked register.

Cash shifts

A shift records the cash drawer over one period of trading: what you started with, what was sold, and what should be in the drawer at the end. Sales are recorded whether or not a shift is open — the shift exists to reconcile cash, not to gate selling.

Opening and closing a shift
ParameterTypeRequiredDescription
opening_cashdecimalRequiredCash in the drawer when the shift starts.
warehouse_idintegerOptionalWhich stock location this shift sells from. Optional for single-location businesses.
closing_cashdecimalRequiredCash counted in the drawer at close — the physical count.
notesstringOptionalHandover notes — used to explain a discrepancy.

Closing a shift shows the Z-Report before you confirm it. It can be printed.

Z-Report
ParameterTypeRequiredDescription
shift_nostringOptionalReference number for the shift.
opened_attimestampOptionalWhen the shift was started, with its duration.
total_salesdecimalOptionalValue of everything sold during the shift.
cash_salesdecimalOptionalThe part that was paid in cash.
credit_salesdecimalOptionalThe part sold on credit — this is not in the drawer.
invoice_countintegerOptionalNumber of invoices raised.
void_countintegerOptionalNumber of sales voided during the shift.
expected_cashdecimalOptionalOpening cash plus cash sales — what the drawer should hold.
variancedecimalOptionalThe physical count less the expected cash.
TipThe variance is the number worth investigating, and the notes field is the place to record why.

Register lock

The POS can be locked with a 4-digit PIN so an unattended till cannot be used. The lock is per user. Lock it by hand with Alt+L, or let it lock itself after a period of inactivity.

ParameterTypeRequiredDescription
pin4 digitsRequiredThe PIN used to lock and unlock the register.
current_pin4 digitsOptionalRequired when changing or removing an existing PIN.
timeout_minutesintegerOptionalAuto-lock after 1, 2, 5, 10, 15 or 30 idle minutes — or never.
WarningIf a PIN is forgotten, the owner — or a staff member the owner gave “Unlock another user's POS” to — can unlock the register with Manager Override, entering their own username and password. There is no way to read an existing PIN back out of the system.

In this section