Skip to main content

7. Inventory, Spares & Procurement

Purpose — Stock across HQ, regional warehouses, dealer stock, and technician van stock; spare parts tied to service jobs; and procurement from upstream suppliers (the true "vendor" in the procurement sense — see Glossary).

Personas served​

Finance admin, Service head, Technician (van stock), Dealer (own stock), Super admin.

Key capabilities​

  • Multi-location stock — HQ, regional warehouses, dealer stock, technician van stock (v2).
  • Reservations & oversell prevention — concurrency-safe via Medusa inventory.
  • Spare-parts inventory tied to jobs — consume on job close, auto-reorder (FSM).
  • Batch / serial / lot tracking — feeds serial lifecycle (Warranty).
  • Min-max & reorder automation.
  • Procurement — supplier management, purchase orders, GRN (goods receipt).

Data owned​

Medusa (PG): inventory items, stock locations, reservations. Mongo / Finance (PG): Supplier, PurchaseOrder, GRN (procurement); van-stock ledgers. Spares mapping shared with Catalog.

Events​

  • Emits: inventory.changed, stock.low, po.received, supplier.part.updated.
  • Consumes: job.close (consume parts), order.placed (reserve), return.created (restock).

APIs​

  • Medusa inventory APIs via BFF.
  • POST /procurement/suppliers, POST /procurement/pos, POST /procurement/pos/:id/grn
  • GET /inventory/locations/:id/stock, POST /inventory/transfer (van stock)

Tenant-config knobs​

Warehouse/location list; reorder policy defaults; van-stock enabled flag; supplier categories.

Dependencies​

Orders, FSM, Catalog, Finance.

Open questions​

  • Depth of procurement (light PO/GRN vs full purchasing) per tenant — or defer to ERP integration?
  • Van-stock reconciliation cadence.