Returns

GMP rule baked in: returned goods NEVER go straight back to sellable stock. Every return is received into the Quarantine bin with its lot number; QA decides the disposition — Restock (unopened outer packaging only), or Destroy. Credit notes live in QuickBooks; Gaia stores the reference.

6 returns · YTD value 4,262.40 MYR

Return #	Date	Customer	Source	Items · lot	Reason	Value	Disposition	Credit note	Status
						MYR

Project Gaia — static mockup in Filament v3 idiom. No backend. Returns are illustrative; SO/shipment references follow the real numbering series.

Return

RET-26-009 — Yes Global

Not saved

Receipt posts a return_receipt movement into Quarantine — never sellable stock. Lot capture is mandatory on every line; returns feed batch-trace (mock recall covers returned goods).

Customer *

Source sales order

Scopes shipments + lines.

Shipment

Auto-fills lines and lots from the packing list.

Reason

Photos

Lines

Lots limited to those on the selected shipment.

Received into: Quarantine bin — CYTO-11 (locked)

Disposition: — QA decides Restock / Destroy after inspection

Credit note

Returns — field manifest

Field	Filament component	Type	Source	FK target
Return #	TextColumn (series RET-{yy}-{seq})	string	stored: returns.code	—
Customer / Source	TextColumn::url()	FK	stored: returns.customer_id, .sales_order_id / .shipment_id	sales_orders / shipments
Items · lot	Repeater lines	relation	stored: return_lines (variant_id, qty, batch_id REQUIRED)	variants / batches
Reason	Select + free text	enum + text	stored: returns.reason	—
Disposition	Badge + QA Action per line	enum	Quarantine (default on receipt) → Restock / Destroy, decided by QA role	—
Credit note	TextColumn	string ref	stored: returns.qbo_credit_note_ref — the money side stays in QuickBooks	—
Status	Badge	enum	Received → Inspecting → Closed	—

Engine notes

Receipt posts a return_receipt movement into the Quarantine bin — never sellable stock. Restock disposition posts a bin transfer + COGS reversal; Destroy posts a write-off movement.
Lot capture is mandatory on every return line — returns feed the same batch-trace screen (mock-recall covers returned goods too).
A return referencing a shipment auto-fills its lines and lots from the packing list.