Inventory
View stock levels and adjust or transfer inventory between warehouses. All adjustments are recorded as stock movements for a full audit trail.
Endpoints
GET/inventoryList stock levels
POST/inventory/adjustAdjust stock quantity
POST/inventory/transferTransfer between warehouses
List inventory - GET /inventory
| Parameter | Description |
|---|---|
| warehouse_id | Filter by specific warehouse |
| low_stock | Only show items with quantity < 10 |
| page, per_page | Pagination |
Adjust stock - POST /inventory/adjust
Set the absolute quantity for a product in a warehouse. This records a stock movement with type 'adjustment'.
| Field | Type | Required |
|---|---|---|
| product_id | UUID | required |
| quantity | Number | required |
| warehouse_id | UUID | optional |
| reason | String | optional |
POST /inventory/adjust
{
"product_id": "a1b2c3d4-...",
"quantity": 250,
"warehouse_id": "wh-uuid",
"reason": "Restocked from supplier order #PO-144"
}Transfer stock - POST /inventory/transfer
Move stock between warehouses. Validates sufficient source quantity before transferring.
| Field | Type | Required |
|---|---|---|
| product_id | UUID | required |
| from_warehouse_id | UUID | required |
| to_warehouse_id | UUID | required |
| quantity | Number | required |