Developer docs

Adjust Stock

Use absolute stock values when adjusting stock. Manual and error reasons require a note.

PATCH /api/v1/skus/{id}

{
  "on_hand": 12,
  "reason": "manual",
  "note": "Postman smoke test manual stock adjustment.",
  "reference": "POSTMAN-MANUAL-001"
}

Bulk adjustment

POST /api/v1/stock-adjustments/bulk

{
  "reason": "manual",
  "note": "Stock correction after count.",
  "reference": "COUNT-001",
  "lines": [
    { "type": "sku", "id": 123, "new_qty": 25 }
  ]
}

Supplier items linked to SKUs should not be adjusted directly.