POS Articles

Who this is for: Owner, Manager — reading needs pos.catalog.read; creating or editing needs pos.catalog.manage. Where: Settings → POS Articles

An outlet's articles are the same records Outlets and catalog calls sale items — this screen is the full-profile door onto them, the same pattern Outlets already uses for the outlet itself. Three things live only here: a two-level category hierarchy that groups the terminal's item picker, the modifiers and variants an article offers, and each article's optional charge code, a reference into the accounting chart of accounts.

Create a category#

Categories are exactly two levels — a main group, and optionally sub groups under it. There is no third level: a sub group cannot itself be a parent.

1. Select Categories.
2. To add a main group, type its name under New main group and select Add.
3. To add a sub group, choose its parent main group, type the sub group's name, and select Add.

A sub group's parent must be a main group belonging to the same hotel as the sub group — picking one from another property is rejected.

Create an article#

1. Select New article.
2. Choose the outlet it sells from.
3. Name it as the guest reads it on the bill.
4. Type the price, in whole currency units, and the tax rate in basis points (1000 is 10% — the same trap outlets and catalog warns about).
5. Optionally choose a category — a main group, or one of its sub groups — so the item lands in the right section of the terminal's picker.
6. Optionally choose a charge code — the accounting article this sale posts against.
7. Select New article.

Penting

A charge code is a mapping for accounting, not a second tax rate. The article's own tax bps is still what the terminal charges the guest; the charge code only tells billing setup which chart-of-accounts line the revenue lands on. Point the two at different tax treatments and the check is still taxed by the article's own bps — the charge code's tax treatment plays no part in pricing today.

Modifiers and variants#

Open an article to edit it and you get two further sections. They look similar and they are not the same thing.

Variants — which one of it#

A variant is a version of the article the guest picks exactly one of: Small, Regular, Large.

Field	Example
Key	large
Name	Large
Price delta	The amount added to (or taken off) the article's price
Duration delta	Minutes added, for articles that occupy time

Modifiers — what else about it#

A modifier is an adjustment the guest can take any number of, grouped by what it is adjusting: a Doneness group holding Rare, Medium rare, Well done; an Extras group holding No ice, Extra shot.

Field	Example
Group	Doneness
Name	Medium rare
Price delta	The amount this option adds

The group name is what makes the terminal's picker readable — it is how the options get sorted into sensible boxes rather than one long list.

Catatan

Both lists are append-only. You add modifiers and variants; you do not edit or delete them here. That is deliberate rather than missing: a check line records the modifiers it was sold with, so editing one after the fact would rewrite what a guest was charged for. Supersede with a new option instead.

An article with either defined changes how it behaves at the terminal — see the terminal.

Prices are still frozen at the moment of sale#

Same rule as the quick-create screen: a check line snapshots its price when it's added and never re-reads the catalog afterwards. Editing an article here — its price, its category, its charge code — never rewrites a line already sitting on an open check. The same holds for the chosen modifiers: the line keeps the snapshot it was sold with.

How the terminal uses categories#

The item picker groups articles by category: a Main heading for items with no sub group, a Main › Sub heading for items with one, and an Other heading for anything with no category at all. Categorizing an article is what moves it out of Other.

What's next#

• Outlets — create the outlet an article belongs to, and edit its profile
• Happy hour pricing — a time-windowed adjustment layered on top of an article's price
• Billing setup — the charge codes an article can map to, and their own tax treatment
• The terminal — where a categorized catalog turns into a grouped picker