=== PullPush Sync for WooCommerce ===
Contributors: pullpush
Tags: woocommerce, inventory sync, stock sync, order sync, multichannel
Requires at least: 5.8
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Keep WooCommerce stock and orders in sync with Shopify, Amazon, Linnworks, Tripletex and more — one click, no manual API keys.

== Description ==

PullPush Sync connects your WooCommerce store to **PullPush**, a deterministic multi-tenant sync engine. Stock levels and orders stay consistent across every channel you sell on — no spreadsheets, no overselling, no LLM guessing in the hot path.

**One-click connect.** Paste a connect token from your PullPush dashboard and press Connect. The plugin provisions a read/write WooCommerce REST API key and registers the right webhooks for you. You never copy an API key by hand.

**What syncs:**

* **Stock levels** — bidirectional. A sale on another channel decrements WooCommerce; a WooCommerce sale decrements the others. Simple and variable products (variations) are both supported.
* **Orders** — WooCommerce orders flow to your fulfilment, accounting, or 3PL destination via PullPush.
* **Products** — product and variation changes propagate as configured.

**Safe by design.** PullPush never pushes a `0` for "unknown" — an untracked product is skipped, never wiped to zero. Every change is versioned, observable, and recoverable.

Works great if you run WooCommerce alongside Shopify, Amazon, a POS, or a warehouse system.

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. In your PullPush dashboard, go to Settings → API Keys → create or copy a tenant API key (`pp_…`). That key is your **connect token**.
3. In WordPress, open WooCommerce → PullPush Sync, paste the token, and click **Connect to PullPush**.
4. That's it — the plugin provisions WooCommerce REST keys + webhooks and creates the PullPush connections for you.

If your server can't reach PullPush during connect, the plugin shows generated credentials once so you can paste them into a WooCommerce connection in the PullPush dashboard.

== Frequently Asked Questions ==

= Do I need a PullPush account? =
Yes. Sign up at https://app.pullpush.ai and create a tenant API key (Settings → API Keys) to use as the connect token. Docs: https://pullpush.ai/docs/wordpress

= Does it work with product variations? =
Yes. Stock is tracked per variation (by SKU), and variable products sync as a parent with variants.

= Will it ever set my stock to zero by mistake? =
No. If a product isn't tracking stock, PullPush skips it rather than writing 0.

= How do I disconnect? =
Open WooCommerce → PullPush Sync and click Disconnect. The plugin revokes the API key and removes the webhooks it created.

== Screenshots ==

1. One-click connect screen.
2. Connected status with active webhooks.

== Changelog ==

= 1.0.0 =
* Initial release: one-click connect, stock + order + product sync, HPOS compatible.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
