Create a POS terminal

Goal

Register a new terminal so cashiers can open sessions and sell.

Who it is for

Managers with pos.manage_terminals.

Preconditions

• Warehouse and cash/bank account exist.
• Optional: branch, default/walk-in customer party.

Steps

1. Terminals → New terminal.
2. Enter Code (max 32) and Name (translatable; default locale required).
3. Select Warehouse and Cash account (required).
4. Optional: Branch, Default / walk-in customer, Register type, Receipt paper size (80 mm / 58 mm thermal), Device binding (Trusted devices / Single device / Open).
5. Configure Payment methods rows: method (cash, card, gift_card, store_credit, customer_credit, other), enabled, deposit account, requires reference, change allowed.
6. Leave Active on → Save. Toast: Terminal saved.

Result

An active terminal appears on the list and in the POS app terminal picker.

Hard stops

• Validation 422 if code/name/warehouse/cash account missing or paper size / method not in allow-list.
• Selling later fails if warehouse missing on stock ops (terminal_without_warehouse).

Related

• Edit a terminal
• Setup
• Run a sale