寄貨

又稱：寄存商品 · 寄放商品 · stored items

客戶已購買但尚未取走、暫時寄放在店家的商品；取貨前不扣店家庫存、客戶帳上記為「待取」。

完整定義

寄貨（Stored Items）指客戶結帳當下已購買、但因攜帶不便或包裝待調等原因留在店家保管的商品。在取貨之前，商品物理上仍在店家手上，但所有權已屬客戶。會計處理：客戶帳上記錄已購買金額（業績認列）、店家庫存暫不扣（避免帳實不符）、取貨日才執行實質出庫。支援部分取貨（例：購買 6 瓶取走 4 瓶，剩 2 瓶仍寄存）。

為什麼存在這個概念

美業店家常賣客戶帶走的洗髮精、面膜、保養品。客戶有時購買大量帶不走、或想等下次再領、或還想試試別款再決定。沒有寄貨概念的系統會逼客戶現場拿走（不便）或推延到取貨才結帳（影響當月業績認列、影響庫存對帳）。寄貨制度兩邊兼顧：認帳當下完成、出庫等到實際領貨。

美業棧如何處理

`storedItems` subcollection 記錄每筆寄存：購買日、treatment 連結、產品 ID、購買數量、已取數量。**庫存只在取貨時扣**（透過 `pickupStoredItem` 統一進入庫存交易）。Cascade 邏輯：刪除 treatment 時 pending 寄貨自動同步刪；已取貨則保留歷史。客戶頁可依「待取／已取」分類查詢。

具體例子

客戶購買 6 瓶洗髮精 NT$3,000（業績當天認列）。當下取走 4 瓶、寄放 2 瓶。庫存：扣 4 瓶。`storedItems` 紀錄：剩 2 瓶 status=pending。3 週後客戶回來取走 1 瓶 → 庫存再扣 1、`storedItems` 紀錄更新為已取 5、剩 1 pending；再 1 個月後取完最後 1 瓶 → status=picked_up（歷史保留）。