Skip to main content

Consume Items

POST 
/api/items/consumeitems

Tier: Public — stable, supported for third-party integration.

Marks a set of items as consumed (written off), identified by item id and/or tag number.

Allowed from states Present, Missing, Moved, Cleared, Received, Returned, and Restored; disallowed from Consumed itself and from Allocated, Reserved, Dispatched, and OnLoan (active-order states). Null entries in ConsumeItemsDto.TagNumbers are filtered out server-side. Consumed items remain queryable — they are not deleted. Raises a SystemEventType.ItemUpdated notification and adjusts SkuPlaceStock.

Request​

Responses​

Returns a partial-success result — HTTP 200 even when some items fail. See Items.ConsumeItemsResultDto; an empty ItemsNotConsumed list means all items were consumed.