When a returned item is received at the warehouse and inspected, capture the condition grade (e.g., new/unopened, like-new, damaged, unsellable) via the WMS receiving or RMA API; store the condition code against the return record.
Define disposition rules in your returns management system mapping condition codes and product attributes (category, cost, margin, age) to disposition outcomes: restock-as-new, refurb-and-relist, liquidate via B2B channel, donate, or scrap.
Trigger disposition actions programmatically: for restock, call the WMS inventory-add API to return the item to sellable locations; for refurb, create a work order in your repair system and place the item in a quarantine location.
For liquidation, push item records (SKU, quantity, condition, cost) to your liquidation channel's API (bulk marketplace or B2B liquidator) and receive a settlement price confirmation.
Update the original return record and RMA with the disposition outcome and the unit's final resolution location or channel; use this data to calculate net return cost (refund amount minus recovery value).
Report on disposition outcomes by SKU and category over rolling windows to identify products with high return rates or poor recovery values; use this data to inform product quality, packaging, or policy decisions.
Known gotchas
Condition grading at the warehouse must be standardized and consistently applied; vague or inconsistently used condition codes produce unreliable disposition triggers and financial reporting.
Do not issue customer refunds before confirming the item's condition — automating refunds on receipt without inspection can result in refunding items that are counterfeit, abused, or outside return policy.
Liquidation channel APIs vary widely by platform; build the liquidation push as a modular step so the channel can be swapped (e.g., from one liquidator to a recommerce marketplace) without reworking the core disposition logic.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp