How do warehouse mapping and fulfillment location groups determine which warehouse an order ships from, and why can inventory go negative in a fallback warehouse?

Last updated: November 10, 2026

Luminous picks the warehouse (warehouse group) for an order in one of three ways. Which one applies depends on the channel the order came in on and on a few settings. The "fallback" behavior that can push availability negative comes from the Always create setting, which is described below.

1. Channel type decides the routing method

Channel type

How the warehouse is chosen

End-to-End or Fulfillment channel (with an order-push mapping set up)

Luminous uses the warehouse group set on the channel. It skips priority lists and stock checks for choosing the warehouse.

Sales channel

Luminous uses a fulfillment priority list and picks a warehouse based on stock.

Order linked to a transfer order

Luminous fulfills it from the transfer's origin warehouse.

If an order always lands in the same warehouse regardless of stock, check whether its channel is an End-to-End or Fulfillment channel. Their orders always go to the channel's warehouse group.

2. Sales channels: priority lists

A priority list is an ordered list of warehouse groups. Luminous looks for a list in this order and uses the first one it finds:

  1. The priority list set on the sales order.

  2. The priority list set on the product (SKU).

  3. The system default priority list, set under Operations → Operations Admin → Smart Fulfillment Settings → Default Fulfillment Priority List.

If none of these exists, Luminous can't generate the fulfillment order and reports it as a shortage.

Luminous then goes down the list in priority order. It picks the first warehouse group whose available stock covers the quantity needed. Available stock is on-hand minus pending, totaled across all warehouses in that group. Your Smart Fulfillment settings can change this. For example, they can try to ship the whole order from one warehouse first, or allow lines to be split across warehouses.

Priority lists can also be marked location-aware. With the proximity-based fulfillment feature enabled, Luminous reorders the list by distance from the customer's ship-to postal code. Warehouses need latitude and longitude set to take part. If the postal code can't be found, Luminous uses the list's normal order.

3. Shopify split fulfillment locations

If your Shopify account has Create fulfillment orders from Shopify fulfillment locations turned on, Shopify decides the split and Luminous follows it. Each Shopify location is mapped to a channel through an assigned_location_id filter. That channel's warehouse group is the one the location deducts from.

If a Shopify location has no matching filter, Luminous doesn't create a fulfillment order for it. The shipment stays on the sales order. See How do I make Luminous follow Shopify's split fulfillment locations so inventory deducts from the right warehouse? for setup.

Why a fallback warehouse can show negative availability

When no warehouse group on the list has enough available stock, Luminous does one of two things:

  • Always create is off (the default): It creates no fulfillment order and reports a shortage.

  • Always create is on: The Always Create Fulfillment Orders Even When No Stock is Available setting is set in Smart Fulfillment Settings. Each channel can override it under Manage → Channels → Edit → Auto Fulfillment, with the choices Default, Enabled or Disabled.

That quantity then counts as pending against that warehouse. Because available = on-hand − pending, available goes negative whenever pending is greater than on-hand. The first warehouse on the list is the "fallback" in practice, so that's where the negative number shows up.

How to avoid or fix it

  • Reorder the priority list so the warehouse you want as the fallback is first.

  • Turn off Always create (globally or for that channel) if you'd rather get a shortage report than a negative balance.

  • Fix the stock itself. Check that the warehouse's on-hand quantity is syncing correctly. Also look for stale fulfillment orders for shipped or cancelled orders that are still counting as pending.

  • Check product-level overrides. A SKU with its own priority list can route differently from the rest of the order.

  • Check the warehouse group’s pending setting. Under Manage → Locations → Warehouse Groups → Edit, Include Pending Calculations for This Warehouse Group controls whether pending stock counts toward that group’s available quantity.

If you're not sure why an order went to a particular warehouse, contact support. Give them the order number and the SKU.