Create a POS reason code

Goal

Add a reason cashiers must select for a given exception context.

Who it is for

Managers with pos.admin.configure_register.

Preconditions

• Know which context the reason belongs to.

Steps

1. Reason Codes → New reason code.
2. Choose Context (void, discount, price override, no-sale, drawer open, refund, return, cancel).
3. Enter Code (max 64, unique per context) and Name (translatable).
4. Toggle Requires note, Requires approval, Active; set Sort order (≥ 0).
5. Save → Reason code saved.

Result

Active codes for that context become mandatory on matching frontline/API actions.

Hard stops

• Duplicate code/context → A reason code with this code already exists for this context.

Related

• Edit
• Setup