Troubleshoot stock blocks

Goal

Resolve “insufficient stock” and related blocks on sales, POS, transfers, and issues.

Who it is for

Inventory and sales clerks; managers adjusting policy.

Preconditions

• Know tenant out-of-stock policy: block | allow_negative (tenant setting; Settings UI settings.oos.*).
• Default provisioned policy is often allow_negative — block is what surfaces hard stops.

Common problems

Symptom	Likely cause	What to do
inventory.insufficient_stock	Policy block and qty after movement < 0	Receive/transfer in, pick another warehouse, reduce qty
Unexpected negative allowed	Policy allow_negative	Expected — change tenant setting if you need hard blocks
Wrong warehouse	Line warehouse differs from stock location	Align warehouse on the document line
Transfer/adjustment still blocked	Per-reason inventory setting flags	Review inventory settings for adjustment/transfer/count exceptions
POS line fails	Same stock service rules on the register warehouse	Check on-hand via stock lookup; replenish

Steps

1. Confirm on-hand for item + warehouse.
2. Check tenant out-of-stock policy with an admin.
3. Receive stock or change the document line warehouse/qty.
4. Retry post / POS tender.

Result

Movements post when availability and policy allow.

Related

• Receive stock
• Sales posting
• Tenant settings