Out of Stock in the POS

Out of Stock in the POS

1. Enabling the Feature in Back Office

  1. Sign in to Back Office.

  2. Navigate to Stores and select the target store.

  3. Open Store settings and go to the General tab.

  4. Enable Prevent ordering out-of-stock items.

  5. Click Save.

  6. Sync POS for the store to push the updated configuration to registers.

Important: The feature is not active on POS until the sync is completed. Always sync after changing this setting.

2. How POS Enforces Stock Checks

When the feature is enabled, POS performs a real-time stock check at every point where inventory could be consumed.

Triggered actions:

Adding an item to cart

Checks available stock against requested quantity

Increasing item quantity

Re-checks stock including quantity already in cart

Confirming a matrix variant selection

Checks stock for the selected variant specifically

Confirming a modifier for a recipe product

Checks ingredient stock consumed by the modifier

Key calculation rule: POS always accounts for the quantity of the same item (or ingredient) that is already in the current cart before comparing against available stock.

3. Behavior by Product Type

Standard Products

POS checks the product’s own stock level.

  • If the stock is zero or unavailable, POS blocks the add action entirely.

  • If the requested quantity plus cart quantity exceeds available stock, POS blocks the action and shows how much stock remains.

  • The quantity of the same item in the cart is always included in the check.

Products with ingredients

POS checks the ingredient stock rather than the product’s stock directly, because Products with ingredients are built from components.

  • Ingredient usage already consumed by other lines in the current cart is included in the check.

  • If selected modifiers require additional ingredients, those ingredients are validated as well.

  • If any ingredient is out of stock, the Products with that ingredient cannot be added.

  • If a modifier’s required ingredient is out of stock, that modifier cannot be applied.

Matrix Products

POS checks the stock for the specific variant selected by the cashier, not the matrix parent.

  • The quantity of the same variant already in cart is included in the check.

  • If the selected variant has insufficient stock, POS blocks the action and displays a stock error.

  • Other variants of the same matrix product are not affected.

    POS Error Messages Reference

    Standard product fully out of stock

    Out of Stock. This item cannot be added to the cart.

    Standard product — quantity exceeds stock

    Insufficient Quantity. Total stock is {stock_amount}.

    Ingredient out of stock

    The ingredient '{ingredient_name}' is out of stock. This item cannot be added to the cart.

    Modifier ingredient out of stock

    The modifier "{modifier_name}" cannot be applied because the ingredient "{ingredient_name}" is out of stock.

    Matrix variant — insufficient stock

    Stock error shown at variant confirmation step

    Troubleshooting

    Use this guide when stock blocking is not working as expected.

    1

    Back Office setting — confirm Prevent ordering out-of-stock items is enabled for the store

    2

    POS sync — confirm the register has completed a successful sync after the setting was saved

    3

    Connectivity — check network status on the register; look for an inventory load error message on the POS screen

    4

    Wait and retry — POS performs automatic inventory refreshes; waiting for the next cycle may resolve transient data issues

    • Related Articles

    • Partial Payments

      Overview Your customers can partially pay for a transaction at one time and pay for the rest at a later time, from the Split Payments screen. Requirements Can only be performed by Administrator, Manager, and Salesperson employee roles. ...

    • Upgrading Version of eHopper POS

      Overview Every time a new upgrade is available, you will have the option of upgrading to the new version of eHopper on Google Play or continuing to use your existing version of eHopper. After the upgrade has started on one of your registers, all ...

    • RMX POS Device Software

      1. Connect the device to a power source: 2. Connect the device to your router via an ethernet cable: 3. Power on the device using the power button at the bottom of the screen: 4. The device will start loading, and you POS app and other basic ...

    • Logging In and Logging Out of POS

      Overview To log into eHopper POS on your device, install the eHopper POS app. Then, input your Account ID, License key, and PIN number, which was provided to you in your welcome email. You can log out of POS from the left navigation menu. ...

    • Enable Dark Mode for POS Screen

      Overview By default, your POS screen will be light, however, you can enable dark mode to make the screen a darker shade. This is helpful to prevent glare in dark locations that have a lack of daylight, such as nightclubs, bars, or restaurants.    ...