ShipStream Knowledge Base
Floor Operations

Put-Aways

A Put-Away represents inventory that needs to be put away or stored in your warehouse. Put-Aways are not created directly but rather originate from one of the following actions:

You can find a grid listing all Put-Aways by navigating to Operations > Put-Aways. Completed At shows when placement finished, and Committed At shows when all inventory in the Put-Away was committed. Older Put-Aways may have a blank Committed At because the time was not recorded. The same columns appear on the Put-Aways tab of Products and Lots, and on the Operations > Work Orders > Outputs and Shipping > Shipments > Cancellations grids.

Put-Aways will have one or more Associations. They may be associated to multiple entities of the same type (e.g. an ASN), but will never contain a mixture of types.

Statuses

The statuses for a Put-Away are pretty linear and are as follows:

  • Open - Items are still being added to the put-away from the associated entity
  • Pending - One or more items are awaiting an approval action (e.g. an ASN shortage exception)
  • Ready - No more items will be added, ready to begin the put-away process
  • Processing - Processing is currently underway and there are still items that have not yet been put-away
  • Complete - All items have been put-away
  • Void - The put-away was voided (all unprocessed items have "disappeared")
A Put-Away that is Pending or Ready can be re-opened so that more items can be added by clicking Reopen on the Put-Away page.

Put-Aways directly impact the status of the ASNs, RMAs and Other Deliveries to which they are associated as depicted in the following diagram:

Admin UI

  1. Navigate to the Put-Away page by:

    1. scanning a barcode associated with the Put-Away

      The types of labels that can be scanned include Container Labels, Put-Away Labels, License Plates, Packing Slips, and Tracking Numbers.
    2. navigating to Operations > Put-Aways and using the grid to locate
    3. navigate to the delivery page (Receiving > ASN, RMA or Other Delivery) and then to the Put-Aways tab on the page of the delivery that you want to put-away, then click the header link titled Put-Away # X.
  2. If the Put-Away is not yet closed, click Close to advance it to Ready status. If there are unapproved Overage exceptions, these will need to be approved or rejected before the Put-Away can be closed.
  3. Click the Put-Away button on your chosen item row.
  4. Enter the Location and Quantity to put-away and click Submit. If the product has lot tracking enabled, you will also need to select the correct lot to be put-away.
  5. Repeat until all items are processed.
  6. If the Put-Away is associated with an ASN, RMA or Other Delivery and Auto-Commit is not enabled, click Commit. Inventory at an unheld Location becomes available or can be assigned to backordered Orders. Inventory at a held Location completes the Commit step but remains held and unavailable for allocation.

Scanner UI

Put-Aways can use either a Manual or Directed workflow. Manual is the default. To choose the default for a Warehouse, select it in Current Configuration Scope, then go to System > Configuration > Warehouse > Stock > Directed Put-Away Workflow > Default Put-Away Workflow. A user whose role includes Scanner > Overrides > Override Directed Put-Away Workflow can switch an individual Put-Away between the two workflows before placing inventory. A user whose role includes Scanner > Overrides > Override Directed Put-Away Destination can send one stop of a Directed tour to a Location of their choosing (see When a Planned Destination Cannot Be Used).

  1. From the Scanner main page, tap Put-Away.
  2. Scan a barcode according to its type.
  3. Tap Start Put-Away to begin processing.

Directed Workflow

Directed Put-Away plans destinations for the inventory and walks you through them one stop at a time along the Warehouse's default Pick Route. Each stop names one Location, Product, and quantity, and the reason ShipStream selected that destination. A Product split between multiple Locations appears as multiple stops.

  1. The Start screen summarizes the tour: how many stops and units it holds, how many SKUs, the routing method, and whether any lines need manual placement. The stops are listed in travel order under On the tour, and lines without a destination under Manual. If you have override permission, Switch to Manual appears in the card's header. Tap Start Tour.

  2. The first stop opens. The destination Location is the headline, with its Slot Type and the reason it was chosen beneath it, then the Product and the quantity to place. When a Prefer Slotting Rule decided the destination, the rule's name follows the reason. The checklist tells you what to scan next, and Up next previews the following stop. Take the Product to the destination.

    When Other Asset Policies are configured, an Access with row below the Location lists the Asset Types allowed at that destination. Use it to identify the equipment you need. See Allowed Asset Types for its display states.

  3. Scan the Product barcode. Step 1 turns green with the barcode that verified it, and step 2 lights up.

  4. Scan the Location barcode. Only the destination shown on the stop is accepted, which keeps inventory from being placed against a later stop by mistake.
  5. The counter opens on the planned quantity, so tap Submit to place it. The capacity line and chip appear as they do in the Manual workflow (see Capacity).

  6. ShipStream confirms what was placed and opens the next stop. Stops are numbered across the whole tour, so the title reads Stop 2 of 3 once the first stop is done. Repeat the scans for each remaining stop.
  7. Tap Route in the toolbar at any time to review the whole tour: placed stops with the Location they went to, the current stop, the stops still ahead, and any manual lines at the end. Tap Continue or the current stop to return to it.

  8. After the last stop, the Start screen returns with The directed tour is complete. Put the remaining lines away manually. Placed Products are checked off. Put any remaining lines away as described in the Manual workflow below.

  9. When every line is placed, verify the Put-Away Complete summary. Where it went lists each Location and what was placed there. If Auto-Commit is enabled, ShipStream also commits the associated Delivery automatically.

For lot-tracked Products, each stop and the Route show the Lot Number Input, Expiration, and Origination when recorded. Use units matching those details. Scanning the Product barcode confirms the SKU; it does not distinguish two lots of the same Product.

Allowed Asset Types

The Access with row reads Asset Policies whose Operation is Other. It describes access to the stop's destination:

  • Named Asset Types - One chip per allowed Asset Type, sorted by name. Types from all matching policies are combined, and long lists wrap onto more lines.
  • Any Asset Type - A matching policy leaves Asset Types empty, allowing all types.
  • No Asset Policy - Other policies exist, but none matches this destination. The amber chip still allows you to scan and place inventory as usual.

If no Other policies exist, the row is hidden, even when Batch Pick or Bulk Fulfill Pick policies are configured. Asset Policies apply across all Warehouses, so an Other policy enables the row in every Warehouse; destinations outside its restrictions can show No Asset Policy.

You do not need to select, scan, or confirm an Asset Type. The row provides information only and does not change destination selection, travel order, scans, placement, deviations, or skips.

A queued stop opened from Route shows the row for its own destination. The Up next line and the Route overview do not show Asset Types. After a deviation or skip, the row describes the destination of the stop that opens. To see policy edits during an active tour, go Back to the Start screen and tap Start Tour again.

When a Planned Destination Cannot Be Used

If the current destination is full, blocked, damaged, or otherwise unsuitable, tap Can't place here… on the stop. Choose the reason, add details if you like, and pick one of the actions:

  • Use next names the next Location ShipStream saved as an alternative when the tour was planned and replaces the current destination with it. When no saved alternative is left, the button reads Put away manually and moves the line to the manual portion of the Put-Away.
  • Skip, return later moves the stop to the end of the tour once. If it still cannot be completed when it returns, ShipStream moves that line to the manual portion of the Put-Away.
  • Choose location... lets you scan or type the Location to use instead. It only appears if your role includes Scanner > Overrides > Override Directed Put-Away Destination. ShipStream checks the Location the same way it checks a manual put-away and reserves room there for the stop's full quantity. If either check fails, the message explains why and the stop keeps its current destination. Otherwise the stop keeps its place in the tour and every other stop keeps its destination. The remaining saved alternatives for this stop are dropped, because your choice replaces them, so Use next then reads Put away manually.
  • Cancel closes the sheet without changing the stop.

A rerouted stop reopens on its new destination with a banner naming the reason and the Location it left, so you can confirm the change before you scan.

Lines for which ShipStream cannot assign a destination appear under Manual on the Start screen and at the end of the Route. Process those lines by selecting the Product and scanning a Location as described in the Manual workflow below. When the last directed stop is placed and manual lines remain, the Scanner returns to the Start screen for them.

Products missing a required Lot Number or Expiration appear under Manual with Lot Info required. Finish the directed stops, then select the Product, tap Unassigned Items, and assign its Lot Info before placing it. If all lines require manual handling, you can begin assigning Lot Info immediately; no workflow override is needed.

When planning finishes with every line needing manual placement, the notice lists the reasons, such as No feasible destination or Too many candidates, and tells you to put the remaining lines away manually.

ShipStream rechecks the current destination and its reserved capacity when inventory is placed. If a safe tour cannot be built or its destination capacity cannot be reserved at the start, the Scanner displays Directed put-away is not yet available and continues as a Manual session.

Manual Workflow

  1. Scan a Product barcode or tap a row if the Product does not have a barcode.
  2. Scan a Location barcode. You may scan an assigned Location, a new Location, or one that is not in use by another Product.

    If the Location has an active Inventory Hold and still contains inventory, the Scanner asks you to confirm before adding more inventory. If the Location has drained completely, ShipStream treats the remaining hold as stale and releases it automatically when you submit the quantity, without asking for confirmation.

    If the Location's Slot Type defines how much of the Product the slot should hold, the list of Locations shows a Capacity column with a colored chip for each Location. The chip tells you whether the amount you are putting away will fit. See Capacity below.

    Tap the Velocity row to view more information about the recent velocity of the Product, so you are better informed about its demand. See Product Velocity for more information. Then tap Back to return to the previous screen.
  3. Use the counter to enter the amount to put in the current Location. When the Location has a known capacity, the counter shows a capacity line for the destination, for example Capacity: 12 / 20, with the capacity chip beside it.
  4. Repeat the Product, Location, and quantity steps until all items have been processed. The Put-Away Complete summary then lists the totals and, under Where it went, each Location and what was placed there.

Capacity

A Location's Slot Type can define how much of a given Product the slot is meant to hold. When it does, the Scanner shows a capacity chip in the Capacity column of the Location list and on the counter.

The chip compares the amount you are putting away against the room left in that slot:

ChipMeaning
FitsThe amount fits. The remaining quantity is omitted to preserve the blind count.
TightThe amount fits exactly and fills the slot. This is informational only and never warns.
Over by NThe amount would exceed the slot's capacity by N units.
ProhibitedThe Product is not allowed to be stored in this type of slot.
— (dash)The capacity is unknown, has not been calculated yet, or does not apply to this Slot Type.

In the Manual workflow, the chip is advisory by default. Over by N and Prohibited raise a warning that you can acknowledge and then continue, so an operator holding the inventory is never stranded by a capacity figure that does not match the shelf. The other chips never warn.

To make capacity binding instead, set System > Configuration > Warehouse > Scanner > Put-Away > Enforce Capacity to Yes. A Prohibited Location is then refused as soon as you scan it, as is a Location that is already full. An amount that would go over the slot's capacity is refused when you confirm the count, so you can still put away a smaller amount that fits and take the rest to another Location. The default is No.

In the Manual workflow, a dash chip never warns and never blocks, in either enforcement mode. Directed Put-Away must be able to reserve promised capacity for its planned destinations; if that cannot be done, ShipStream safely falls back to a Manual session. Capacity also never overrides a Slotting Rule: when a rule blocks a Location, that block stands no matter what the capacity chip shows.

Manual Sources in Directed Put-Away

When several Items of the same Product and Lot require manual placement, scan the destination Location and enter the combined quantity. ShipStream distributes that quantity across the eligible manual Items automatically. Items reserved for the active directed tour are excluded; a quantity exceeding the manual remainder is rejected.

Directed Destination Reasons

The Reason column tells you why a destination was chosen:

ReasonMeaning
Open pick-face needThe Product's pick face is below its target, so this receipt tops it up instead of opening a new slot.
Slotting Rule preferenceA Prefer Slotting Rule names this Location for the Product, so it was filled before Locations that no Prefer rule names. The stop and the Route show Rule: and the name of the rule that decided it.
Best available slotNeither a pick face that needs stock nor a Prefer rule decided this slot, so ShipStream picked the one with the best Location Priority among the Locations that can take it. A Location that a Discourage rule matches is chosen only when the others have no room.
Preference tie-breakSeveral slots were equally good and a configured Soft Tiebreaker decided between them.
Operator overrideA user with the Override Directed Put-Away Destination permission chose this Location from the Scanner.
No feasible destinationNo Location in the Warehouse can accept this line right now. Put it away manually.
Too many candidatesThe search reached its limit before finding enough destination capacity, so the line is left for manual put-away.
Alternatives exhaustedEvery planned destination for this line has already been used, so the line is left for manual put-away.

How Directed Destinations Are Chosen

ShipStream plans each Put-Away in a fixed order, so a lower rule never outweighs a higher one:

  1. Only workable Locations are considered. A destination must pass every check a manual put-away would: Require and Forbid Slotting Rules, Slot Capacity, lot and expiration compatibility, Inventory Holds, and a Location not already occupied by another Product. Prefer and Discourage rules never remove a Location.
  2. A pick face that needs stock is topped up first. If the Product's pick face is below its replenishment target, the receipt fills it before any other Location is considered.
  3. Prefer and Discourage rules come next. Each remaining Location sits on a slotting rung for the Product: Preferred (Critical, High, Normal, Low), neutral, or Discouraged (Low, Normal, High, Critical), set by the strongest rule that applies there. A Location that no Prefer rule names and no Discourage rule matches is neutral. ShipStream fills one rung at a time across the whole Put-Away, strongest preference first, so a Location that a Prefer rule names wins over a neutral Location with a better Location Priority, and a slot one Product prefers is not spent on a faster mover for which it is neutral or less strongly preferred. When the Preferred Locations have no room, the line falls back to neutral, then Discouraged Locations, so Prefer and Discourage rules never block a put-away.
  4. Within a rung, faster movers choose first, and Location Priority picks the Location. Among the candidates on one rung, Products with a higher Slotting Density Rank choose before slower movers, and a Product with no rank is treated as neutral. For each Product, ShipStream ranks the Locations the same way a Shipment reserves them, by Priority. A Location that already holds the Product ranks by its Priority. Every other Location, whether it is empty, still assigned to this Product, or assigned to another Product, ranks by its Default Priority. A Location with no Default Priority ranks after all the others. A lower number ranks first. The Product's existing Locations get no other precedence: a Location holding the Product at Priority 30000 ranks after an empty Location with a Default Priority of 500.
  5. Ties go to the Product's own Location, then fit, then your settings. A lower Priority number always wins. Among Locations with the same number, a Location assigned to the Product comes first, then an unassigned Location, then a Location assigned to another Product, so the Product's emptied slot is refilled before another Product's slot is reused. Within its limits, the search reads the Product's own Locations before other Locations at an equal Priority number, and its own Locations with no Default Priority before other Locations with none. Unassigned and other Products' Locations are compared among the ones the search reaches. Remaining ties are separated by fit (the fewest placements, a known size, and the least leftover space), then by the Soft Tiebreakers you configure, then by Default Pick Route order, and finally by Location ID.
How a directed destination is chosenCandidate Locations
1 · Workable2 · Pick-face need3 · Slotting rung4 · Priority5 · Tie-breaknot reachedA-01-1A-01-3A-02-2A-02-3A-05-2B-01-4B-03-1B-04-2C-02-2Directed Tour · Stop 1C-02-2 · Reason: Best available slot

One received line for one Product. ShipStream starts from every Location in the Warehouse that could hold it, listed here in Pick Route order.

A decision pipeline for one received line. Nine candidate Locations pass through five gates in order: workable checks, including Require and Forbid Slotting Rules, remove some; an open pick-face need wins next; then the slotting rung, where a Location that a Prefer rule names wins over neutral Locations and a Location that a Discourage rule matches is held back as a fallback, never removed; the Locations on the best rung are ranked by Location Priority, using Priority for a Location that holds the Product and Default Priority for any other, and the Product's Slotting Density Rank picks the slot; a Location that already holds the Product gets no other precedence; a tie is broken by assignment, fit, configured Soft Tiebreakers, Pick Route order, then Location ID. The deciding gate becomes the reason shown on the Directed Tour, with the rule's name for a Slotting Rule preference, or the line falls to manual put-away when nothing is workable.Each gate only sees what the gate above it let through, so an open pick-face need always beats a preferred slot, and a Location that a Prefer rule names beats a neutral Location with a better Location Priority. Tick A Prefer rule names zone B (Critical) to see B-03-1 chosen at the slotting rung, with the reason Slotting Rule preference and the rule's name on the stop; tick A Discourage rule names zone A (Normal) to see those Locations held back as a fallback rather than removed. The numbers here are illustrative: real ranking follows each Location's Priority and Default Priority, and the Pick Route only sets the order of the stops.

The Pick Route sets the order in which the tour visits its stops, not which Locations are chosen. A route that starts at the far end of the Warehouse therefore does not pull stock to the far end.

Planning is greedy. A line that is already covered keeps its destinations, even when a better one is freed later. When a line cannot be fully placed, it goes to manual put-away and gives its Locations back, and ShipStream plans the remaining lines again, offering freed pick faces that need stock first and then each rung in order. The alternatives saved for each stop follow the same order, so Use next offers the next-best Location by these same steps.

The search is bounded. For each line, ShipStream reads pick faces that need stock first, then the Location Profiles of the Prefer rules that apply to the Product (strongest Preference Strength first), then the Zones of those pick faces, then the rest of the Warehouse. The Prefer-rule search has its own limits, so a preferred zone is found even when its Default Priority would leave it beyond the reach of the Warehouse search. Discouraged Locations cannot fill up a search: a line keeps at most 10 of them, the least Discouraged it finds, so a mildly Discouraged Location found later replaces a strongly Discouraged one found first. Once it has 10, Locations that could not replace one of them are skipped without being checked. Skipped Locations still count toward the search limits, so a search that meets only Discouraged Locations can still stop before it reaches neutral ones. If the overall search limit is reached before the rest of the Warehouse is searched, the candidates already found can still supply a directed plan; if it is reached earlier, only a line that already has a Location from its Prefer-rule search where Prefer wins over any matching Discourage rule can. A line whose search is interrupted goes to manual put-away. Better destinations may exist outside the searched area.

Configure the planner per Warehouse under System > Configuration > Warehouse > Stock:

Group and fieldDescription
Directed Put-Away Enumeration > Ordinary Candidates per LineThe most Locations the planner keeps from its search of the rest of the Warehouse, in addition to the line's open-need Locations, the Locations in the Zones of its pick faces, and the Locations of its Prefer rules' Location Profiles. Locations on a better slotting rung are kept first; on one rung, those with the best Location Priority, then those assigned to the Product, then unassigned ones, then those assigned to another Product, then the best fit. The default is 10, and it cannot exceed the Hard Candidate Limit per Line. A larger value keeps more of the Locations the search already found; it does not widen the search.
Directed Put-Away Enumeration > Hard Candidate Limit per LineThe most Locations one line may carry into ranking. Open-need Locations are never dropped to fit; a line whose required Locations exceed this limit is handed to manual put-away. When a line has more Locations than the limit, those on a better slotting rung are kept first. The default is 40, and it must be at least Ordinary Candidates per Line. Internal search limits also apply to both settings.
Directed Put-Away Ranking > Alternatives per DestinationHow many next-best Locations are kept for each planned destination, from 1 to 10. The default is 3. Fewer may be available, and each alternative is checked again before use.
Directed Put-Away Ranking > Soft TiebreakersA comma-separated list of attribute and weight pairs, applied only between Locations that tie on slotting rung, Location Priority, assignment, and fit. Positive weights prefer higher values and negative weights prefer lower ones. Leave empty to go straight to Default Pick Route order, then Location ID; the default is empty. Slotting Rules are not weighted here, because Prefer and Discourage rules already rank destinations ahead of Location Priority, and a value naming the Slotting Rule attributes of earlier releases cannot be saved.

Reserved Room at Destinations

Directed Put-Away recommends Locations with fixed-capacity checking enabled and a known capacity or an explicit Unlimited allowance for the Product. Locations without fixed-capacity checking, or with capacity that is unknown or awaiting calculation, are excluded. If no eligible destination remains, the line falls back to manual placement.

Directed Put-Away can reuse an empty Location assigned to another Product, provided the normal placement checks allow it. Among Locations with the same Priority number, reuse comes last: a Location assigned to the Product is chosen first, then an unassigned Location, then one assigned to another Product. A Location with a lower Priority number still wins, whatever its assignment. The Location is reassigned when the directed destination is reserved, before any quantity is put away. Cancelling the tour leaves this assignment in place. An active destination reservation for another Product blocks reuse until that reservation is released or expires.

When a directed plan sends stock to a Location, ShipStream reserves that much room there so another Put-Away starting a minute later is not sent to the same empty space. The reservation is released when the stock is placed or the session ends. While a Location is reserved by an active tour, it cannot be deleted or reassigned to a different Product.

If a session is abandoned, for example because a device dies, the reservation becomes eligible for automatic release after its timeout. Set System > Configuration > Warehouse > Stock > Directed Put-Away Capacity Reservations > Reservation Timeout (Seconds) to control this interval. Active tours renew their reservations automatically when they refresh successfully. The default is 300 seconds and the allowed range is 30–3600 seconds. A shorter timeout returns room from abandoned work sooner but tolerates shorter connection interruptions; a longer timeout tolerates longer interruptions but keeps the room reserved for longer.