Skip to main content

Definition

A stock item conflict occurs when a stock item is assigned to fulfill an order but no longer holds a valid reservation in the inventory system. The item is committed to the order on paper, but the underlying unavailability record that blocks other bookings from claiming it is missing. Conflicts require attention because the conflicted item may have been double-booked or its reservation was cleared by another operation. Until resolved, the order’s fulfillment is at risk.

When does a conflict occur?

A stock item on an order is flagged as conflicting when all five conditions are true:
  1. The item is assigned to an inventory article (it references a specific physical item)
  2. The item has no resolved unavailability reservation (the hold that blocks competing bookings is missing)
  3. The rental period has not ended (the return date is in the future or not set)
  4. The item is not in a terminal state (not returned or cancelled)
  5. The parent order is live (not archived and not deleted)
Common causes:
  • A scheduled event or maintenance window cleared the item’s unavailability
  • The item was manually unassigned from its inventory article and reassigned
  • A capacity reallocation moved the reservation to a different slot
  • The stock item was archived: on its own, with its SKU and Archive stock items too, or with its location and Archive stock items. Archiving releases the unit’s future holds, and the confirmation counts the affected bookings before you confirm. Each one needs a replacement unit.
  • The stock item was set Inactive. Its upcoming bookings on orders still being prepared are released, and the confirmation lists them before you confirm. A unit out with a customer keeps its hold and shows a Unit inactive chip on the order line instead of a conflict. Making the stock item Active again does not restore the released bookings.
  • Make available freed the unit from an order item not handed out yet, and “Leave the item without a unit” was chosen, or no other unit of its kind was free.

Archiving an order clears its conflicts

Archiving an order releases its future holds: the order will not be fulfilled, so the capacity goes back into the pool. That leaves the order’s stock items without a reservation. It has the shape of a conflict, but it is expected cleanup rather than something to resolve. The fifth condition is what keeps the archive’s own cleanup from surfacing as a conflict. An archived or deleted order’s stock items are suppressed everywhere conflicts appear:
  • The Orders table banner and Has conflicts column
  • The order detail banner
  • The Stock Items tab badge
Bringing the order back with Unarchive makes it live again, and its stock items surface as conflicts once more. The released holds are not recreated, so each item needs a reassignment. Archiving the stock item is the opposite case. It releases the item’s future holds while the orders holding it stay live, so those orders are flagged with conflicts and each needs a replacement unit.

Where conflicts appear

TWICE Commerce surfaces conflicts in two places in the admin.

Orders table

Orders table showing a conflict warning banner

Conflict warning banner on the Orders table

When any orders have stock item conflicts, a warning banner appears at the top of the Orders table:
Some orders have conflicts — N orders have stock items that need attention.
Click View orders on the banner to filter the table to only orders with conflicts. You can also:
  • Filter the Has conflicts column to Yes to find affected orders
  • Group by the Has conflicts column to separate clean orders from those needing attention
  • Spot conflicted orders by their highlighted order number (error-colored background on the order number chip)

Order detail page

Order detail page showing an unavailable stock items banner

Conflict banner on the order detail page

On an individual order, a red banner appears when any assigned stock item is in conflict:
Unavailable stock items — Some stock items are not available anymore.
The count on the Stock Items tab turns red. Open the tab and click a unit: the panel of a unit in conflict reads “This unit is no longer reserved for this item over its dates.” with Claim unit again beside it.

Resolving conflicts

Put the line back on a unit that holds its dates: claim the same unit again when nothing else holds it, or assign a free one under Change stock item and save. Saving creates the hold, and the flag clears once every unit on the order holds one. Resolve a stock item conflict walks through it.
The conflict count on the orders table is scoped to your selected service locations. Switch locations to see conflicts at a specific site.

When no unit is free

When every other unit reads Committed, the conflict stays until you decide. Pick one: Claim unit again cannot take a unit the store itself blocks, such as a maintenance reservation: the dialog lists it under Blocked in your inventory. End or shorten the reservation on the unit’s Events tab first, or delete it. The list only offers units at the order’s pickup location.

Capacity-aware resolution

When resolving conflicts that involve capacity-constrained inventory, TWICE Commerce uses a capacity-aware approach:
  • If a slot is already free for the requested period, the new reservation is created without disturbing other bookings
  • If reallocation can free a slot (moving another booking to a different physical item), the swap is performed automatically
  • Only when no slot can be freed does TWICE Commerce flag overlapping reservations that need manual intervention
This minimizes disruption to existing bookings when resolving conflicts.

FAQs

The most common cause is a scheduled event or maintenance operation that cleared the unavailability record. Capacity reallocations and manual inventory changes can also remove reservations.
Not necessarily. Open the unit’s panel on the order and read the Current row under Change stock item. Available means the hold went missing and nothing else has the unit, so Claim unit again puts it back. Committed means another order or a reservation holds the unit over those dates, which is a real double-booking.Trust that chip on a conflicted item. It leaves out the item’s own hold, and a conflicted item has none, so it shows the unit’s real availability.
Conflicts do not block order processing, but they indicate that the assigned item may not be available when the customer arrives. Resolving them promptly prevents fulfillment surprises.
No. A conflict clears when you reassign the stock item, when the order reaches a terminal state (returned or cancelled), or when the order is archived. The system detects conflicts but requires manual resolution.
The banner only appears when at least one order at your selected service location has a stock item conflict. If you have no conflicts, the table displays normally.

Stock Item State

How In and Out state tracks physical item location.

Order Lifecycle

Order status, payment, and fulfillment dimensions.

Stock Items Tab

Managing assigned stock items on an individual order.

Resolve a stock item conflict

The step-by-step routine for clearing conflicts.

Auto-Fulfillment

Automatic stock item assignment and reservation.