2
0
mirror of https://github.com/inventree/InvenTree.git synced 2025-04-29 03:56:43 +00:00
InvenTree/docs/docs/stock/status.md
Matthias Mair d5086b2fb1
User defined states (#7862)
* Add custom user defined states

* make tests more reliable

* fix list options

* Adapt version

* do not engage if rebuilding

* remove unneeded attr

* remove unneeded attr

* fix enum imports

* adapt cove target

* Add status_custom_key to all other serializers

* fix serializer method

* simplify branching

* remove unneeded imports

* inherit read_only status from leader field

* Add more tests

* fix tests

* add test for function

* refactor for easier testing

* move test to seperate class

* Add options testing

* extend serializer

* add test for all states and refactor to reuse already build functions

* use custom field in PUI too

* reset diff

* style fix

* fix comparison

* Add test for str

* test color exceptions too

* remove user state from tracking

* Add intro from model fields too

* update docs

* simplify implementation

* update tests

* fix name

* rename test

* simplify tags and test fully

* extend test to machine status

* move logic for response formatting over

* extend api response with machine  status

* ensure only direct subclasses are discovered

* test for length of total respone too

* use new fields on PUI too

* fix test assertion with plugins enabled

* also observe rendering in filters

* Add managment endpoints and APIs

* Add contenttypes to PUI renderes

* use filteres instead

* fix import order

* fix api route definition

* move status choices to serializer

* fix lookup

* fix filtering

* remove admin integration

* cleanup migration

* fix migration change

* cleanup code location

* fix imports

* Add docs for custom states

* add links to custom status
2024-08-22 07:33:15 +10:00

2.4 KiB

title
title
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:

{% with id="stock_status_label", url="stock/stock_status_label.png", description="Stock Status Label" %} {% include 'img.html' %} {% endwith %}

Source Code

Refer to the source code for the Stock status codes:

::: stock.status_codes.StockStatus options: show_bases: False show_root_heading: False show_root_toc_entry: False show_source: True members: []

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

{% with id="stock_status_edit", url="stock/stock_status_edit.png", description="Edit stock item status" %} {% include 'img.html' %} {% endwith %}