=== Stockkeel – Multichannel Inventory Sync for WooCommerce ===
Contributors: stockkeel
Tags: ebay, inventory sync, multichannel, oversell, product feed
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sell on eBay and other marketplaces without overselling. Your WooCommerce stock is the single source of truth. Free product feeds included.

== Description ==

Stockkeel keeps one stock count for every place you sell.

* **Your store is the source of truth.** When something sells on any channel, Stockkeel takes it out of your WooCommerce stock and sends the new quantity to every other channel. When something sells in your store, the channels are updated the same way.
* **Channel orders in WooCommerce.** Orders from channels are copied into WooCommerce (you can turn this off), so you ship everything from one place. Mark the order Completed with a tracking number and Stockkeel confirms shipment on the channel. WooCommerce does not email marketplace buyers.
* **Safety buffers.** Per channel, hold back a few units, or show 0 once stock falls to a level you choose.
* **Daily stock check.** Once a day Stockkeel compares every channel listing with your stock and fixes any difference (or only tells you, if you prefer).
* **Nothing fails silently.** Every sale, update and correction is in the Activity log. Failed updates are retried and shown in red, and you get an email.
* **Free product feeds.** One private link with your catalog in Google Merchant Center format, accepted by Google, Microsoft, Meta, Pinterest, Snapchat and TikTok.
* **Your keys stay on your site.** You connect channels with your own developer keys. Stockkeel calls the channel directly from your site and never sends your keys or orders to us.

= Channels =

* eBay (stock sync for listings created in Seller Hub or through the API, order import, shipment confirmation, publishing simple products)
* More channels are being added. Only channels that are fully working are listed here.

= Plans =

Free: 50 channel orders a month, every channel included. Paid yearly plans raise the monthly limit. Only orders that come from channels count. If you go over, stock keeps syncing so you never oversell; only copying new channel orders into WooCommerce pauses until next month.

== Installation ==

1. Install and activate WooCommerce, then Stockkeel.
2. Go to Moorkeel › Stockkeel › Channels and follow the steps for eBay.
3. Click "Find listings and link by SKU". Listings whose SKU matches a store product are linked automatically.
4. Turn on "Track stock quantity" for products you sell on channels. Tracking stock is what prevents overselling.

== Frequently Asked Questions ==

= How fast do channels update? =

When stock changes in your store, the update is queued at once and sent within about a minute. New channel orders are checked every 5 minutes (you can change this), because eBay does not notify sites of new orders. Use "Hold back" or "Sold out at" on a channel to cover that gap for fast-selling items.

= My eBay listing ended when stock reached 0 =

Turn on "Out-of-stock control" in your eBay selling preferences. Listings then stay up and show "out of stock".

= Do you see my orders or keys? =

No. They stay in your WordPress database. See "External services" below for exactly what is sent where.

== External services ==

This plugin connects to these services. Nothing is sent until you set them up.

* **eBay APIs** (api.ebay.com, auth.ebay.com; sandbox: api.sandbox.ebay.com, auth.sandbox.ebay.com) — only after you enter your own eBay developer keys and connect your account. Used to read your listings and orders, set listing quantities, publish products you choose and confirm shipments. Sent: your keys and tokens (to eBay only), SKUs, quantities, prices, product titles, descriptions and image links for products you publish, tracking numbers. eBay terms: https://www.ebay.com/help/policies/member-behaviour-policies/user-agreement?id=4259 — privacy: https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
* **Stockkeel license server** (stockkeel.com) — only if you enter a license key. Once a day it sends the key, your site address, the plugin version and this month's number of channel orders, to check your plan. Terms: https://stockkeel.com/terms — privacy: https://stockkeel.com/privacy
* **Your product feed** is served by your own site. The channels you give the link to (Google, Microsoft, Meta, Pinterest, Snapchat, TikTok) download it from your site.

== Changelog ==

= 0.1.0 =
* First release: eBay stock sync, order import, shipment confirmation, publishing, daily stock check, product feeds.
