spree-returns

Installation
SKILL.md

Spree Returns, Exchanges & Claims

Three separate records, each with its own lifecycle, all hanging off a placed Spree::Order:

Record Prefix / number What happened Outcome
Spree::Return ret_ / RET… Customer sends items back Money back
Spree::Exchange exch_ / EX… Customer sends items back Different items (price difference settled)
Spree::Claim claim_ / CLM… Arrived damaged, never arrived, wrong item Refund, replacement, or both — goods usually not returned

Keep them apart: don't model "arrived smashed" as a return you immediately mark received — use a claim, so damage is reportable. Coming from 5.x (ReturnAuthorization → CustomerReturn → Reimbursement, ReturnItem)? Those are gone; see spree-upgrade-5-to-6.

Models

Installs
19
GitHub Stars
10
First Seen
Oct 1, 2026