Operating journey / step 50

Stock and returns

Troubleshooting

Use this guide when work has reached this point. If the visible state does not match, stop and follow the named hand-off.

Troubleshooting: Returns & Restock Issues

Diagnose an unidentified item, ambiguous inventory match, stale reconciliation, or Shopify disposition problem without restocking by guesswork.

Updated Sept 2026
Owner: Operations Admin
Area: Returns

Before you begin

Resolve common return problems by distinguishing identity, line condition, SKU matching, and restock eligibility.

Prerequisites

  • The Admin can open the return and inspect each line.
  • The client and order reference are known or explicitly unavailable.
  • The matching inventory row can be checked before restocking.

Stop and check

Do not restock an unidentified or non-good line, and do not substitute a guessed SKU.

A return can be physically received and still be unsafe to restock. StoreFulfil needs a supported client and order/return identity, one unambiguous inventory row, a current mapped location, and the required Shopify permission before a good item can move back into stock.

Identify the failure

If The parcel or item cannot be linked confidently

Keep it in the received/unidentified state and attach the observed evidence to the Admin hand-off.

Owner: Warehouse Operator or Warehouse Admin

If More than one inventory row could match

Do not choose one. Resolve the SKU, variant, client, and mapped location ambiguity first.

Owner: Warehouse Admin

If The location or inventory reconciliation is stale

Refresh and review the returned result before attempting restock.

Owner: Warehouse Admin

If The item is damaged or writeoff

Record the disposition explicitly and do not treat it as good stock.

Owner: Warehouse Admin

Allowed dispositions

StateWhat it meansSafe next step
GoodThe item passed warehouse inspection and has an unambiguous inventory target.Restock only after all mapping, recency, and permission checks pass.
DamagedThe item is received but cannot return to normal sellable stock.Record damaged and keep it out of sellable inventory.
WriteoffThe item is not being returned to stock.Record writeoff and preserve the return evidence.
BlockedIdentity, mapping, inventory, or Shopify authority is not safe to complete.Leave the item blocked and escalate the named missing proof.

What this is and when to use it

Use this Admin guide when a returned item cannot be identified, matched, inspected, or restocked safely.

Choose the safe outcome

  1. Keep an unidentified parcel in the received state.
  2. Compare client, order, SKU, variant, and mapped location before choosing a stock row.
  3. Record good, damaged, or writeoff from the physical inspection.
  4. Refresh the relevant stock view before retrying a permitted good-line restock.

Questions and hand-off

If Two inventory rows look possible

Do not choose one by guesswork; resolve the client, SKU, variant, and location first.

If The item is damaged or writeoff

Keep it out of sellable stock and record the condition.

If Restock still fails

Keep the return evidence and visible error and hand it to the Operations Admin.

What happens next

The return is either restocked through the permitted matching row or remains an explicit exception.

Expected Outcome

The return is documented accurately using permitted explicit fields.

Runbook evidence

Use these signals to decide whether the work is ready to continue, complete, or needs an owner.

State checkpoints

Item not identified

The received parcel or item has not yet been linked to a known order or client.

Next: Keep it in the received pile and identify it before creating a restock decision.

Line not eligible

The line is damaged, writeoff, unmatched, or otherwise cannot be restocked.

Next: Record the condition and leave the line out of restock.

Restock failed

A good line was identified but StoreFulfil could not apply the permitted local action.

Next: Keep the evidence and escalate; do not repeat blindly.

Completion evidence

  • The return records every line condition and the resulting restock or exception state.

Escalation evidence

  • Record the client, return, line/SKU, condition, match result, and visible error.

Work safely

Who may take this action

Warehouse Admin

What you should see

The received parcel or item has not yet been linked to a known order or client.

Safe next step

Keep it in the received pile and identify it before creating a restock decision.

What not to do

Do not restock an unidentified or non-good line, and do not substitute a guessed SKU.

How to tell it is complete

The return records every line condition and the resulting restock or exception state.

© 2026 STOREFULFIL PTY LTD (ACN 701 718 649 · ABN 98 701 718 649), Queensland, Australia · StoreFulfil™ Operations Library.