Stock Counts Are Wrong
When the stock count in Commerce Kitty does not match what you actually have on hand, the cause is almost always one of these. Find the right one before you start manually correcting numbers.
Why this matters
The instinct when stock looks wrong is to just edit the number until it matches. Resist that. If you fix the symptom without fixing the cause, the count will be wrong again next week. Find out why the numbers drifted, fix that, and then correct the count.
Cause 1. SKUs do not match across platforms
The most common cause. The same physical item has different SKUs on different platforms, so Commerce Kitty treats them as separate products. Sales on one platform decrement one product, sales on the other decrement a different product, and neither matches reality.
How to check: Open the product in Commerce Kitty and look at its listings. If the listings are missing for the platforms you expected, the import did not link them. Search the catalog for similar names to see if a duplicate exists.
How to fix: Update SKUs on the source platforms to be consistent, then re-import. Or manually link the duplicate products by editing one to match the other's code.
Cause 2. An order was missed by sync
If a marketplace order was not imported, its inventory impact never reached Commerce Kitty. Stock appears higher than reality.
How to check: Compare the order count in Commerce Kitty against the order count on the source platform for the same time window. If the marketplace shows more orders than Commerce Kitty, something was missed.
How to fix: Verify the plugin has Import Orders enabled and is healthy. Re-run the import for the missing time window if the plugin supports it. For one-off missing orders, you can create them manually.
Cause 3. A return was not recorded
A buyer returned items but the return was processed only on the source platform without flowing back into Commerce Kitty. Stock appears lower than reality.
How to check: Look for recent returns on the source platform that do not show up in Commerce Kitty.
How to fix: Manually add stock back for the returned items. For ongoing returns, talk to support about whether your plugin can be configured to import returns.
Cause 4. Stock was added at the wrong inventory source
If you have multiple inventory sources, stock added at one source does not show up at another. The "total" looks lower than expected because some of the stock is hiding at a different source.
How to check: Open the product or variant and look at the breakdown of stock by inventory source.
How to fix: Move the stock to the correct source, or accept the split and let routing handle it. Channels are matched to inventory sources, so as long as orders route to a source with available stock, things will work.
Cause 5. Sync paused due to a plugin issue
If the plugin lost authorization or hit an error, sync paused and recent sales did not propagate. Counts look right on Commerce Kitty's side but wrong everywhere else.
How to check: Open the sync not working troubleshooting page and work through the steps.
How to fix: Resolve the plugin issue first, let sync catch up, and then verify counts again. Most of the time the numbers correct themselves once sync is running.
Cause 6. A bulk import overwrote your stock
If you ran a CSV import or API update that included stock fields, those values overwrote whatever was in Commerce Kitty. If the source data was wrong, your counts are now wrong.
How to check: Did you run a recent import or use the API to update products? Did the spreadsheet you uploaded have the right stock numbers in it?
How to fix: Re-import with the correct numbers, or correct the affected products individually.
Once you have found the cause
Fix the underlying issue first, then correct the stock count. The add stock to a product page covers how to make the correction itself.