Returns troubleshooting
Goal
Unblock common RMA create and transition failures.
Who it is for
Clerk and admin.
Common problems
| Symptom | Likely cause | What to do |
|---|---|---|
| 422 on create | No lines or qty ≤ 0 | Add at least one line with quantity > 0 |
returnOutsideRmaWindow | Original date older than rma_window_days | Adjust date or widen window in setup |
| Cannot transition | Status not in allowed map / missing return.manage | Check current status and permissions |
| Restock fails / no warehouse | warehouse_id null on RMA | Create RMAs with a warehouse before restock |
| Expected auto-restock on receive | Setting stored but not auto-run by service | Explicitly transition to restocked after inspect |
| Confused with POS return | Different module/permissions | Use POS refund for till returns; RMA for commerce authorizations |