Athenian Returns & RMA Manager
product details.
Athenian Returns & RMA Manager adds customer self-service return requests and admin RMA workflows for return status, labels, refunds, restocking, and communication. It helps teams turn post-purchase issues into trackable return cases connected to orders, items, refunds, and inventory outcomes while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Returns Manager is a WooCommerce-native returns and RMA operations plugin that gives store teams a structured way to receive, review, approve, process, refund, restock, and close customer return requests.
The plugin adds a customer-facing Returns area inside WooCommerce My Account where eligible customers can select an order, choose line items and quantities to return, provide reasons and notes, and submit a return request. Each request becomes a dedicated ath_rma record tied back to the original WooCommerce order, customer, and order line items.
For admins, Athenian Returns Manager creates an operational RMA workspace for reviewing return requests, changing statuses, attaching PDF labels, sending customer emails, calculating refund previews, creating WooCommerce refunds, and restocking sellable returned items. Instead of managing returns across support emails, carrier portals, warehouse notes, and manual refund calculations, the plugin centralizes the return lifecycle directly inside WooCommerce.
Within the broader Athenian Platform, Returns Manager fits as the post-purchase return-management counterpart to order fulfillment, shipment management, customer service tooling, order resolution, store credits, vendor routing, and operational analytics.
How Athenian Returns & RMA Manager fits the Athenian Platform
Platform role: Athenian Returns & RMA Manager is a focused capability in the Cart, Checkout & Customer Service and Fulfillment, Shipping & Production Operations layer. Its primary scope covers Fulfillment Status & Warehouse Ops and Order Self-Service & Support while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Returns & RMA Manager is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Customer Return Requests
Add a Structured Returns Portal to WooCommerce My Account
Athenian Returns Manager gives customers a self-service Returns area where
they can choose eligible orders, select the exact items and quantities they
want to return, enter reasons, and submit an RMA request tied to real
WooCommerce order data.
| Returns Surface | Customer Workflow Value |
|---|---|
| My Account Endpoint | Adds a customer-facing Returns area through the athenian-returns WooCommerce account endpoint. |
| Eligible Orders | Lists returnable orders based on configurable return-window days and allowed WooCommerce order statuses. |
| Item-Level Selection | Allows customers to select returned line items, quantities, sellable state, reasons, and optional notes. |
| Dedicated RMA Record | Creates an ath_rma record connected to the original order, customer, and returned item payload. |
- Registers the private admin-facing post type
ath_rma. - Stores core RMA metadata such as
_ath_rma_id,_ath_rma_order_id,_ath_rma_user_id, and_ath_rma_items. - Supports default eligibility for recent
completedandprocessingWooCommerce orders. - Adds WooCommerce order notes when customers submit return requests, keeping order history and RMA history connected.
Return Operations
Give Support and Warehouse Teams a Dedicated RMA Review Workspace
Store teams can review RMAs, approve or reject requests, upload PDF labels,
send customer emails, move returns through operational statuses, and keep
label, customer, order, and return-state details attached to one record.
Track returns from requested through approved, label sent, received, closed, or rejected
Upload PDF labels or attach detected Octolize label candidates
Send configurable customer return emails with placeholders and label attachments
| Admin Layer | Operational Purpose |
|---|---|
| RMA Statuses | Registers return states such as ath_rma_requested, ath_rma_approved, ath_rma_label_sent, ath_rma_in_transit, ath_rma_received, ath_rma_closed, and ath_rma_rejected. |
| Admin Actions | Supports review actions such as approve, mark in transit, mark received, close, send customer email, restock now, upload label, and create refund. |
| Label Storage | Stores uploaded PDF labels in a dedicated hardened upload folder and saves label path, URL, and source metadata on the RMA. |
| Order Integration | Adds WooCommerce order actions and metaboxes so admins can create RMAs from orders and navigate between orders and linked returns. |
- Stores label metadata such as
_ath_rma_label_path,_ath_rma_label_url, and_ath_rma_label_source. - Supports email placeholders such as
{rma_id},{order_id},{customer_name},{site_name},{refund_id}, and{refund_amount}. - Includes optional Octolize label discovery through the
ath_rma_octolize_label_meta_keysfilter. - Uses nonce and capability checks for admin status changes, label upload, email sending, restocking, and refund creation.
Refund & Inventory Handling
Calculate Refunds From Original Order Lines and Restock Only Sellable Returns
Returns Manager keeps refunding and restocking separate. Refund previews
are calculated from the original WooCommerce order items, while restock
behavior is driven by return receipt, sellable flags, global settings, and
per-RMA restock policy.
| Post-Return Layer | How It Helps |
|---|---|
| Refund Preview | Computes refund amounts from original order item IDs, purchased quantities, line totals, and taxes rather than current product prices. |
| Partial Quantity Refunds | Supports partial returns by pro-rating line totals and taxes while checking already-refunded quantities to reduce over-refund risk. |
| WooCommerce Refunds | Creates refunds through wc_create_refund() and stores refund ID, amount, and creation timestamp on the RMA. |
| Restock Policy | Restocks only sellable returned items when policy allows, using global settings and per-RMA values such as inherit, force yes, or force no. |
Order-aware return handling:
every return stays connected to the original WooCommerce order, customer,
line items, label file, refund record, restock decision, and return status
so support, warehouse, and accounting teams can work from one source of truth.
- Stores refund metadata such as
_ath_rma_refund_id,_ath_rma_refund_amount, and_ath_rma_refund_created_gmt. - Uses the
ath_rma_refund_payloadfilter so shipping, fee, or policy-specific refund adjustments can be added later. - Fires
ath_rma_restocked_itemafter eligible items are restocked through the RMA workflow. - Declares WooCommerce HPOS compatibility and builds toward AJAX return forms, customer RMA detail pages, guest return lookup, direct carrier labels, inbound tracking, store-credit refunds, Shipment Manager integration, Order Resolution integration, and Data Intelligence reporting.