frontend

frontend / api/inventory/itemMutations / deleteItem

Function: deleteItem()

deleteItem(id, reason): Promise<UpsertItemResponse>

Defined in: src/api/inventory/itemMutations.ts:120

Delete an inventory item by ID. Item can only be deleted if quantity is 0 (no stock remaining). Only ADMIN users can delete items.

Parameters

id

string

Item identifier to delete

reason

string

Business reason for deletion (SCRAPPED, DESTROYED, DAMAGED, EXPIRED, LOST, RETURNED_TO_SUPPLIER)

Returns

Promise<UpsertItemResponse>

Response object with ok status and optional error message

Note

ADMIN-only operation

Note

Backend validates that item quantity is 0 before deletion

Note

Backend may return error: "You still have merchandise in stock"

Example

const result = await deleteItem('ITEM-123', 'EXPIRED');
if (!result.ok) {
  console.error('Deletion failed:', result.error);
}