Returns

What this is & why it matters

When a customer sends goods back, you record it as a Return Request against a delivered order. A return can be full (every item) or partial (specific items and quantities), and when it completes the items are put back into stock.

Step by step: submit a return

Open the delivered order (from Orders at /admin/orders) and start a Return Request, or go to Return Requests (/admin/return-requests).
Choose the Return type: full or partial.
Add the Items to return (at least one). For each, pick the order item and the quantity (1 to 9,999). The quantity is per line and must belong to this order.
(Optional) Add a Reason (up to 1000 characters).
Submit. The return starts at pending.

Field reference

Field	Meaning	Required?	Rules
Return type	Full or partial	Required	`full` or `partial`
Items	Order lines being returned	Required	At least 1, each from this order
Item quantity	Units returned on that line	Required	1 to 9,999
Reason	Why it’s being returned	Optional	Up to 1000 chars

Lifecycle — what to expect

pending — submitted, awaiting review.
approved / rejected
processing
completed — items are restocked.

Other states:

cancelled — if the request is withdrawn.

When all items of an order are returned, the order itself becomes returned.

Tips & common mistakes

Returns only after delivery. You cannot return an order that hasn’t reached delivered.
Submit within the return window. A return must be submitted within the return window — by default 14 days from delivery (admin-configurable via returns.return_window_days). After it passes, the request is rejected.
Quantities can’t exceed what was delivered on that line.
Stock comes back only at completed. A pending or approved return hasn’t restocked anything yet.

Where to look

Screen: Return Requests at /admin/return-requests. Open a request to track its status.

Creating Orders — the order must be delivered first.
Wallet & Withdrawals — how refunds touch your wallet.
Client / Merchant role — return permissions.