POS reason code troubleshooting
Goal
Fix frontline blocks and catalogue validation errors around reason codes.
Who it is for
Clerk and manager.
Common problems
| Symptom | Likely cause | What to do |
|---|---|---|
| A valid … reason code is required | Active codes exist for the context | Pick an active code or deactivate all to allow free-text mode |
| This … reason requires a note | Code has requires_note | Enter the note |
| Choose a reason to continue / drawer reason | Drawer open / void flow | Select reason in the prompt |
| Duplicate on save | Same code in same context | Change code or edit the existing row |
| Reason not listed on floor | Inactive or wrong context | Activate / fix context / sort order |
| Approval stuck | requires_approval + policy | Use manager override / approvals inbox |