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 line to the end of the tour and keeps its destination. If it still cannot be completed when it returns, tap Skip to manual put-away to move it to the manual portion of the Put-Away. If it is the last line on the tour, the first skip sends it to manual 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.

Selecting a reason alone does not change the destination. Tap Use next to change the Location, or Skip, return later to work on another line first.

In this sample ASN, the operator skips a blocked destination, returns to it after the other lines, and then chooses the next saved Location. Tap any screenshot to enlarge it.

  1. Choose the action

    Select Location blocked, then tap Skip, return later to work on another line first.

  2. Return to the same Location

    When this line returns, it still names the original Location and shows Skipped once.

  3. Choose the next Location

    Open Can't place here again, select the reason, and tap Use next. The Rerouted banner confirms the new Location.

Finishing Skipped Lines Manually

If a line still cannot be placed when it returns, tap Skip to manual put-away. Continue the remaining directed stops. When the tour ends, the Scanner returns to the Product list with The directed tour is complete. Put the remaining lines away manually.

Scan a remaining Product, scan an eligible Location, and enter the quantity using the Manual counter. You do not need to tap Switch to Manual to place these lines. The usual Location checks still apply, including Require and Forbid Slotting Rules and any enforced Capacity limits. Review any warnings before submitting.

The same sample ASN contains four units across three SKUs. After its lines are sent to manual put-away, the operator places them and reaches Put-Away Complete.

  1. Continue from the Product list

    The directed tour is complete. Scan a remaining Product to begin manual placement.

  2. Scan, count, and submit

    Scan an eligible Location, review any warnings, enter the quantity, and tap Submit. Repeat for the remaining Products.

  3. Verify the completed Put-Away

    All four units across three SKUs are placed. Where it went lists their Locations and quantities.

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.

Correcting a Capacity

When a shelf really holds more or less than its capacity says, you can correct the capacity on the Scanner without leaving the Put-Away. The Correct capacity button is on the counter in both the Manual and the Directed workflow. If a capacity warning stops you when you scan a Location that holds more than the warning says, tap Continue, then Correct capacity.

A correction applies to one of two scopes:

  • This Location - The Product's capacity at this one Location only, for example a slot under a lower beam or a sprinkler head. The Location keeps this as its own capacity for the Product, and other Locations of the same Slot Type do not change.
  • This Product in every Location of this Slot Type - The Product's Reported capacity for the Slot Type, the same value shown on the Product's Slot Capacities tab. It applies in every Warehouse. Locations that have their own capacity for the Product keep it.
  1. Set the new capacity

    Enter the quantity on the counter, tap Correct capacity, choose the scope, and enter the New total capacity. The sheet shows the capacity now and the stock already on the shelf. Tap Next.

  2. Choose a reason

    Select why the capacity is wrong, then tap Review. Other requires a note.

  3. Review and confirm

    Check the scope, the old and new capacity, and what the shelf will hold. Nothing is saved until you tap Confirm. Tap Change to go back.

In the Manual workflow, Confirm saves the correction and the placement together. In the Directed workflow, the rest of the Put-Away is planned again starting at the corrected Location with what now fits; stops you already placed stay done. For example, if a stop says to place 16 but the whole pallet of 18 fits, correct the capacity to 18 and the next stop is the same Location with 18.

A lower capacity must still leave room for the stock on the shelf and for work already promised to the Location, such as other Directed tours and Replenishment Tasks. When it does not, the correction is refused if Enforce Capacity is Yes; otherwise the Review shows a warning that you must confirm.

Every correction records who made it, when, the reason, and the capacity before and after. See Own Capacities for the history of a Location and Slot Capacities for the latest change of each Slot Type.

Correcting Every Location of a Slot Type

When the scope is This Product in every Location of this Slot Type, the Review counts the Product's other Locations of that Slot Type in up to three groups: those that would be over the new capacity, those that fit, and those with their own capacity. Tap a View all button to list a group, with your current Warehouse first, then tap Back to Review. The lists are for information only and change nothing.

  1. Review the other Locations

    The Review warns that the capacity applies to every Location of the Slot Type in every Warehouse and counts the Product's other Locations.

  2. Open a group

    View all lists the Locations in a group with the Slot Type and the new capacity. Tap Back to Review to return.

Locations with a Weight Limit

At a Location with a weight limit, the sheet also shows the shelf's weight against the limit and what the shelf would weigh at the new total. A higher capacity does not let more in than the weight limit allows: when the limit holds fewer units than the placement needs, the Review tells you to cancel and lower the quantity on the counter, and offers no Confirm.

  1. Check the weight

    Under the new total, the second line shows the weight on the shelf now and the weight at the new total.

  2. Lower the quantity

    The weight limit allows fewer units than the placement needs, so the Review offers only Change and Cancel.

Who Can Correct a Capacity

Two User Role permissions under Scanner > Put-Away control the button:

  • Correct Location Capacity - Allows the This Location scope. Roles that already had Scanner > Put-Away received it automatically.
  • Correct Product Capacity - Allows the This Product in every Location of this Slot Type scope. Because it changes every Location of the Slot Type in every Warehouse, it is not granted automatically; assign it to supervisors.

To turn corrections off for a Warehouse, set System > Configuration > Warehouse > Scanner > Put-Away > Allow Capacity Corrections to No. The default is Yes. Both this setting and Enforce Capacity can be set per Warehouse.

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. Home locations come first, then pick faces that need stock. Among workable Locations, the Product's home location ranks first. After home locations, 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.

Reviewing Put-Away Tours

Each time an operator starts a Directed Put-Away on the Scanner, ShipStream plans a tour and records how it went: which stops were placed where they were recommended, which went elsewhere and why, which were skipped, and which lines were left for manual put-away. The Put-Away Tours screen turns those records into answers for supervisors: is directed put-away working in this Warehouse, which Locations keep getting turned down, and which operators may need coaching.

Navigate to Operations > Put-Aways > Put-Away Tours. The screen requires the Operations > Put-Away Tours > View permission. When your installation is updated to the release that adds this screen, every role that already has Operations > Put-Aways receives the permission automatically. Users who are logged in at the time see the new menu item after they next log in. To hide the screen from a role, remove the permission on the role's Role Resources tab.

Tours and Revisions

A tour is one directed walk through a Put-Away. When a Put-Away's contents change, or an operator switches it to Manual partway through, the next directed session starts a new revision of the tour. The earlier revision becomes Superseded but keeps everything that was placed on it. Each revision is its own walk, so each has its own row and its own Tour #.

A tour has one of these statuses:

  • Building - ShipStream is still planning the tour's destinations.
  • Active - Directed stops remain and no line has gone to manual put-away.
  • Partial - Directed stops remain and at least one line has gone to manual put-away.
  • Complete - No directed stops are left. Lines that went to manual put-away may still be waiting to be put away by hand.
  • Superseded - A newer revision replaced this tour.

The Put-Away Tours Grid

The grid lists one row per tour revision, newest first. By default it shows tours started in the last 7 days that have some activity.

ColumnShows
WarehouseThe tour's Warehouse. Shown only when Show All is selected and you have access to more than one Warehouse.
Tour #The tour's number. Click a row to open the tour view.
RevisionThe tour's revision number for its Put-Away. A Put-Away gets a new revision when its contents change or the operator switches to Manual mid-tour; the earlier revision becomes Superseded.
Put-Away #The Put-Away number, linked to its page.
RelationsThe related ASN, Work Order, Shipment or Order number, as on the Put-Aways grid.
StatusThe tour's status.
Started byThe user who started the tour on the Scanner.
StartedWhen the tour started.
DurationHow long the tour took from start to finish. Shown for Complete tours only.
Lines placedLines placed, out of all lines on the tour, for example 21 / 30.
OverridesHow many times an operator turned down a recommended Location with Use next, Put away manually, or Choose location... on the Can't place here… sheet.
SkipsHow many times an operator tapped Skip, return later. Skips made from the Picking in progress prompt are shown in brackets, for example 5 (2 picking).
ManualLines on the tour that went to manual put-away.
ActivityYes if anything happened on the tour: a placement, skip, override or manual line. No for a superseded tour on which nothing happened.

Filter the grid by Warehouse, Tour #, Put-Away # (exact number), Relations (ASN, Work Order or Shipment number), Status, Started by, Started, the Revision, Lines placed, Overrides, Skips, and Manual ranges, and Activity. Keep these rules in mind:

  • Started always has a start date, so a search never has to read every tour ever recorded. If you clear both dates, it returns to the last 7 days. With only To set, From defaults to 6 days before it. With only From set, To defaults to 6 days after it or today, whichever is earlier. The range can cover at most one year: an earlier start date is moved forward and the grid shows The Started range is limited to one year. Click the From or To label to enter a time; searches and exports keep that time unless the corresponding date is defaulted or clamped. To find an older tour, open its Put-Away and use the Tours tab.
  • Relations searches only numbers your user is permitted to see. A negative filter such as NOT EQ 8000002 excludes every tour with that relation; another relation on the same Put-Away does not make it match. * leaves the results unchanged. For older Put-Aways, search the ASN number displayed in Relations.
  • Activity defaults to Yes, which hides superseded tours on which nothing was placed, skipped, overridden, or sent to manual put-away. A tour with current manual lines counts as activity even if those lines were manual when it started. Choose No to see only those tours, or clear the filter and search to see every tour. Reset Filter returns it to Yes.
  • The total after the slash in Lines placed and the picking count in Skips are worked out for the rows on screen, so they cannot be filtered or sorted. The Lines placed and Skips filters use the first number in each cell.
  • Manual shows the current count of manual lines, but its filter and sort use a count the tour updates as it is worked. A tour that sent lines to manual put-away when it started can therefore sort or filter as 0 until its first stop is placed, skipped, or overridden.

Click Export to download the grid as CSV or Excel. Exports apply your filters but are ordered by Tour #, not by the sort shown on screen.

Users limited to certain Merchants see the tours that include at least one line of their Merchants. The counts in each row still cover the whole tour, as they do on the Put-Aways grid. Selecting a Merchant in the Merchant filter narrows the grid in the same way. Relation numbers in the grid, exports and tour header are limited to your permitted Merchants. When a Merchant is selected, only that Merchant’s relation numbers appear, including for users with access to all Merchants.

The Summary Strip

The strip above the grid sums up directed put-away in one Warehouse. Changing the grid's filters does not change the strip; it has its own 7/30-day window: click Last 7 days or Last 30 days to cover the tours started in a rolling 7 or 30 days. The active window is bold; the other window is a link. Hover over either choice to see the date range it selects. The strip also shows the Warehouse's routing mode, such as Basic routing; the Warehouse name is in the page title. It is refreshed about every 10 minutes, so a tour finished a few minutes ago may not be counted yet.

FigureMeaning
AcceptanceThe share of finished stops that were placed at the recommended Location.
OverridesStops placed somewhere other than the recommended Location.
SkipsSkip events, the number of lines skipped at least once, and how many skips came from the Picking in progress prompt, for example 28 on 22 lines · 9 picking.
ManualLines that went to manual put-away.
Completed toursTours that reached Complete.
Avg tourThe average duration of the completed tours.
Avg per placementThe average time to place a stop, measured from the Location scan.
Units placedUnits placed by the tours.
Most overridden LocationsA table of up to 10 recommended Locations that operators most often placed elsewhere, with the override count and Most common reason for each.
Override reasonsHow often each reason was given for placing a stop elsewhere: Location full, Location blocked, Product mismatch, Damaged location, or Other.
Manual reasonsWhy lines went to manual put-away, with a count for each reason.
Lines by times skippedHow many lines were skipped once, twice, and so on.

The first four tiles show Acceptance (of recommended stops), Overrides (placed somewhere else), Skips (with the number of affected lines and skips while picking), and Manual (lines sent to manual). Smaller figures show completed tours, average tour duration, average time per placement, and units placed. Below them, Most overridden Locations is a table; Override reasons, Manual reasons, and Lines by times skipped show each count with its percentage of that section's total and a matching bar.

The strip's Overrides counts stops that ended up somewhere other than the recommended Location, while the grid's Overrides counts every time a recommended Location was turned down, so the two can differ. A stop that was turned down and then went to manual put-away appears under Manual reasons, not Most overridden Locations, and an overridden stop always counts against the Location originally recommended. Most common reason shows the most common last rejection recorded for stops originally recommended there; that rejection can concern a later alternative Location.

The strip appears only in these cases:

  • One Warehouse is selected. Select a single Warehouse instead of Show All to see it.
  • No Merchant is selected in the Merchant filter, because the strip covers every Merchant. With a Merchant selected, the strip is replaced by The summary covers all merchants. Select All Merchants to see it.
  • Your user is not limited to certain Merchants. For limited users the strip is hidden.
  • You are using the classic Admin UI. The Vue GUI refresh shows the grid and opens the tour view, but not the strip.

When no placements, skips or manual lines are recorded for tours in the window, the strip reads No placements, skips or manual lines recorded in this period. A tour may have started without recording any of these outcomes.

The Tour View

Click a row in the grid to open Put-Away Tour # and its number. The header shows Put-Away # and its number with a link to it, followed by its relation text when available, the revision (for example revision 2 of 2, with links to the previous visible (Earlier) and next visible (Later) revisions, plus Latest when it differs from those and the current revision), the status, and the routing mode. Its second line shows who started the tour, the Pick Route, when it started, and totals for the whole tour: lines and lines placed, units, Overrides, Skips with the number of lines skipped and the picking skips, Manual, and Avg time per placement. Use the View Put-Away header button to open the Put-Away, or Back to return to the grid.

Each line of the tour has one row:

ColumnShows
#The line's position in the tour.
SKU / MerchantThe Product and its Merchant.
LotThe Lot, if any.
QtyThe quantity on the line.
StatusPending, Planned, Placing, Placed, Manual, Skipped, or Void.
RecommendedThe path of Locations the stop was sent to, joined by →. Each arrow is one turn-down; (operator) marks an operator-chosen Location. The last Location is the current destination or where the stock was put, unless the stop was released or sent to manual put-away.
Put atWhere the line was actually placed.
Why recommendedThe reason the Location was recommended. When saved details are available, click Why to open a read-only popup explaining the choice.
Override reasonThe reason given for the most recent turn-down.
SkipsHow many times the line was skipped.
PickingHow many of those skips came from the Picking in progress prompt.
Manual reasonWhy the line went to manual put-away.
Time to placeHow long placing the line took, measured from the Location scan.

A line split between several Locations shows split across 2 Locations ↓ under Recommended, followed by one row per part (└ part 1, └ part 2, and so on), each with its own quantity, Locations, override reason, time to place, and Why when saved details are available. A line that went to manual put-away when the tour started shows — in the Location and reason columns.

The Why popup starts with a sentence describing the saved reason, followed by Facts at this Location: pick-face need and home location, the Slotting Rule, Product speed, Location Priority and assignment, and placements needed. Next best lists the saved alternative Locations in order, with their preference label (for example, Preferred (High), Neutral or Discouraged (Low)) and Location Priority. When the stop was redirected, a Status column shows Turned down, Put here, or Current destination, and Not used for alternatives it never reached. A stop that stayed on its recommended Location has no Status column. Operator-chosen Locations show Operator's choice, with no rung or priority when ranking facts were not saved. Released stops and stops sent to manual put-away show their last selected alternative as Turned down. Expand Technical details for the rank formula, population, route order, pick visits, and density inputs. Older saved details appear as a labelled list. Use Close to return to the tour.

The saved data explains this Location and its saved alternatives; it does not explain every Location that was considered.

Users limited to certain Merchants can open a tour only if it includes at least one line of their Merchants, and they see only those lines. The header totals still cover the whole tour, and a note such as Showing 4 of 30 lines. Lines of other merchants are hidden. explains the difference.

Reason Wording

The tour view describes each reason in plain words, while the Scanner shows a shorter name. Both name the same reason. See Directed Destination Reasons for what each reason in that table means.

Tour viewScanner
Home location of this productActive home
Pick location that needs stockOpen pick-face need
Slotting Rule preferenceSlotting Rule preference
Best available location for this productBest available slot
Preferred by the warehouse tiebreaker settingsPreference tie-break
Chosen by the operatorOperator override
No suitable location foundNo feasible destination
Too many possible locations to planToo many candidates
All planned locations were rejectedAlternatives exhausted
Lot information requiredLot Info required

The Tours Tab on a Put-Away

The Tours tab on a Put-Away's page lists every revision of its tours, newest first, with the Tour #, Revision, Status, Started by, Started, Duration, Lines placed, Overrides, Skips, and Manual columns. Use the page controls to browse the revisions. It has no date limit, which makes it the way to reach tours older than the grid's one-year Started range. Click a row to open the tour view. The tab is hidden when the Put-Away has no tours or your role lacks Operations > Put-Away Tours > View.

Limitations

  • Started by credits the user who started the tour. If someone else resumes it, the tour stays credited to the first user.
  • A line skipped a second time goes to manual put-away with the reason All planned locations were rejected. Check the line's Skips and Picking columns to tell a skipped line from one whose Locations were all turned down.
  • When a tour cannot be started and the Scanner shows Directed put-away is not yet available, nothing is recorded, so failed starts do not appear on this screen.