Warehouse

Warehouse stores stock quantities for Products in Comers.

It lets you organize stock into Warehouses that match how your business actually separates inventory, keeps quantities up to date as orders come in, shares available stock with your sales channels, and records every change in the movement history.

flowchart TD
    O[Order received] --> R[Reserve stock]
    R --> A[Available quantity changes]
    A --> C[Connected channel quantities updated]
    R --> D{Order outcome}
    D -->|Fulfilled| F[Reserved stock leaves inventory]
    D -->|Cancelled| X[Reservation returns to available stock]
    A --> H[Movement history]
    F --> H
    X --> H

Warehouses that match your stock pools

A Warehouse in Comers is a stock-management context. It does not have to map one-to-one to a physical building.

For example, you can use:

• one shared Warehouse for stock sold through several channels,
• separate Warehouses for different Sellers,
• separate Warehouses for specific sales-channel accounts,
• another structure that matches how your organization separates stock.

Choose the structure based on the real stock pools you need to distinguish operationally.

Stock items

A stock item represents stock tracked inside one Warehouse and is connected to a Product or Product variant.

A Product can have stock items in more than one Warehouse. Listings can display and use the corresponding stock context through the Product and stock relationships.

Automatic stock updates

Stock follows your orders automatically. When an Order arrives from a connected channel, Comers updates the stock of the Products it contains:

• reservation: the ordered quantity is reserved as soon as the Order is received, so the same units cannot be sold twice,
• fulfillment: when the Order is fulfilled, the reserved quantity leaves stock,
• cancellation: when an Order is cancelled, its reservation returns to available stock.

Each change is recorded in the movement history together with the Order that caused it.

Quantities shared with sales channels

Listings connected to a Product use the stock of its stock items. When the available quantity changes, Comers sends the new quantity to the connected sales channels.

One real stock pool can therefore be sold through several marketplaces and stores at the same time, without keeping separate quantities in each of them.

Adjustments

Adjustments record changes that do not come from orders, such as physical counts or damaged items, together with the reason for the change. Channel quantities follow the corrected stock in the same way.

Typical reasons include:

• establishing initial stock,
• correcting the quantity after a physical count,
• removing damaged items,
• recording another warehouse correction.

Instead of rewriting old history, each adjustment adds a new, explained entry.

Example:

• quantity before: 25
• physical count: 22
• adjustment: -3
• reason: Recount

The resulting history shows what changed, not only the latest number.

Movement history

Warehouse keeps a complete stock-change history, so every quantity can be understood in context.

Each movement shows which stock item changed, the quantity difference, the reason, and the Order or person behind the change.

Relationship with Products and Listings

Products uses Warehouse as the source of stock information for Products with stock items.

A Listing remains a channel offer rather than a second stock ledger. When several Listings sell the same real stock, they share it through the Product and Warehouse model instead of keeping unrelated quantities.

Recommended initial setup

1. Create or import the Products you want to track.
2. Create the Warehouse or Warehouses that represent your stock pools.
3. Create stock items for the relevant Products.
4. Record starting quantities with adjustments.
5. Review stock from Warehouse and from the related Product context. From then on, orders and channel quantities keep it up to date automatically.