Inventory API
Endpoints for managing items, warehouses, lots, stock balances, and movements. All endpoints require authentication and appropriate permissions.
RESTJWTPAGINATED
Base URL
Base
https://api.rona-erp.com/stock
Endpoints
GET/stock
List stock balances with filtering and pagination.
inventory.stock.read
GET/stock/movements
List stock movements with filtering and pagination.
inventory.movement.read
GET/stock/items/:itemId/on-hand
Get the on-hand quantity for a specific item.
inventory.stock.read
POST/stock/receive
Receive stock into a warehouse — creates new lots in quarantine status.
inventory.stock.receive
POST/stock/issue
Issue stock from a warehouse — decreases the balance.
inventory.stock.issue
POST/stock/transfer
Transfer stock between locations or warehouses.
inventory.stock.transfer
POST/stock/adjust
Adjust stock for corrections — requires a reason.
inventory.stock.adjust
POST/stock/return
Return stock to inventory — increases the balance.
inventory.stock.return
Example — receive stock
POST /stock/receive
{
"itemId": "item-123",
"lotNumber": "LOT-2026-001",
"quantity": 500,
"locationId": "loc-main-01",
"supplier": "Ethio Grain",
"manufactureDate": "2026-01-10",
"expiryDate": "2026-07-10"
}The created lot starts in QUARANTINED status — run a quality inspection before it can be consumed.