Stow jobs

Stow jobs represent the intention or instruction to change the storage location and/or the amount of stock in a facility. While the stow job itself holds general information such as the facility or priority of the job, the stow line item contains information on the items to be moved, their quantity, location, and more. Stow line items cannot exist without a stow job.

More information can be found under Products – Stow Jobs.

Stock updates via stow jobs

• Stock is updated after a stow line item was taken. The target stock or location will not be updated until the items were stowed.

• Stock that has been already taken but has not been stowed or discarded yet is referenced in the heldItems object of the stow line item. In addition, the stock gets the "IN_MOTION" trait which makes it identifiable as a stock that is currently being moved and should not be updated.

Use Cases

Relocate items between locations

An admin wants items from a goods receipt to be stowed or items to be relocated.

1. Create stow job in status OPEN with takeFrom.type LOCATION to stowTo.Type LOCATION using POST /api/stowjobs.

2. Job is started by worker. Set status to IN_PROGRESS using StartStowJobAction.

3. Items are taken from start location. Set TAKEN information in operative data via ModifyStowLineItems action. A takenStockRef must be set to in order to define which stock should be reduced.

4. Items are stowed to target location. Set STOWED information in operative data via ModifyStowLineItems action. AstowedStockRefand stowedStorageLocationRef must be sent but can also be null. If a stowedStockRef is provided, the moved stock is added to the specified. If not, a new stock is created. If stowedStorageLocationRef is provided, the stock will be created on that location.

If no stowedStorageLocationRef is defined, the stock will be created without a reference to any location.

1. Repeat step "3." & "4." until everything is stowed.

2. Set status to CLOSED via CloseStowJobAction.

Create stock for items that are not registered yet

An admin wants new stock to be booked to location.

1. Create stow job in status OPEN withtakeFrom.type UNREGISTERED to stowTo.Type LOCATIONusing POST /api/stowjobs. If new stock should have properties or traits, it can be defined in the stockInformation of the takeFrom object.
2. Job is started by worker. Set status to IN_PROGRESS using StartStowJobAction.

3. Items are taken up by the worker. Set TAKEN information in operative data via ModifyStowLineItems action. A takenStockRef must not be defined since a new stock will be created based on data in taken.takenQuantity and takeFrom.stockInformation.

4. Follow steps 4-6 from above.

Discard stock

Admin wants stock to be discarded.

1. Create stow job in status OPEN with takeFrom.type LOCATION to stowTo.Type DISCARD using POST /api/stowjobs.

2. Job is started by worker. Set status to IN_PROGRESS using StartStowJobAction.

3. Items are taken from start location. Set TAKEN information in operative data via ModifyStowLineItems action. A takenStockRef must be set to in order to define which stock should be reduced.

4. Items are discarded. Set STOWED information in operative data via ModifyStowLineItems action. AstowedStockRefand stowedStorageLocationRef must not be defined since the stock is deleted after stowing was completed.

5. Set status to CLOSED via CloseStowJobAction.

Relocate items between stocks

Admin wants a specific stock to be relocated. This could, for example, be the case if there are multiple expiry dates for the same item on one location.

1. Create stow job in status OPEN with takeFrom.type STOCK to stowTo.TypeSTOCK using POST /api/stowjobs.

2. Job is started by worker. Set status to IN_PROGRESS using StartStowJobAction.

3. Items are taken. Set TAKEN information in operative data via ModifyStowLineItems action. A takenStockRef must be set to in order to define which stock should be reduced.

4. Items are stowed. Set STOWED information in operative data via ModifyStowLineItems action. AstowedStockRefmust be sent but can also be null.

If no stowedStockRef is defined, a new stock will be created.

1. Repeat step "3." & "4." until everything is stowed.

2. Set status to CLOSED via CloseStowJobAction.

Change the priority of a stow job

The priority can be defined on stowJob level. Any value can be set meaning users can define their own logic. Priority can be set using PATCH /api/stowjobs/{stowJobId}.