Warehouses & Stock

GreenVee tracks physical inventory through Warehouses, Stock, and Stock Movements. Together they answer two questions: “where is this stored?” and “how many do we have on hand right now?”

Warehouse

A Warehouse is a physical storage location. Today a Warehouse is a simple named location — its only field is:

Field	What it means
Title	The warehouse’s name

Stock

Stock links a Variant to a Warehouse — it is the record that says “this product is (or can be) held at this location.” Stock does not store a quantity field of its own; the on-hand quantity for a Variant is always calculated from its Stock Movements (see below).

Note

Stock levels only make sense for Variants that have Stock Tracking Enabled turned on. See Goods Catalogue for that flag.

Stock Movement

A Stock Movement is a single recorded change to a Variant’s inventory. Every time material arrives or leaves, a Stock Movement is created.

Field	What it means
Kind	Inbound (stock increases) or Outbound (stock decreases)
State	Pending, Fulfilled, or Cancelled — where this movement is in its own lifecycle
Quantity	How many units moved
Description	A note explaining why the movement happened
Occurred Date	When the physical movement took place
Tracking ID	Optional reference number for the movement (e.g. a delivery note or tracking number)
Variant	Which product this movement affects

The current on-hand quantity for a Variant is simply the sum of all its Inbound movement quantities minus the sum of all its Outbound movement quantities.

For Field Workers

When goods physically arrive, record an Inbound Stock Movement against the Variant. When goods leave (used on a task, dispatched, or returned to a supplier), record an Outbound movement. You do this directly from the Variant’s page in the Goods Catalogue.

Caution

Outbound movements reduce available stock. If you record an outbound movement that takes stock below zero, the system will reflect a negative balance. Always verify quantities before confirming outbound movements.

How it fits together

Variant (Steel Pipe DN100)
  ├── Stock Movement: Inbound, qty 50 — delivery from supplier
  ├── Stock Movement: Inbound, qty 20 — delivery from supplier
  └── Stock Movement: Outbound, qty 30 — consumed on a task
        On-hand quantity = 50 + 20 − 30 = 40

When a Purchase is accepted, the accepted quantity generates an inbound Stock Movement, increasing on-hand stock for that Variant. When a Good Usage consumes material from stock, it corresponds to an outbound Stock Movement.

Quick reference

Situation	Use
Checking current quantity on hand	Sum of Stock Movements for the Variant
Recording a delivery arriving	Stock Movement — Inbound
Recording material leaving the warehouse	Stock Movement — Outbound
Investigating an unexpected stock change	Stock Movement history for the Variant