Inventory Traits
Traits are a way to configure how certain storage locations and stocks should behave. This page describes the key concepts and how to work with them.
Last updated
Was this helpful?
Traits are a way to configure how certain storage locations and stocks should behave. This page describes the key concepts and how to work with them.
Last updated
Was this helpful?
Traits provide information on how and are to be handled in operational processes. Traits are assigned to storage locations, but can affect the handling of both locations and the located on them. Each stock placed on a location (by assigning it a locationRef
) will inherit the traits of its storage location.
Traits can, for example, be used to mark locations and its stock as pickable or to along with their stock.
By default, each storage location has the traits PICKABLE
and ACCESSIBLE
, unless otherwise specified.
PICKABLE
Stock on these locations can be picked for fulfilling orders.
Only stock marked as PICKABLE
can be considered for incoming orders.
ACCESSIBLE
The ACCESSIBLE
trait indicates that stock can be removed from and new stock can be put on this location. Removing the ACCESSIBLE
trait from a location locks it for picking and triggers a notification during stowing processes. Only stock marked as ACCESSIBLE
can be considered for incoming orders.
KEEP_ON_ZERO
OUTBOUND
Each trait has a default value. When nothing else is specified, the enabled traits are processed on both the storage location itself and the stocks on it. The default value (whether it is enabled or not) can be overwritten individually for each trait by setting it in the traitsConfig
field on the storage location. All unspecified traits keep their defaults. This means that if a trait is enabled via the trait config, PICKABLE
and ACCESSIBLE
are set by default unless explicitly set to false.
The traitConfig should be used to write to traits. Do NOT use the trait array for that purpose.
In the following example we create a storage location without the ACCESSIBLE
trait. This means that stock on this location will not be considered for incoming orders and cannot be picked.
Both stock summaries and stock distributions allow fetching a high level overview on stock quantities per location for the respective trait(s).
To lock a storage location including the items placed on it, the ACCESSIBLE
trait must be removed. As a consequence, the items on the location are not considered for incoming orders (i.e. picking). It is still possible to remove items from the location or put new items on it. Additionally, users are notified about the locked status when moving items from the location via App or Backoffice.
To unlock the storage location, the ACCESSIBLE
trait must be set (again).
The following storage locations and stocks are ignored in order routing and fulfillment:
with an empty array of traits
with only the trait PICKABLE
with only the trait ACCESSIBLE
Normally stocks are deleted when they reach 0
through operations like picking or stock movements. To change this behaviour, add the KEEP_ON_ZERO
trait to the location. See .
The OUTBOUND
trait marks storage locations for items that have already been picked and are ready for being handed over to a shipping provider. When configured in the , stocks and reservations are automatically booked to the defined outbound location after picking has been completed.
Storage locations and stock with the traits PICKABLE
and ACCESSIBLE
OR with no traits are considered for fences, ratings, and calculating .
Creates a new storage location in this facility.
ID of facility from whom you want to create the storage location
The name of this storage location
The internal tenant id for this location
Describes the kind of a storage location:
SINGLE_STORAGE
- it is only allowed to store stock with the same tenantArticleId hereBULK_STORAGE
- stocks belonging to different tenantArticleIds can be stored hereThe traits of this storage location, includes both local config and and defaults. Do not use to write to traits, use traitConfig instead.
The configuration of the traits of this storage location
Barcodes representing this storage location
The Sequence item/s of this location
The id of the Zone to which this storage location belongs
Esb20gpHBL94X5NdMp3C
The name of the Zone to which this storage location belongs
A free text information about this storage location, max length 1024