← All types
Ob Object

WarehouseLocationState

A warehouse location (warehouse, zone, aisle, rack, shelf, bin, etc.)

Fields

TypeID of this warehouse location (prefix "wlc", e.g. "wlc_01K…").

TypeID ("wlc") of the enclosing location, forming the storage hierarchy (e.g. a bin's parent shelf). Null for a top-level location such as a whole warehouse. A location can never be its own parent.

name

String!Non-null

Human-readable name of the location. Never empty.

code

StringNullable

Short operator-facing code for the location (e.g. a barcode/label such as "A-01-03"). Unique per tenant when set; null when the location has no code.

Kind of location, which fixes its role in the storage hierarchy.

Possible values (11)
WAREHOUSE

The top of the storage hierarchy: a whole site or building, normally parentless, with every other location hanging beneath it. Also the type a location takes when none is supplied.

ZONE

A named area inside a warehouse — the first subdivision below the site, and the usual parent of aisles.

AISLE

A gangway running between racking within a zone; groups the racks along it, and sits one level above RACK.

RACK

A single racking bay or shelving unit standing in an aisle; the parent of the individual shelves it is divided into.

SHELF

One horizontal level within a rack — the smallest location that still holds several bins.

BIN

The finest-grained location: a single pick face, box or tote on a shelf. The leaf of the storage hierarchy, with nothing nested below it.

STAGING

A holding area outside the rack hierarchy where stock waits between operations — marshalled for a job, or landed but not yet put away.

GOODS_IN

The receiving dock. Inbound deliveries are booked in here (a RECEIVED movement) before being transferred into the rack hierarchy.

GOODS_OUT

The dispatch area. Picked stock is moved here to wait for the carrier, and leaves the site from here (a SHIPPED movement).

QUARANTINE

A segregated area holding stock that must not be issued — awaiting inspection, or failed. Kept off the normal hierarchy so it is not picked by accident.

PRODUCTION

Point-of-use storage on the shop floor rather than in the warehouse; material issued to a job lands here (an ISSUED_TO_PRODUCTION movement).

Free-text notes about the location; null when none were supplied.

Weight capacity of the location, in the tenant's configured weight unit. Null means no weight limit is recorded. Advisory: it is not enforced when stock is placed here.

Volume capacity of the location, in the tenant's configured volume unit. Null means no volume limit is recorded. Advisory: it is not enforced when stock is placed here.

Whether the location is currently in use. Inactive locations are retained for history but should not be offered for new putaway or transfers.

sortOrder

Int!Non-null

Manual ordering hint for displaying sibling locations; lower values come first. Defaults to 0.

ISO-8601 timestamp of when the location record was created.

ISO-8601 timestamp of the last change to the location record; equal to createdAt until it is first updated.

Referenced by (3)
Exact type SDL
"""A warehouse location (warehouse, zone, aisle, rack, shelf, bin, etc.)"""
type WarehouseLocationState @iac_resource(name: "warehouse_location") @iac_ops(create: "createWarehouseLocation", read: "getWarehouseLocation", update: "updateWarehouseLocation", delete: "deleteWarehouseLocation") {
  """TypeID of this warehouse location (prefix "wlc", e.g. "wlc_01K…")."""
  id: WarehouseLocationID! @iac_identity(assignedBy: SERVER) @iac_computed
  """
  TypeID ("wlc") of the enclosing location, forming the storage hierarchy (e.g. a bin's parent shelf). Null for a top-level location such as a whole warehouse. A location can never be its own parent.
  """
  parentId: WarehouseLocationID @iac_ref(resource: "warehouse_location")
  """Human-readable name of the location. Never empty."""
  name: String!
  """
  Short operator-facing code for the location (e.g. a barcode/label such as "A-01-03"). Unique per tenant when set; null when the location has no code.
  """
  code: String
  """Kind of location, which fixes its role in the storage hierarchy."""
  locationType: WarehouseLocationType!
  """Free-text notes about the location; null when none were supplied."""
  description: String
  """
  Weight capacity of the location, in the tenant's configured weight unit. Null means no weight limit is recorded. Advisory: it is not enforced when stock is placed here.
  """
  maxWeight: Float
  """
  Volume capacity of the location, in the tenant's configured volume unit. Null means no volume limit is recorded. Advisory: it is not enforced when stock is placed here.
  """
  maxVolume: Float
  """
  Whether the location is currently in use. Inactive locations are retained for history but should not be offered for new putaway or transfers.
  """
  isActive: Boolean!
  """
  Manual ordering hint for displaying sibling locations; lower values come first. Defaults to 0.
  """
  sortOrder: Int!
  """ISO-8601 timestamp of when the location record was created."""
  createdAt: String! @iac_computed
  """
  ISO-8601 timestamp of the last change to the location record; equal to createdAt until it is first updated.
  """
  updatedAt: String! @iac_computed
}