Inventory and receiving

Receive packages against manifests, record lab results, release for sale, and place or release holds.

Receiving

/dashboard/platform/receiving receives packages against transfer manifests. receiveCannabisPackage needs canManageInventory and the inventory activity.

FieldNotes
ProductAn active product at this premises
Package UIDUnique; reuse is refused
Production batch, lot, label versionRequired
QuantityPositive integer in microunits
ExpiryCalendar date (YYYY-MM-DD), interpreted in the premises timezone
Manifest number, source licenseRequired
Regulator manifest ID, lab name, lab result reference, manufactured dateOptional

The command creates a RegulatedManifest in receiving_hold, an InventoryPackage with status receiving_hold and testStatus: unknown, and a receive InventoryEvent. Evidence is stored with origin: manual_entry_unverified.

Inventory

/dashboard/platform/inventory shows stock and custody history per package.

Package statuses

expected_inbound, receiving_hold, quarantined, saleable, reserved, staged, transfer_allocated, in_transit, waste_pending, recalled, depleted, destroyed.

Actions on a package

ActionMutationNotes
Record lab resultrecordPackageLabResultResult such as passed; needs COA reference and label version
Release for salereleaseCannabisPackageRequires passed test, COA, label version, unexpired date and no active holds
Place a holdplacePackageHoldType: quarantine, test_hold, recall, discrepancy, authority, expiry
Release a holdreleasePackageHoldSecond compliance approver

A package is saleable only after release. Packages are chosen for carts by the server, not by the cashier.

Custody ledger

Every change appends an InventoryEvent with quantity before, after and delta. Event types: receive, release, reserve, release_reservation, sale, return_quarantine, transfer_out, transfer_in, count, adjustment, waste, destruction, recall_hold, recall_release. The ledger is append-only.

postCannabisInventoryEvent (transfers, waste, destruction, counts, adjustments) is registered but closed by runtime capability.

On this page