Help · Products & Assortment · Warehouse & Inventory

Warehouse & Inventory

Under Settings → Checkout → Inventory, you can specify whether your store sells items beyond available stock, what customers see when items are out of stock, and whether orders deduct from inventory. This guide covers the settings, inventory levels per item and per variant, multiple warehouses, reorder points, and how to track every inventory change.

At a Glance

  • Never sell more than you have in stock: “Check Inventory” at true and “Allow Checkout” at false. By default, the store sells items even when they’re out of stock.
  • In-store inventory: “Product Quantity (In Stock)” minus “Safety Stock.” For attributes, the smaller value between the item quantity and the value inventory applies.
  • Deduction: With “Adjust Stock” (enabled by default), each order is deducted from stock upon completion, and a cancellation is credited back.
  • Sold Out: Show, hide, or set to inactive. You can reactivate items set to inactive yourself after receiving the goods.
  • Tracking: An item’s “Log (History)” shows every recorded inventory change, including the time and the person who made the change.

In this guide

Not covered in this guide: Delivery times and traffic light profiles (Guide: Creating & Maintaining Products), Setting up characteristics and variants ( Product Attributes Guide), the availability alert in detail ( Product Notification Guide), and checking in via barcode scanner ( xoScan Guide).


Where to Find What

The rules for inventory are all located under Settings → Checkout → Inventory. You can manage inventory either for individual items or for multiple items at once.

You want to…Location in the BackendSection
specify whether the store sells items even when they’re out of stockSettings → Checkout → InventorySettings
Change an item’s inventoryProduct Details, “General” tabInventory per item
Change the inventory for a size or colorItem screen, “Attributes” tab, “Product Quantity” fieldFeatures & Variants
Change multiple stock levels at onceProducts → Quick Updates or CSV ImporterUpdate multiple stock levels
Create multiple warehousesProducts → Inventory ManagementMultiple Warehouses
See what’s out of stockReports → Sold-Out ProductsOut of Stock
Check who changed the inventoryItem action menu, “Log (History)”Log
Change the delivery time when stock is 0Products → Traffic Light ProfilesDelivery Status

Enable Inventory Management

By default, the store sells every item, even if it’s out of stock, and still deducts the quantity from inventory for every order. You can specify whether the store checks inventory and limits sales under Settings → Checkout → Inventory.

Settings → Checkout → Inventory: List of 17 settings, including "Check Inventory" (true), "Adjust Stock" (true), "Allow Checkout" (false), "Sold Out/Out of Stock" (true), "Advanced Inventory" (false), and "Hide High Stock Counts Starting at X 10"

Under Settings → Checkout → Inventory, you’ll find the inventory rules, which are set here to “Never sell more than is in stock.” Click to enlarge.

SettingBy the BookEffect
“Check Inventory”falseThe shopping cart, the off-canvas shopping cart, and the checkout page check whether the quantity is in stock and display messages such as “Only 2 pieces available” (the word “pieces” comes from the item’s sales unit; without a unit, it says “Only 2 available”). The remaining checks depend on this setting.
“Proceed to Checkout Allowed”truetrue: Customers can still order more than is in stock; the shopping cart simply issues a warning. false: The store never sells more than the available stock, limits the quantity, and blocks the checkout process.
“Stock Check in Checkout Steps 4 & 5”falserepeats the check on the order summary and at checkout; this line is hidden—only XONIC Support can change it
“Adjust Inventory”trueOrders deduct from inventory; cancellations and returns are credited back. On false, sales do not affect inventory.
“Sold Out/Out of Stock”falseItems with a stock level of 0 or less display “Out of stock!” instead of the shopping cart button. This is a prerequisite for the availability alert.
“Hide Sold-Out Products”falseHides items with zero or less inventory from categories, search results, and product lists; see “Sold Out”
“Set sold-out products to inactive”falseDisables items and attribute values as soon as a transaction reduces their quantity to less than 1
“Hide high stock quantities,” “Hide high stock quantities starting at X”true, 10If the store displays inventory, it will only show “More than 10 in stock” when there are more than 10 units; see Delivery Status
“Advanced Inventory Management,” “Advanced Inventory Management – Debit Rule”false, sort_orderMultiple warehouses; see Multiple Warehouses
“Reorder Point Warning Check,” “Recipient of the Delivery Stock Notification”0, blankWarning email for low stock; see Reorder Point

Three typical settings

Never sell more than is in stock

  • “Check Inventory”: true
  • “Allowed at checkout”: false
  • “Adjust inventory”: true
  • Optional “Sold Out/Out of Stock”: true so that sold-out items display “Out of stock!” and customers can sign up for notifications.

Continue selling, but issue a warning

  • "Check inventory": true
  • "Proceed to Checkout": true
  • The shopping cart displays “Only 2 items available” and “Some products are not in stock in the desired quantity. Your order will be shipped as soon as all items are available.” You can limit individual items using “End-of-Life (EOL)”; see individual items.

Without inventory management

  • “Check inventory”: false
  • "Checkout allowed": true
  • “Sold out/unavailable”: false
  • If you do not want inventory to be tracked at all, also set “Adjust Inventory” to false.
Check inventory levels before making the change. Because “Adjust Inventory” is enabled by default, many stores have items listed with a quantity of 0 or less without anyone having noticed it so far. If you set “Allowed at checkout” to false, these items will immediately become unavailable for order. Under Reports → Out-of-Stock Products, you can view all items and attribute values with zero or negative stock levels in advance.

What Customers See When Stock Is Low

In the store, inventory is calculated as the “Product Quantity (Warehouse)” minus the “Safety Stock”; if there are multiple warehouses, the inventory of the public warehouses is also included. When performing an attribute selection, the smaller value between the product quantity and the attribute quantity applies.

SituationProduct pageShopping Cart
Stock is sufficientShopping cart button as usualNo notes
Quantity exceeds stock, “Checkout allowed” trueShopping cart button as usualItem marked in yellow with “Only 2 available” or “Out of stock,” along with the message “Some products are not in stock in the desired quantity …”. The checkout remains open.
“Checkout allowed” false or items on saleThe “+” button stops at the stock level; if there are only a few items left, it displays “Maximum order quantity: 3 items” or “Add up to 2 more items.” If there is no stock, the button displays “Maximum order quantity reached”; for clearance items, it displays “Unfortunately no longer available.”The store reduces the quantity to the available stock and displays “The quantity of ‘…’ has been reduced from 5 to 3 (limited availability).” If there is no stock, it removes the item. Only when stock is less than 0 does the item remain marked in red and the checkout remain locked.
“Sold Out/Unavailable” true and stock of 0 or less“This product is out of stock!” appears instead of the shopping cart button; in lists, it displays “out of stock!”. If the availability alert is enabled, the “Availability Alert” button appears.The item cannot be added to the shopping cart.
Shopping cart with two items: The lunchbox with a quantity of 5 is marked in yellow with “Only 2 available,” and above it is the message “Some products are not in stock in the desired quantity. Your order will be shipped as soon as all items are available,” and to the right, the active “Checkout” button

With “Proceed to Checkout Allowed” set to true, the shopping cart only displays a warning, and the checkout remains open. Click to enlarge.

Why is the shopping cart button missing?

  • "Sold out/out of stock" is displayed on true, and the quantity is 0 or less. The button then reads "This product is out of stock!"
  • "Checkout allowed" is displayed on false (or the item is on sale), and either there is no stock left or everything is already in the shopping cart: "Maximum order quantity reached."
  • The “safety stock” is equal to the “product quantity (warehouse).” In this case, nothing is available for the store.
  • With multiple warehouses, stock is only available in warehouses that are not public or restricted to the customer group.
  • If this applies only to a specific size or color, the stock for that attribute value is 0; see Attributes & Variants.

Why isn’t the plus button responding?

The quantity selector stops at the highest allowed quantity. With “Allowed at checkout” set to “ false ” or “In sale,” this is the stock minus what’s already in the shopping cart. In the shopping cart itself, it stops at the stock level.

A “Maximum Order Quantity” set for the item or packaging units also limits the quantity; see the guide on Creating & Maintaining Products.

The “Inventory Management” toggle applies to the shopping cart and checkout, not to the product page. If it is set to “No” for an item, the shopping cart and checkout will not check this item. The product page will still calculate based on its “Product Quantity (In Stock)”: With “Checkout Allowed” set to false, it limits the quantity to this value; with “Sold Out/Out of Stock” set to true, the shopping cart button is missing when the quantity is 0. Therefore, for such items, enter a sufficiently high stock level, such as 9999.

Why Customers Return to the Shopping Cart

With “Check Inventory,” the store verifies the inventory in the shopping cart and at checkout once more before initiating payment. If the inventory is insufficient and “Checkout Allowed” is disabled or the item is on sale, it sends the customer back to the shopping cart.

  1. When the shopping cart is opened and during the “Shipping” and “Payment” steps, the store compares each quantity with the available stock.
  2. If there is less in stock than ordered, it adjusts the quantity to match the available stock and displays the message: “The quantity of ‘…’ has been reduced from 5 to 3 (limited availability).” If the item is out of stock, it removes the item: “‘…’ has been removed from your shopping cart (no longer available).”
  3. From the checkout, the customer is then redirected to the shopping cart, checks the quantities, and proceeds to checkout again.
  4. With “Stock Check in Checkout Steps 4 & 5,” the store repeats the check on the order summary and at checkout completion. This setting is disabled by default and hidden in the backend; please contact us if you need it.
  • Typical cause: Another customer purchased the last remaining items, an import reduced the inventory, or the inventory for a specific attribute value is lower than expected.
  • Keeps coming back: If an item’s stock is below 0, the store cannot reduce the quantity. The customer is redirected back with every attempt until you correct the stock or they remove the item. Set “Sold Out/Out of Stock” to true, and such items won’t even end up in the cart in the first place.
  • Express Checkout: The store won’t display Stripe’s Express button as long as stock levels are blocking checkout.

Stock per Item

You manage inventory in the “General” tab of the product edit screen. If you have multiple warehouses, a table appears there with one row per warehouse.

Item Master, General tab: Inventory Management yes, Sales (EOL) no, table with main warehouse (number of products 12, safety stock 2, reorder point 5, storage location Shelf A-03) and the Chemnitz satellite warehouse (30, 0, 10, Hall 2), including the traffic light profile

With advanced inventory management, you can manage stock, safety stock, reorder point, and storage location for each warehouse. Click to enlarge.

FieldMeaning
“Number of Products (Warehouse)”The inventory level. If there are multiple warehouses per location, the first row is the “main warehouse.”
“Safety stock”is deducted from the inventory and not sold in the store, for example, as a reserve for in-store sales
“Reorder Point (Warning when stock reaches...)”Threshold for the warning email; appears only when the reorder level warning is enabled; see Reorder Level
“Storage Location (for Packing List)”Shelf location; appears on the packing list
“Inventory Management”Yes (default): Sales transactions deduct from inventory; the shopping cart and checkout verify it. No: Sales transactions do not deduct from inventory; the shopping cart and checkout do not verify it.
“Clearance (EOL)”Yes: The item cannot be sold beyond the available stock, even if “Allow Checkout” is enabled. This field appears only if “Allow Checkout” is set to “ true.”
The product form saves the value entered in the field. If the store sells the item while you have the form open, saving the form will overwrite that sale. When sales are ongoing, it’s better to post goods receipts in Quick Updates: There, the store uses “Adjust Stock” to post only the difference; see “Change Multiple Stock Levels.”

Managing Inventory for Individual Items Only

Do you want to sell the majority of your inventory freely and limit only remaining stock? You can do this with “Clearance (EOL)”:

  1. Set “Check Inventory” to “ true,” “Allow at Checkout” to “ true,” and “Sold Out/Out of Stock” to “ false.”
  2. For remaining stock, set “Clearance (EOL)” to Yes. These items will only sell while in stock; when out of stock, the button will display “Unfortunately no longer available.”
  3. For all other items, set “Inventory Management” to “No” if you don’t want the shopping cart to display any inventory information for them. For many items, set both switches in the CSV Porter using the fields “Clearance EOL (End of Life)” and “Inventory Management.”

Bundles

With “Calculate bundle stock automatically via bundle products,” a bundle’s stock is determined by its components, and an order deducts the components, not the bundle itself. Setup and toggle options are described in the guide “Create & Maintain Products.”


Inventory per Attribute and Variant

Sizes and colors have their own inventory if you enter it for the attribute value. Variants that are separate items within a product group already maintain their own inventory.

Stock at the Attribute Value

In the “Attributes” tab, each value has a “Product Quantity” field. If left blank, the item’s stock level takes precedence. If filled in, the lower of the item’s stock and the value’s stock applies; therefore, the item’s stock should be at least as high as the highest value stock.

An order placed in the shop deducts from the value-based inventory as long as “Adjust Stock” is enabled. Inventory per combination, such as “Black / M,” is available with a feature group; see the Product Attributes Guide.

Variants as Separate Items

In a product group (master and slaves), each variant is a separate item with its own “Product Quantity (Inventory)” and its own switches. Everything in this guide then applies to each variant. The Product Attributes Guide explains when to use attributes and when to use product groups.

Block Unavailable Values in the Selection

  1. “Check Inventory” and “Sold Out/Unavailable” at true.
  2. Enter 0 for the “Product Quantity” value.
  3. The value will then appear in the selection as “(out of stock!)” and cannot be selected. If the availability alert is enabled, it remains selectable so that customers can be notified about this specific variant.
Product page for the Sample Store Team Shirt: Size M is selected; the "XL (out of stock!)" option is grayed out; next to it are the quantity selector and the active "Add to Cart" button

A variant value with a stock level of 0 appears in the selection as “(out of stock!)” and cannot be selected as long as the availability alert is turned off. Click to enlarge.

Temporarily removing a variant

You want to…Here’s how
keep the value visible but not sell itSet the “Number of products” for the value to 0, and use the settings from the section above
Hide the value completelyIn the “Attributes” tab for the value, set the “Status” toggle to “Inactive” and save.
Hide a variant of a product groupSet the variant’s “Product Status.” It will disappear from the master item’s selection.
Keep it visible and deliver it laterSet the “Release Date” to a future date; see the guide “Create & Maintain Products”

Caution when importing attributes: If your CSV file for attributes does not include a column for status, every import will reset all values in the file to “Active.” Include this column if you are deactivating values manually.


Delivery Status When Stock Is 0

The delivery time in the store is derived from the item’s traffic light profile. The stock level determines which stage applies.

Level for “Out of Stock”

Under Products → Traffic Light Profiles, each profile has the level “1. Standard” and additional levels “starting at” a certain “stock level.” The “1. Standard” level applies as long as the stock level is below the threshold for the second level—including when it is 0 or lower.

Example: Level 1 “Delivery time 10–14 days,” Level 2 “Available immediately” starting at 1. If the item is sold out, the store displays the delivery time for Level 1, even if you continue to sell it with zero stock.

More on delivery times

For instructions on how to create profiles, assign them to items, and modify them for multiple items, see the guide “Creating & Managing Products”; for delivery times during the ordering process, see the guide “Shipping & Delivery.” For items without “Inventory Management,” the inventory level does not change; simply enter a value that corresponds to the desired level.

Displaying Inventory in the Store

Go to Settings → Design → Product Listing → Show Stock Level at true to display “12 in stock” on the product page, in lists, and in the shopping cart. With “Hide high stock quantities,” the store displays only “More than 10 in stock” above the value “Hide high stock quantities starting at X.” The Google Merchant Center & Product Feed guide describes how stock levels are displayed in the Google product feed.


Sold-Out Items

If an item is out of stock, it can remain visible, disappear, or be disabled. All three options are found under Settings → Checkout → Inventory.

Display

“Sold out/out of stock” on true: The item remains in listings and search results, displays “Out of stock!” and cannot be purchased. Customers can sign up for availability alerts.

Hide

“Hide sold-out products” on true: Items with no stock are omitted from categories, search results, and product lists. With “ partial,” items with a future release date remain visible. Wishlists and notifications in the customer account continue to show saved items.

Set as Inactive

“Set sold-out products to inactive” on true: If a transaction reduces inventory to less than 1, the store deactivates the item; if an order is placed, the attribute value is also deactivated. This requires “Adjust inventory”; items without “Inventory Management” remain active.

The shop does not reactivate items that have been set to inactive. Neither a goods receipt nor a cancellation makes them visible again. After posting the transaction, manually set the “Product Status” back to active; for multiple items, go to Products → Quick Updates and use the filter for inactive items. Only deleting an order with “Credit item quantity to inventory” will reactivate them as soon as stock is available. For the availability alert, leave this setting disabled; inactive items do not trigger a notification.

Removing Sold-Out Items from a Promotional Category

This is handled by a “Products” type marketing event with the conditions “Products: Stock” less than or equal to 0 and “Products: In Categories” (your promotional category), and the action “Products: Remove Category Assignment.” The completed example can be found in the Marketing & Automation Guide.XONIC Premium: Marketing / Automatisierungen & Künstliche Intelligenz

Without this add-on module, you’ll need to remove the assignment manually. If you simply want to hide sold-out items everywhere, “Hide Sold-Out Products” is sufficient.

Who is waiting for which item?

  • Reports → Sold-Out Products lists all items and attribute values up to a “max. stock level” that you enter at the top, with the option to export as a CSV.
  • The “Product Notifications” guide describes the availability alert and the “Product Notifications” report. The emails are sent the next time you log in to the backend, provided the item is active and back in stock at that time.

Multiple Warehouses

Under Settings → Checkout → Inventory → Advanced Inventory Management at true, you can manage additional warehouses—such as a remote warehouse or a store—in addition to the main warehouse.

Create a Warehouse

  1. Under Products → Inventory Management, the “Inventory Overview” page opens. Click “Manage Warehouses” and then the “Create New Warehouse” tab.
  2. Set the “Status,” “Public Warehouse,” and “Sort Order”; enter the “Warehouse Name” at the bottom of the language tab; and save by clicking “Update.”
  3. Under “Customer Group Restriction,” choose whether all customer groups can view the warehouse or only selected ones.
  4. Afterward, each product detail screen will display one row per active warehouse showing stock, safety stock, and storage location; if the reorder point alert is enabled, it will also show the reorder point.
Products → Warehouse Management, Edit Warehouse: Status Active, Public Warehouse Yes, Sort Order 10, Customer Group Restriction “Only selected customer groups may access this warehouse” with “Domestic Retailers” set to Yes, Warehouse Name: Chemnitz Satellite Warehouse

A warehouse with customer group restrictions is only included in the store’s inventory for the authorized customer groups. Click to enlarge.

QuestionHow the store calculates
What inventory is displayed in the store?Main warehouse plus all active, public warehouses that the customer’s group is authorized to view, minus safety stock in each case. The main warehouse always counts for everyone.
Why “Public Warehouse”?The inventory is not included in the store’s inventory, and orders placed in the store do not deduct from it. Suitable for merchandise that you first need to inspect or use internally.
From which warehouse is an order deducted?“Advanced Inventory Management – Debit Rule”: “ sort_order ” (factory default) first debits from the main warehouse, then from the remaining warehouses in their sort order. “ lowest_first ” starts with the warehouse that has the lowest inventory. Debits are made only from warehouses with inventory; any remaining quantity is charged to the main warehouse.
Can I change the distribution of an order?Yes, in the order editor: Under “Warehouse Assignment,” you can see for each item how much came from which warehouse. Making a change will adjust the warehouse postings accordingly.
Which inventory do marketplaces receive?Ex-factory, the inventory of all active warehouses. For each marketplace, select individual warehouses under “Multichannel” in the marketplace settings in the “Warehouses to Consider” field.
Where are returns posted?To the warehouses from which the items were sold, or to a separate returns warehouse; see theOrder Management Guidefrom 4.10

The “Inventory Overview” tab under Products → Warehouse Management shows the inventory and safety stock for each item across all warehouses; if the reorder point warning is enabled, it also displays the reorder point. If advanced inventory management is disabled, only the main warehouse is considered; the other warehouses remain saved.


Reorder Point and Reordering

If an item’s stock level drops to its reorder point, the store sends a list via email. This allows you to reorder in a timely manner.

Set Up a Low-Stock Alert Email

  1. Under Settings → Checkout → Inventory, under “Reorder Level Warning Check,” enter how many days the shop should check—for example, “ 1 ” for daily. “ 0 ” disables the warning.
  2. Under “Recipients of the Stock Level Notification,” enter one or more email addresses.
  3. The “Reorder Threshold (Warning when reached...)” field now appears on the product page, with separate fields for each warehouse if there are multiple warehouses. Enter the threshold.
  • The store checks whenever someone logs in to the backend and the specified number of days have passed since the last email. There is no schedule that runs without a login.
  • The email will include every item whose “Product Quantity (Warehouse)” in a warehouse is equal to or below the reorder point. The safety stock is not deducted for this purpose; a reorder point of 0 does not trigger anything.
  • You can maintain the reorder point for many items in Quick Updates (“Show Reorder Point” under Settings → General → Quick Updates) or in the CSV Porter using “Reorder Point,” with “Reorder Point: ” for each warehouse.

Purchase Order for the Supplier

From a purchase order, you can send a purchase order form to the supplier. The “Supplier Actions” button appears in the purchase order only if

  • at least one item in the purchase order is assigned to a supplier (Item screen, “General” tab, Suppliers), and
  • the “Supplier Address (PDF)” field is filled out for this supplier under Products → Suppliers.

“Display Purchase Order for …” also requires the document type “Supplier Order (SO)” under Settings → Design → Documents → Documents: Allowed Types, and “Send Order Form & Delivery Note via Email to …” requires a valid “Supplier’s Email Address.” For more information, see the Orders Guide.


When the store updates inventory

Stock is only debited and credited using “Adjust Stock” at true and for items with “Stock Management” enabled.

ProcessEffect on Inventory
Order in the storeis deducted from inventory upon order completion, not just upon receipt of payment or shipment. Items and their attribute values are deducted; for bundles, the individual components are also deducted. An unpaid order retains its inventory until you cancel or delete it.
Modifying an Order in the Order EditorAdding a new line item deducts the quantity; deleting one restores it; changing the quantity deducts the difference.
Orders from marketplaces and via the interfaceare also posted. Whether the BillBee import posts orders is determined by a separate setting under Settings → Interfaces → Inventory Management/ERPs/Accounting → BillBee, which is disabled by default.
Changing to a cancellation statusreverses all items without returns, including attribute inventory. The status that counts as a cancellation is defined by “Order Status: Canceled” (Settings → General → Module Options, available only to the main administrator).
Saving a canceled order againdoes not post the order again; only the change to the cancellation status counts.from 4.9.145
Returns in the Returns Editorposts the returned quantity and removes the exchange items. If you modify the return, the store posts only the difference. Returns from before the update are not posted; until then, youmust post returns manually at the item level. from 4.9.145
Delete OrderWith “Credit item quantity to inventory” (preselected if “Adjust inventory” is enabled), the store posts the return.
Quoteis not posted until you convert it into an order; seethe Orders Guideabfrom 4.10
Quick UpdatesPosts the difference to the main inventory; without “Adjust Inventory,” it sets the new value
Product Details, CSV ImporterSet the inventory to the entered or delivered value
xoScanAdds to or replaces the inventory, depending on the inventory posting mode; see the xoScan guide

The Orders Guide describes in detail how returns, cancellations, and quotes are processed.


Tracking Inventory Changes

Every posted inventory change is recorded in the item’s “Log (History)” along with the date and time, the person who processed it, and the old and new values.

Open the log

  1. Under Products → Categories / Products, select “Log (History)” from the item’s context menu. In the item screen, the same entry appears as a tab at the top.
  2. The “Admin” column lists the person who made the change. “System” appears for entries made without a logged-in employee, such as orders placed in the shop.
  3. “Changes” shows the old and new values for each field. The inventory is listed as “ products_quantity,” and stock lines are listed under “ products_to_storages.”
  4. “Information” lists the reason, such as “Order No. 1234” or “Cancellation/Return (Order Status Update).” Changes from Quick Updates appear under the heading “Standard Change” with the note “Quick Update.”
Log (history) for the "Musterladen" lunchbox with three entries: a quick update by Anna Beispiel (products_quantity changed from 1 to 5) and two entries by the system with order number 1038 (5 to 4) and order number 1042 (4 to 2)

For each transaction, the log shows the user who made the change, the time, the old and new inventory levels, and the reason. Click to enlarge.

  • The store displays the log only to the main administrator. If that is not your account, our support team will review it for you.
  • The shop deletes entries that are older than one year.
  • Entries made with xoScan and changes to products via the REST interface are not included in the log. Orders placed via the interface are included.
  • The log records the attribute inventory when the product screen is saved, not when orders are placed.

Inventory Value

The shop does not provide a report or log detailing the value of your inventory. Export “Inventory” and “Purchase Price (net)” using a data importer and calculate the values in a spreadsheet; see the Import & Export Guide. Reports → Profit Calculation. The “Products” screen displays the purchase price, selling price, and stock level for each item.


Bulk Update Inventory

There are three ways to process a goods receipt or inventory count: Quick Updates in the backend, a CSV file, or the barcode scanner.

Quick Updates

Under Products → Quick Updates, the “Stock” column is displayed as long as Settings → General → Quick Updates → Edit Product Quantity is set to “ true ” (default). “Show Reorder Point” displays the “Reorder Point” column. Filter by category, manufacturer, supplier, or status, change the values, and save.

With “Adjust Inventory,” Quick Updates posts only the difference to the main warehouse and logs “Quick Update” in the log. For items without “Inventory Management,” Quick Updates does not change the inventory; you must change it in the item screen.

CSV Porter

Fields “Stock Level,” “Safety Stock,” “Reorder Point,” “Storage Location,” “Inventory Management,” and “EOL (End of Life) Sales,” with multiple warehouses per warehouse: “Stock: ,” “Safety Stock: ,” and “Reorder Point: .” The import sets the value from the file. See the Import & Export Guide for instructions.

If a Porter only maintains individual warehouse fields—such as the reorder point per warehouse—the remaining warehouse values remain unchanged.from 4.9.94

xoScan

Using the barcode scanner, you can record goods receipts and inventory counts directly at the shelf, with multiple warehouses, into a selectable destination warehouse. See the xoScan Guide for procedures and limitations.

Via the REST Interface

An inventory management system updates stock levels via the xoPort REST interface. The warehouse fields ` products_quantity`, ` products_safe_quantity `, and ` products_reorder_level ` are available for each additional warehouse in the field ` storages`. The API documentation describes these fields and the registration process; see the Import & Export Guide.

The interface writes the reporting inventory and safety stock of the main warehouse as fields in the product.from 4.9.16


Change Note Texts for Out-of-Stock Items

The texts in the shopping cart and on the product page are stored in the language files. You can change them under Tools → xoLanguage by entering your own value, as described in the Languages & Translation Guide.

Text Ex WorksWhere it appearsSection and Key
“Only 3 in stock,” “Out of stock”at the corresponding location in the shopping cart, in the off-canvas shopping cart, and on the order summary“default”: TEXT_CART_OUT_OF_STOCK, for one item TEXT_CART_OUT_OF_STOCK_SINGLE, TEXT_CART_OUT_OF_STOCK_NONE
“Some products are not in stock in the desired quantity. …”in the shopping cart, checkout open“store-checkout-cart”: OUT_OF_STOCK_CAN_CHECKOUT
“Unfortunately, some products in your shopping cart are no longer available. …”In the shopping cart, checkout disabled"store-checkout-cart": OUT_OF_STOCK_CANT_CHECKOUT
“The quantity of '…' has been reduced from … to … …”, “'…' has been removed from your shopping cart …”In the shopping cart, if the store has reduced the quantity“default”: TEXT_CART_QTY_ADJUSTED, TEXT_CART_QTY_REMOVED
“This product is out of stock!”, “Out of stock!”Button on the product page or in lists, addition to attribute values"default": IMAGE_BUTTON_SOLD_OUT, IMAGE_BUTTON_SOLD_OUT_LIST
“Unfortunately no longer available”Button for clearance items with no inventory"default": IMAGE_BUTTON_EOL_OUT
“Maximum order quantity reached”Button when no more items can be added"default": TEXT_MAXBC_CART
“12 in stock,” “More than 10 in stock”Stock display"default": IN_STOCK_INFO, IN_STOCK_INFO_MASKED

The fields “Show out of stock” and “Show out of stock and on clearance (EOL)” under Settings → Checkout → Inventory are not displayed in the default layout. They only work in custom templates that include them.


Frequently Asked Questions

How do I prevent orders when an item is out of stock?

Under Settings → Checkout → Inventory, set “Check Inventory” to true and “Allow Checkout” to false. The store will then limit the quantity to the available stock and block the checkout if there are too many items in the cart. Check beforehand which items have a quantity of 0; see Settings.

Why is the shopping cart button missing since the stock check is enabled?

The item is out of stock: If “Sold Out/Unavailable” is selected, the button displays “This product is out of stock!”; if “Allow Checkout” is set to false, it displays “Maximum order quantity reached.” Check the product quantity and safety stock; for variants, check the stock for the attribute value—see In the Shop.

Why can’t I increase the quantity using the plus button?

The plus button stops at the stock level if “Checkout Allowed” is off or the item is on sale. If there’s already something in the cart, only the remaining quantity is available. A maximum order quantity for the item also limits the quantity.

Why does the customer keep being redirected to the shopping cart during checkout?

The quantity exceeds the stock level, and the store won’t sell beyond that. It reduces the quantity and redirects the customer back. If the stock level is below 0, it cannot reduce the quantity and will redirect the customer back with every attempt; in that case, correct the stock level—see Checkout.

Why does the payment fail if there’s more in the shopping cart than is in stock?

The store checks inventory before payment: With “Check Inventory” set to true and “Checkout Allowed” set to false, it reduces the quantity during the shipping and payment steps and redirects the customer to the shopping cart. If you want customers to be able to order even if the quantity exceeds stock, set “Checkout Allowed” to true; see Checkout.

Can I track inventory only for individual clearance items?

Yes. Leave “Allow Checkout” set to true and set “Clearance (EOL)” to Yes for clearance items. Only these will then be subject to stock limits. For the remaining items, set “Inventory Management” to No to remove the stock notices from the shopping cart; see Individual Items.

How do I block unavailable sizes or colors from the selection?

Set “Check Inventory” and “Sold Out/Unavailable” to true, and enter 0 for the “Product Quantity” attribute value. The item will then appear in the selection with the label “(Out of stock!)” and cannot be selected as long as the availability alert is turned off; see Attributes & Variants.

How do I temporarily remove a variant from sale?

Visible but not orderable: Set the value’s stock to 0. Hide completely: Set the “Status” to “Inactive” for the value; for a variant listed as a separate item, set the “Product Status” to off. An attribute import without a status column will re-enable the values.

How do I control the delivery status when stock is 0?

Via the “1. Standard” level of the traffic light profile under Products → Traffic Light Profiles. This applies as long as the stock level is below the second level. Enter text and delivery time for out-of-stock items there; see Delivery Status.

How do I automatically remove sold-out items from a promotional category?

Using a marketing event: Conditions “Products: Stock” less than or equal to 0 and “Products: In Categories,” Action “Products: Remove Category Assignment.” This requires the XONIC Premium add-on module: Marketing / Automations & Artificial Intelligence; see Sold Out.

Why are sold-out items still inactive after goods receipt?

“Set Sold-Out Products to Inactive” deactivates items but never reactivates them. Set the product status to active yourself after booking them in—for multiple items, use Quick Updates.

How do I change inventory levels using Quick Updates?

Under Products → Quick Updates, filter the list, enter the new values in the “Inventory” column, and save. If the column is missing, set Settings → General → Quick Updates → Edit Product Quantity to true; see “Change Multiple Inventory Levels.”

Can I change the reorder point for each warehouse via the API?

Yes. The xoPort REST API writes the reorder point for each auxiliary warehouse in the field “ storages,” and that of the main warehouse (starting with XONIC) as “ 4.9.16 ” in the product’s fields. In CSV-Porter, this field is labeled “Reorder Point: ”; see “Changing Multiple Stock Levels.”

How do I check who changed an item’s inventory?

In the item’s “Log (History)”: in the action menu under Products → Categories / Products. The “Admin” column lists the editor, and “Changes” shows the old and new values. Only the main administrator can view the log; see Log.

How do I see how sales have affected inventory?

Also in the “Log (History)”: Each order is listed there with “Order Number …” under “Information” and the stock levels before and after the order was posted. The store deletes entries older than one year.

Where can I find the inventory value?

The shop does not provide such a report. Export the inventory and purchase price using a tool like Excel and calculate the value in the spreadsheet.

Does a return adjust the inventory?

Starting with XONIC 4.9.145, yes: The return posts the returned quantity to inventory and removes exchange items. Returns from before that date are not posted; you must post returns from that period to the item itself—see Postings.

Why is the button for the supplier order missing?

No item in the order is assigned to a supplier, or the “Supplier Address (PDF)” is missing for the supplier. Additionally, “Supplier Order” must be included among the allowed document types for the order form; see Supplier Order.

How do I change the messages for out-of-stock items in the shopping cart?

Under Tools → xoLanguage, enter a custom value—such as “Out of Stock”—in the “default” section or the message above the shopping cart in “store-checkout-cart.” The list of all texts can be found under Message Texts.

How do I enable the availability alert, and why did a customer receive a notification?

To do this, “Sold Out/Out of Stock” and “Product Notification Feature (Availability Alert) On/Off” must be set to true. The email is sent the next time you log in to the backend, provided the item is active at that moment and has a stock level greater than 0. See the Product Notification guide for details.

Related Guides

We'll Help You Set It Up

We’ll work with you to set up inventory management, multiple warehouses, and reorder points, and determine why an item is unavailable for order.

Contact Support Now