Point of Sale

Quick Sale

The complete counter workflow, and the exact shape of the sale the system records when you press Complete.

Last updated 2026-10-13

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

Included freepos.quick_sale0 IQD

Overview

A quick sale is the standard over-the-counter transaction: pick items, take money, hand over goods. Stock comes off the shelf the moment the sale completes — there is no separate confirmation step. If you need an order that is prepared and approved before stock moves, use Sales Orders instead.

Point of Sale — POS with a cart in progress
POS with a cart in progress
POS with a cart in progress — Three items in the cart, a customer attached, and the payment panel showing the total due.

Step by step

  1. 1

    Open the POS

    Choose POS from the navigation menu. If a PIN lock is set on the register, enter it first.

    Point of Sale — Empty POS screen
    Empty POS screen
    Empty POS screen — The POS as it appears before anything is added to the cart.
  2. 2

    Find the product

    Type into the search box (F2) to match on product name, SKU or barcode, or tap a card in the grid. With a scanner, scanning fills the box and adds the item in one motion — barcode search needs no subscription.

    Point of Sale — Product search results
    Product search results
    Product search results — Matching products shown as selectable cards with price and stock on hand.
  3. 3

    Add it to the cart

    Select the product to add one unit. Adjust the quantity with the plus and minus controls, or type the quantity directly. The line total updates as you go. A product sold by the piece that also has a carton price asks Piece or Carton first, and each choice gets its own row. The cart never lets a quantity go past what is in stock.

  4. 4

    Attach a customer (optional)

    Search by name or phone number to link the sale to a customer record. Leave it alone for an anonymous cash sale and the default General Customer is used. If the customer has sub-customers, a For box appears so the invoice can be marked for one of their people.

    Requires subscriptionpos.customer_select2,000 IQD / month
    Point of Sale — Customer picker
    Customer picker
    Customer picker — Searching for a customer by name or phone from inside the POS.
  5. 5

    Apply discounts (optional)

    Discount a single line as a percentage or an amount, or discount the invoice total. The two are separate features and can be used together.

    Requires subscriptionpos.discount_item2,000 IQD / month
    Requires subscriptionpos.discount_total2,000 IQD / month
  6. 6

    Choose the payment type

    Cash takes the money now and needs the amount paid. Postpaid puts the remainder on the customer's account, requires a named customer, and is refused if it would take them past their credit limit.

    Requires subscriptionpos.postpaid3,000 IQD / month
    Point of Sale — Payment panel
    Payment panel
    Payment panel — Payment type buttons, the amount tendered field and the change due.
  7. 7

    Complete the sale

    Press Complete (F12), add a note if you want one printed on the invoice, and confirm. The invoice is written, stock is reduced, and — for a postpaid sale — the customer's balance goes up by whatever is left unpaid.

  8. 8

    Print the invoice (optional)

    Print on A4 or on an 80mm thermal roll. What appears on the printout is controlled by your invoice settings.

    Requires subscriptionpos.invoice_print5,000 IQD / month
    Point of Sale — Print preview
    Print preview
    Print preview — The in-page invoice preview with the A4 and thermal size options.

Piece or carton

A product that is sold by the piecekeeps its stock and price per single piece, and can carry a second price for the whole carton. Adding one to the cart asks which you are selling. A box and loose pieces of the same product sit on two rows of the same invoice — “1 carton” and “7 pieces” — and the invoice prints them exactly as typed.

NoteStock still counts pieces: selling one carton of 12 takes 12 off the shelf. The two rows share the same stock, so together they can never exceed what is there.

Typing a different price

The price on a cart line can be typed over — a negotiated price, for example. The owner can always do it; a staff member only when the owner has switched on Change the price at the POS for them, which is off by default.

WarningA typed price below what the product cost you is refused for everyone, the owner included. It is compared per line unit, so a carton is compared with the cost of all its pieces. A cashier who is not allowed to see cost prices is told the price is too low without being shown the cost. Discounts are a separate feature and are not part of this check.

When a sale is refused

  • Out of stock — you cannot sell more than the system holds. Receive the goods or correct the count first; nobody can override this.
  • Credit limit exceeded — a postpaid sale that would take the customer over their limit. Take a payment, raise the limit, or sell for cash.
  • Price below cost — see above.
  • No selling price — set a price on the product first.

The sale record

Completing a sale posts to POST /api/v1/sales. Totals are recalculated on the server from the line items, so a tampered total sent by a browser is ignored.

Sale body
ParameterTypeRequiredDescription
customer_idintegerRequiredCustomer on the sale. The default walk-in customer is used for anonymous sales.
payment_typestring= cashRequiredEither cash or postpaid.
paid_amountdecimalRequiredAmount actually received. For a postpaid sale this may be zero or a part payment.
discount_total_amtdecimalOptionalInvoice-level discount as a fixed amount.
discount_total_pctdecimalOptionalInvoice-level discount as a percentage.
notesstringOptionalFree text stored against the invoice and printed on it.
sub_customer_idintegerOptionalThe customer's person this invoice is for. Ignored without customer.sub_accounts.
itemsarrayRequiredThe cart lines. A sale must have at least one.
Each entry in items[]
ParameterTypeRequiredDescription
product_idintegerOptionalThe product being sold. Omitted for a free-text extra-sell line.
custom_namestringOptionalItem name for an extra-sell line that has no product record.
is_extra_sellboolean= falseOptionalMarks the line as an unregistered item. Requires pos.extra_sell.
qtydecimalRequiredQuantity sold. Decimals are allowed for weighed goods.
unit_pricedecimalRequiredPrice per line unit before any discount, in the business's main currency.
by_packboolean= falseOptionalThe line is a whole carton of a product sold by the piece. Stock moves by its pieces.
discount_pctdecimalOptionalLine discount as a percentage.
discount_amtdecimalOptionalLine discount as a fixed amount.
line_totaldecimalRequiredLine total after discount. Recomputed server-side.
POST /api/v1/sales
{
  "customer_id": 1,
  "payment_type": "cash",
  "paid_amount": 25000,
  "discount_total_amt": 0,
  "items": [
    {
      "product_id": 42,
      "qty": 2,
      "unit_price": 10000,
      "discount_pct": 0,
      "discount_amt": 0,
      "line_total": 20000
    },
    {
      "product_id": 17,
      "qty": 1,
      "unit_price": 5000,
      "discount_pct": 0,
      "discount_amt": 0,
      "line_total": 5000
    }
  ]
}
Fixing a mistake afterwardsA completed sale from the current month can be corrected in place — see Edit an Invoice. Goods coming back are a return, and a sale that should never have existed is voided. Editing and voiding are the owner, or a staff member the owner gave the permission to.
NoteEach gated action is checked again on the server as the sale is saved. A sale that carries a line discount without pos.discount_item, or a postpaid payment type without pos.postpaid, is rejected rather than silently accepted.

Related