Inventory
Inventory tracks how many of each product you have and where that stock lives. Commerce Kitty supports multiple inventory sources and routes fulfillment based on priority.
How inventory works
Every sellable product has a stock count that Commerce Kitty keeps in sync with the channels where it is listed. When a unit sells on one channel, Commerce Kitty updates the stock and pushes the new count out to every other channel carrying that same product. This is the core job of the app: one sale, one reduction, everywhere at once.
Stock does not live in one big bucket. It lives in inventory sources. A source can be a warehouse, a retail location, a 3PL, or a plugin that fulfills on your behalf.
Inventory sources
An inventory source is a place where stock physically sits, or a service that can ship stock for you. You might have one inventory source called "Main Warehouse" for your own stockroom and another called "Printful" for print-on-demand items. Each source has its own stock counts per product.
Plugins as inventory sources
Some plugins can act as inventory sources themselves. If you fulfill through Printful, the Printful plugin becomes a source that reports "unlimited" or on-demand stock. If you fulfill orders out of your Shopify warehouse, the Shopify plugin can be the source for those products.
Priority-based routing
When an order comes in, Commerce Kitty needs to decide which inventory source will fulfill it. It does this by walking your sources in priority order. The highest-priority source assigned to that order's channel is checked first. If that source has the stock, the shipment is routed there. If not, Commerce Kitty moves to the next source.
This lets you build fulfillment rules without writing any logic. Put your cheapest source first. Put your backup 3PL second. Put your drop-ship plugin last as a safety net.
Inventory source fields
Name
The display name for this source. Something like "Main Warehouse" or "East Coast 3PL".
Code
A unique identifier for the source. Used in imports, exports, and API calls to reference this source directly.
Priority
A number that controls fulfillment order. When multiple sources serve the same channel, the highest priority is checked first. Ties are broken in source creation order.
Channels
The channels this source will fulfill. A warehouse might ship Shopify and Etsy orders but not Amazon FBA orders. Assigning channels scopes the source to only those orders.
Enabled
Whether the source is active. Disable a source temporarily without deleting it, for example while a warehouse is offline or a 3PL contract is paused.
Stock levels
Each source keeps a stock count per product. Those counts can be updated manually, through bulk imports, through the API, or automatically by the plugin that owns the source. When stock goes up or down, Commerce Kitty recalculates total available stock for the product and pushes the new number out to every listing.
The total stock shown on a product is the sum of available stock across every source serving that product. This is what Commerce Kitty sends to each channel.
Make sure at least one source serves each channel your products are listed on. If no source is assigned, Commerce Kitty has nowhere to fulfill from and the channel will show zero stock.