Aglet

How to triage an item out of stock at checkout

Inventory conflicts are easiest to misunderstand when the cart, availability display, reservation, and order disagree. Triage should capture one SKU and quantity through checkout, the availability shown to the shopper, and each recorded reservation or release without exposing customer information.

Establish what is happening

  1. Capture availability state

    Record the item identifier, requested quantity, variant, warehouse or fulfillment context, cart timestamp, and availability shown. Use a test fixture where possible. Note whether the cart was restored, shared, or edited after the availability message appeared.

  2. Reproduce the race

    Repeat checkout after another reservation, an inventory update, a quantity change, and an idle interval. Compare cart availability, reservation response, payment eligibility, and order result. Keep the competing action controlled so the timing of the conflict is observable.

  3. Name the blocked boundary

    Mark whether the conflict appears when adding to cart, starting payment, reserving, or creating the order. Compare the message with saved reservation and inventory records. Record oversell risk, lost reservation, and a missing status as separate outcomes.

What to carry forward

Triage is complete when the item and quantity, competing state, timing, and blocking step are reproducible or explicitly intermittent. Preserve the observed inventory and reservation records so investigation can distinguish stale display from a failed reservation or order write.

Keep the decision with the work.

Use a Work Item in Aglet to record the problem, the evidence you have, and the next decision. Add an owner and priority, then keep updates in the discussion so the next person can follow the reasoning.

Create an account See the product workflow