Location

A Location is anywhere stock can be: a warehouse, a zone within a warehouse, a vehicle, a customer site, or a virtual location (e.g. "in transit", "lost").

Field	Type	Notes
id	integer	Stockaj internal id
kind	enum	WAREHOUSE, ZONE, VEHICLE, CUSTOMER_SITE, VIRTUAL
sgln	string	Serialized GLN URI
parent_id	integer	For hierarchical locations (warehouse → zone → bin)
address	object	eCH-0010 compatible postal address
party_id	integer	Owning/hosting party (e.g. customer site)

Hierarchy

A typical festival tenant looks like:

Main warehouse              (kind=WAREHOUSE, GLN: 9506000.00001)
├── Stage A                 (kind=ZONE,      SGLN: ...zoneA)
├── Stage B                 (kind=ZONE,      SGLN: ...zoneB)
├── Backstage               (kind=ZONE,      SGLN: ...backstage)
└── Production van          (kind=VEHICLE,   SGLN: ...van01)

Virtual locations

Stockaj uses virtual locations for stock that has left physical control:

• urn:stockaj:location:virtual:in_transit
• urn:stockaj:location:virtual:lost
• urn:stockaj:location:virtual:disposed