Skip to content

v1.24.0: returns, RMA, and exchanges

Choose a tag to compare

View all tags
@mhightower932 mhightower932 released this 19 Jun 03:33
v1.24.0
0285e3e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

"Returns, RMA, and exchanges" release. The post-fulfillment arc, end to end -- and the release that completes the fork-to-OSS migration.

A sale can now spawn typed child orders: a replacement or exchange outbound, a goods-in RMA to receive returned stock against, and a credit-memo refund -- each numbered off and linked to its original.

Mobile. Zero mobile/ diffs on this release. The current mobile build (version 1.19.0, versionCode 9) remains current; no new APK for v1.24.0.

Added

  • Post-fulfillment order types and numbering (#407): sales_orders.order_type admits replacement / exchange / return alongside sale / refund / backorder. A post-fulfillment child takes a readable so_number off its original (<orig>-REPLACEMENT / -EXCHANGE / -RMA / -REFUND, suffixed -N for repeats) and links back via parent_so_id and, per line, original_so_line_id.
  • RMA goods-in (#407): create_rma mints the return SO; POST /api/admin/sales-orders/<so_id>/receive-return books a line into a disposition bin (a sellable bin restocks, a defective bin quarantines), advances the RMA status, and emits return.received/1. The receive is idempotent on a handheld-supplied key. A tabbed Returns admin page (RMA + Refunds) fronts the flow.
  • POS returns (#407): POS checkout in replacement / exchange mode mints the typed child off an attached original (an exchange also auto-creates the <orig>-RMA for the returned goods); refund accepts a line subset for partial refunds (a full refund still cancels the original); a POS sales-order lookup and a reference-order ingest (for an original that lives only in an upstream source system) support the attach-order flow.

Migrations

  • 070 (#407) -- sales_orders.order_type CHECK expands to include replacement, exchange, return.
  • 071 (#407) -- sales_order_lines.original_so_line_id links a post-fulfillment child line to the original line it derives from (NULL on ordinary lines).
  • 072 (#407) -- item_receipts can book against a return SO (nullable so_id / so_line_id); sales_order_lines.quantity_received tracks per-line return receipts.
  • 073 (#407) -- sales_orders.so_number widens to VARCHAR(128) so the longest suffixed child numbers fit.
Assets 2
Loading