Inventory items
Inventory items
Inventory items are canonical records used for bookkeeping review, posting, and period-based reporting. The goal is that the register remains stable and audit-friendly while automation depends on deterministic identifiers and references.
Ownership
Owner: bus inventory. This module is responsible for implementing write operations for this object and is the only module that should directly change the canonical datasets for it.
Secondary read-only use cases are provided by these modules when they consume this object for validation, matching, posting, or reporting:
bus journal receives postings derived from inventory valuation decisions, and bus accounts provides inventory and COGS accounts referenced by item master data.
Actions
Add an inventory item registers items so stock movements reference stable identifiers. Value inventory computes as-of valuation output for review and posting decisions.
Properties
Core item fields are item_id, name, unit, valuation_method, and sku. Posting-account fields are inventory_account_id and cogs_account_id.
Relations
An inventory item belongs to the workspace’s accounting entity. Scope is derived from the workspace root directory rather than from a per-row key.
Inventory movements reference items via item_id so stock levels and valuation can be traced back to a stable item master record.
Inventory items reference ledger accounts via inventory_account_id and cogs_account_id so valuation and COGS postings can be produced consistently.