Skip to content

Stock Status

Stock Status

Each Stock Item has a status attribute, which serves to identify the current condition of the individual stock item.

Certain stock item status codes will restrict the availability of the stock item.

Below is the list of available stock status codes and their meaning:

Status Description Available
OK Stock item is healthy, nothing wrong to report Yes
Attention needed Stock item hasn't been checked or tested yet Yes
Damaged Stock item is not functional in its present state Yes
Destroyed Stock item has been destroyed No
Lost Stock item has been lost No
Rejected Stock item did not pass the quality control standards No
Quarantined Stock item has been intentionally isolated and it unavailable No

The status of a given stock item is displayed on the stock item detail page:

Stock_status_label Stock_status_label

Source Code

Refer to the source code for the Stock status codes:

Status codes for Stock.

Source code in src/backend/InvenTree/stock/status_codes.py
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
class StockStatus(StatusCode):
    """Status codes for Stock."""

    OK = 10, _('OK'), ColorEnum.success  # Item is OK
    ATTENTION = 50, _('Attention needed'), ColorEnum.warning  # Item requires attention
    DAMAGED = 55, _('Damaged'), ColorEnum.warning  # Item is damaged
    DESTROYED = 60, _('Destroyed'), ColorEnum.danger  # Item is destroyed
    REJECTED = 65, _('Rejected'), ColorEnum.danger  # Item is rejected
    LOST = 70, _('Lost'), ColorEnum.dark  # Item has been lost
    QUARANTINED = (
        75,
        _('Quarantined'),
        ColorEnum.info,
    )  # Item has been quarantined and is unavailable
    RETURNED = (
        85,
        _('Returned'),
        ColorEnum.warning,
    )  # Item has been returned from a customer

Stock Status supports custom states.

Default Status Code

The default status code for any newly created Stock Item is OK

Update Status

To update the status code for an individual stock item, open the Edit Stock Item dialog and then select the required status code in the Status field

Edit_stock_item_status Edit_stock_item_status