Materials Inventory

Covers the materials inventory ledger (every movement of raw materials in/out/between locations) and the derived summary view (current stock by material × location). Most ledger entries are written automatically by PO receipts (RECEIVE) and WO operations (CONSUME); direct ledger writes are used for manual transfers, adjustments, and disposals.

Writes

1. Create transfer between locations — Triggered from the Materials Inventory Transfers page → "New transfer". Writes a paired ledger entry (auto-generates a TFR-MI-xxx ref) representing material moving from one location to another. The receiving leg is recorded when the transfer is marked complete.
2. Complete in-transit transfer — Triggered from the Materials Inventory Transfers page → "Mark complete" on an in-transit row. Writes the matching RECEIVE ledger entry sharing the transfer's ref, closing the transfer.
3. Adjust inventory — Triggered from the Materials Inventory page → "Adjust". Writes an ADJUST ledger entry to correct on-hand quantities (no ref).
4. Dispose inventory — Triggered from the Materials Inventory page → "Dispose". Writes a DISPOSE ledger entry to remove inventory permanently (no ref).

Indirect writes — RECEIVE entries from PO receipts, ALLOCATE/CONSUME entries from WO operations — are described under Purchase Orders and Work Orders. They use the same ledger endpoint internally.

Reads

1. Get materials inventory summary — Triggered from the Materials Inventory page (default view). Returns current on-hand quantities per material × location, computed from the ledger.
2. List ledger entries — Triggered from the Materials Inventory Ledger page and the Materials Inventory Transfers page. Returns ledger entries, optionally filtered by material, location, event type, date range, or ref (e.g., TFR-MI-% to find transfers).
3. Get ledger entry detail — Triggered by clicking a ledger row. Returns a single ledger entry with its full source context.