Return authorization lifecycle

Goal

Move an RMA through allowed statuses and understand stock effects.

Who it is for

return.manage.

Allowed transitions

From	To
requested	approved, rejected
approved	received
received	inspected
inspected	restocked, written_off, refunded, exchanged

Steps

1. Open the RMA.
2. Choose the next status from the available actions.
3. When moving to inspected, complete the inspect dialog (line inspection + restock decision).
4. When moving to restocked, BlueMatrix posts inventory inflows (REASON_CREDIT_RETURN) for lines with restock_decision = restock and an item, at line unit cost or item average cost — warehouse is required.
5. written_off / refunded / exchanged close the operational RMA without that restock posting (financial refund/exchange may still need a credit note or payment flow elsewhere).

Hard stops

• Illegal transition → returnTransitionNotAllowed.
• Restock without warehouse → returnNotInState('restockable (no warehouse)').

Result

Terminal commercial statuses end the RMA; restock updates on-hand stock.

Related

• Create
• Troubleshoot