Inventoros 2.6.1
This release adds backorders: a sales order can be accepted for more than is on hand and held from shipping until the stock arrives. Backorders are off until an administrator turns them on, so nothing changes for an organization that does not use them. The full list is in the changelog.
Backorders
- Turning it on: tick the master switch under Settings > Organization >
Backorders, then Allow backorder on each product that may be sold short.
An optional default ticks the product toggle on new products. Over the REST
API, products accept and return
allow_backorder. - Placing an order: a short line is split into units fulfilled from stock and units on backorder. Only the fulfilled units leave stock. The order shows a banner and each short line shows its split. The web app, REST, GraphQL and MCP all follow the same rule.
- Shipping together: an order with units on backorder cannot be shipped. Creating a shipment, and setting the status to shipped or delivered by any route, is refused until every line is fulfilled.
- When stock arrives: outstanding backorders for the product are filled
oldest order first. This happens on purchase order receipts and any other
stock increase, from the Fulfil backorder button on the order (needs
manage_stock), and from theinventory:reconcile-backorderssweep every fifteen minutes. - Cancel, reject, delete and edit: only the units that left stock are returned. Editing recomputes the split. If backorders have been turned off since, an edit keeps the units already on backorder but cannot add more.
- The orders list has a Backordered filter. Pick lists show only the units
in stock, and order webhooks include
backordered_atand each line'squantity_fulfilledandquantity_backordered.
Not covered yet: preorders scheduled by a release date, drafting a supplier purchase order for the shortfall, and shipping the available part of an order early.
See backorders. (#453, #454)
Upgrade
Back up the database, .env (with APP_KEY), uploads and installed plugins
first. Requirements are unchanged from 2.6.0.
Migrations
Three migrations add columns. Each has a default, so existing rows need no changes:
products.allow_backorder, falseorder_items.quantity_backordered, 0orders.backordered_at, null
Scheduler
inventory:reconcile-backorders runs every fifteen minutes. An install that
already runs php artisan schedule:run every minute picks it up without
changes.
How to update
-
Docker and Coolify: pull the 2.6.1 image and recreate the app, worker and scheduler. The app runs the migrations on start. Never use the in-app updater in a container.
-
Linux installer:
sudo bash install.sh --version 2.6.1. -
cPanel, Composer and other in-app updates: Admin > Update.
-
Source (git):
git fetch --tags && git checkout v2.6.1 composer install --no-dev --optimize-autoloader npm ci && npm run build php artisan migrate --force php artisan optimize php artisan queue:restart
Coming from 2.5.0 or earlier, read the 2.6.0 upgrade notes first.