Inventory
The Inventory resource provides a centralized view of stock levels across your fulfillment locations. Inventory records are automatically created and updated when you submit inventory events through the Inventory Events API.
Key Concepts
Stock Levels
Inventory in Carriyo tracks three types of stock quantities for each product at each location:
- On Hand : The total physical quantity of the product available at the location
- Reserved : The quantity that has been allocated to orders but not yet shipped
- Unavailable : The quantity that is not available for sale (e.g., damaged, expired)
The Available Quantity is calculated as: on_hand - reserved - unavailable
Location-Based Tracking
Inventory is tracked per product per location, allowing you to:
- Monitor stock levels across multiple warehouses or stores
- Allocate orders to locations with available inventory
- Enable store-to-door or ship-from-store fulfillment
Integration with Orders
When orders are created and allocated to fulfillment locations, Carriyo automatically reserves inventory. This ensures accurate available quantities are reflected in real-time.