Return orders — User Guide
Module: Purchase
Audience: Procurement staff, warehouse coordinators, accounts payable
Version: 1.0.0
Last updated: 2026-07-22
Overview
A return order documents goods you are sending back to a vendor against an existing purchase order. You record which PO lines are being returned, quantities and amounts, and track the return through approval, shipping, and refund stages. When the Warehouse module is enabled, an approved return can generate a stock export (delivery voucher) to remove items from inventory.
Access return orders from Purchase → Return orders. Vendors can view their returns in the vendor portal.
Prerequisites
| Role | Typical permissions |
|---|---|
| View return list | Purchase Order return → View |
| Create returns | Purchase Order return → Create |
| Record refunds | Purchase Order return → Edit |
| Delete returns (unapproved) | Purchase Order return → Delete |
| Change status manually | Administrator (via detail More menu) |
Configure return numbering and approval under Purchase → Settings (Order return tab and Approval process).
Step-by-step: View return orders
- Go to Purchase → Return orders.
- Use filters:
- From date and To date (defaults to the last 15 days)
- Vendor
- Status (Draft, Processing, Confirm, Shipping, Finish, and others)
- Click a return number to open the detail panel on the right (split view).
- Use the toggle icon to expand or collapse the preview pane.
Step-by-step: Create a return from a purchase order
- Go to Purchase → Return orders.
- Click New.
- Select the Purchase order you are returning against.
- The form fills vendor contact details, currency, return fee, and return policies from the vendor profile.
- Review line items loaded from the PO. Adjust Quantity, discounts, and Reason for return per line as needed.
- Enter a Return name and any Admin note or policy text.
- Click Submit to save as draft, or use Save and send request if approval is required.
Expected result: A new return order appears in the list with status Draft (or moves to approved automatically when no approval workflow is configured). The linked purchase order status changes to Return.
Step-by-step: Approve a return
When order-return approval is enabled in settings:
- Open the return from the list.
- Review the approval panel on the detail view.
- Approvers receive a notification and can approve or reject from the standard approval UI.
If approval is not configured, the return is approved automatically on creation.
Step-by-step: Process status and warehouse export
Typical progression:
- Draft — return created, editable.
- Processing / Confirm — under internal review.
- Shipping — goods being sent back to vendor.
- Finish — return completed.
Administrators can change status from the detail view More menu → Mark as {status}.
Warehouse export (when Warehouse module is active):
- After the return is approved, a stock-export icon appears on the list row.
- Click it and select the warehouse to create a delivery voucher (stock export).
- Use the eye icon on the row to open the linked warehouse document.
Step-by-step: Record a refund
When the return is in Confirm or Processing status and money is still owed back:
- Open the return detail.
- Click More → Refund (or open the Refunds tab).
- Enter refund amount, payment method, and date.
- Save.
Track remaining refundable balance on the refunds tab.
Step-by-step: PDF and delete
PDF: On the detail view, open the PDF menu → View, Download, or Print.
Delete: Available from the list row options when the return is not yet approved. Requires Delete permission.
Field reference (create form)
| Field | Required | Description |
|---|---|---|
| Purchase order | Yes | Source PO for the return |
| Order return number | Auto | System-generated from prefix and next number in settings |
| Return name | Yes | Descriptive title for the return |
| Vendor | Auto | From selected PO |
| Email / Phone | Auto | From vendor contacts |
| Return fee | No | Fee charged for the return (from vendor or global default) |
| Return policies | No | Policy text shown on documents |
| Line quantity | Yes | Quantity being returned per PO line |
| Reason for return | No | Per-line return reason |
Status reference
| Status | Meaning |
|---|---|
| Draft | Created, not yet finalized |
| Processing | Being reviewed or prepared |
| Confirm | Confirmed for return |
| Shipping | Goods in transit back to vendor |
| Finish | Return completed |
| Failed | Return could not be completed |
| Canceled | Return canceled |
| On hold | Paused pending resolution |
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Cannot delete return | Return already approved | Cancel or complete workflow; unapproved only |
| No warehouse export icon | Return not approved or Warehouse module off | Complete approval; activate Warehouse module |
| PO stuck in Return status | Created return against PO | Review PO and close return when finished |
| Approval email not sent | Save-and-send may not trigger on create | Resend approval manually from detail panel |
| Refund option missing | Wrong status or full amount already refunded | Move to Confirm/Processing; check Refunds tab |
| Edit not visible in list | Edit link hidden in UI | Contact admin or use direct edit URL if unapproved |