mirror/TimeTracker
1
0
Fork 0
mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-05-18 04:08:48 -05:00
Code Issues Packages Projects Releases Wiki Activity

docs(inventory): document return/waste devaluation usage (#385)

Browse Source 
- In section 5.3 Stock Devaluation: note form message when item does not
  support devaluation.
- Add 'How to use (UI)' steps for return and waste with devaluation.
- Add API note for POST /api/v1/inventory/movements devaluation parameters.
- Enables closing GitHub issue #385 with a doc reference.
This commit is contained in:
Dries Peeters
2026-03-12 21:38:24 +01:00
parent 3b020e6c05
commit e435e6ad31
1 changed files with 7 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/INVENTORY_MANAGEMENT_PLAN.md
+7 -1
View File
@@ -460,7 +460,13 @@ Stock can be devalued when recording **return** or **waste** movements so that i
- The system first revalues that quantity into a devalued lot (FIFO consume from existing lots, create a devalued lot at the new cost), then records the waste movement consuming from that devalued lot.
- Use this when writing off damaged or obsolete stock at a lower value for accounting.
**Requirements**: The stock item must be **trackable** and have a **default cost** set. Devaluation options are available on the Record Movement form when movement type is Return, Waste, or Devaluation (standalone revaluation of quantity in place).
**Requirements**: The stock item must be **trackable** and have a **default cost** set. Devaluation options are available on the Record Movement form when movement type is Return, Waste, or Devaluation (standalone revaluation of quantity in place). If the selected item is not trackable or has no default cost, the form shows a message and disables the "Apply devaluation" option.
**How to use (UI)**:
- **Return with devaluation**: Go to Inventory → Stock Movements → Record Movement. Choose movement type **Return**, select the stock item and warehouse, enter a **positive** quantity. Check **Apply devaluation**, then set either a percent off default cost or a fixed new unit cost. Submit. The returned quantity is booked into a devalued lot at that cost; no new stock item is created.
- **Waste with devaluation**: Same form; choose movement type **Waste**, enter a **negative** quantity. Check **Apply devaluation** and set the devalued cost. Submit. The system revalues that quantity into a devalued lot, then records the waste from that lot.
**API**: `POST /api/v1/inventory/movements` accepts `devalue_enabled`, `devalue_method` (`"percent"` or `"fixed"`), `devalue_percent`, and `devalue_unit_cost` for return and waste movements. See the endpoint implementation for validation rules.
---