commerce-inventory
Manage inventory counts, adjustments, and stock health. Use when running `stateset-inventory`, `stateset-direct inventory`, or checking low-stock and adjustments.
SKILL.mdskills/commerce-inventory/SKILL.md
GitHubCommerce Inventory
Track stock levels, reservations, and adjustments across locations.
How It Works
- Check stock and availability for SKUs across all locations.
- Adjust inventory with a reason code (
received,damaged,cycle_count,correction). - Reserve stock for pending orders to prevent overselling.
- Confirm reservations on fulfillment or release on cancellation.
- Report updated availability, low-stock signals, and reorder points.
Usage
- CLI:
stateset-inventory ...orstateset-direct inventory <action> - Writes require
--apply. - MCP tools:
get_stock,create_inventory_item,adjust_inventory,reserve_inventory,confirm_reservation,release_reservation.
Permissions
- Read:
get_stock— no--applyneeded. - Write:
create_inventory_item,adjust_inventory,reserve_inventory,confirm_reservation,release_reservation— requires--apply.
Examples
stateset inventory get-stock --sku WIDGET-001 --location loc_main
stateset inventory adjust --sku WIDGET-001 --qty 50 --reason received --apply
stateset inventory reserve --sku WIDGET-001 --qty 5 --order-id ord_456 --apply
stateset inventory release-reservation res_789 --apply
Status Flows
Reservation: Pending -> Confirmed (or Released/Expired)
Adjustment: Submitted -> Applied
Output
{"status":"adjusted","sku":"WIDGET-001","available":75,"reserved":10,"on_hand":85,"location_id":"loc_main"}
Present Results to User
- Updated stock levels (
available,reserved,on_hand) per location. - Any low-stock or reorder warnings with suggested quantities.
- Reason notes and adjustment amounts applied.
- Reservation IDs created or released.
Troubleshooting
- Insufficient stock: check reservations and
on_handcounts; release stale reservations. - Unknown SKU: ensure the product and inventory item exist via
create_inventory_item. - Negative available: reservations exceed on-hand; investigate and correct with adjustment.
- Location mismatch: verify the
location_idexists in commerce-warehouse.
Error Codes
INSUFFICIENT_STOCK: Available quantity is below the requested amount.UNKNOWN_SKU: No inventory item exists for the given SKU.RESERVATION_EXPIRED: Reservation timed out and was automatically released.
Related Skills
- commerce-warehouse — warehouse locations and bin management
- commerce-fulfillment — pick tasks consume reserved inventory
- commerce-products — product catalog linked to inventory items
- commerce-backorders — tracks unfulfilled demand when stock is zero
References
- references/inventory-commands.md
- /home/dom/stateset-icommerce/cli/.claude/skills/commerce-inventory/SKILL.md
- /home/dom/stateset-icommerce/examples/workflows.md