frontend

frontend / api/inventory/stockMutations / adjustQuantity

Function: adjustQuantity()

adjustQuantity(req): Promise<boolean>

Defined in: src/api/inventory/stockMutations.ts:50

Adjust item quantity by delta (purchase/correction style). Positive delta = purchase/inbound; negative = correction/outbound.

Parameters

req

AdjustQuantityRequest

Adjustment payload with item id, delta, and business reason

Returns

Promise<boolean>

true if successful, false otherwise

Enterprise

Server commonly exposes: PATCH /{id}/quantity?delta=&reason= Reasons typically map to business enums (PURCHASE, CORRECTION, WRITE_OFF, RETURN, etc.)

Example

// Record a purchase (inbound)
const success = await adjustQuantity({
  id: 'ITEM-123',
  delta: 50,
  reason: 'PURCHASE'
});

// Record a correction (outbound)
const corrected = await adjustQuantity({
  id: 'ITEM-123',
  delta: -5,
  reason: 'CORRECTION'
});