> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/shop-integration-core/woocommerce.md).

# WooCommerce

{% hint style="info" %}
📦 Available on the **Core** plan.
{% endhint %}

WooCommerce orders can flow into FoodCore automatically, and — if you want it — FoodCore can tell WooCommerce when an order is ready. Read [Integrations](https://docs.foodcore.io/shop-integration-core/integrations.md) first if you haven't already, particularly the ordering constraint: the shop record has to exist in FoodCore before WooCommerce has anywhere to send its webhook.

## Orders in

**1. Add the shop in FoodCore**

Go to **Integrations** and add the shop — enter the store's address (for example `yourshop.co.uk`). Press **Connect shop**.

**2. Copy the webhook address**

FoodCore shows a webhook URL on the shop's card once it's created. **Copy it**.

**3. Find WooCommerce's webhook settings**

In WordPress, go to **WooCommerce → Settings → Advanced → Webhooks**.

**4. Add the webhook**

Click **Add webhook** and fill it in:

* **Name**: anything you'll recognise later
* **Status**: Active
* **Topic**: Order created
* **Delivery URL**: the address you copied in step 2
* **API version**: WP REST API Integration v3

**5. Set the secret**

Unlike Shopify, WooCommerce lets **you** choose the secret rather than generating it for you — which means it has to be the **same text in both places**. FoodCore can generate one for you to use here, or you can paste your own; either way, copy it into WooCommerce's **Secret** field exactly as it appears in FoodCore.

**6. Repeat for "Order updated"**

Add a second webhook with the same delivery URL and the same secret, but topic **Order updated**. This keeps a changed order in step with FoodCore.

**If WooCommerce shows a webhook as Paused**, it disabled itself automatically after several failed deliveries — almost always a mismatched secret. Fix the secret so it matches on both sides, set the webhook back to **Active**, then use **Deliver test** to confirm it's working.

## Fulfilment out (optional)

Sending fulfilment back to WooCommerce means FoodCore acts *as* the shop, so it needs a real API key. This is **off by default, per shop**.

**1. Open the REST API tab**

Go to **WooCommerce → Settings → Advanced → REST API** — a different tab from Webhooks, but on the same Advanced settings page.

**2. Add a key**

Click **Add key** and fill it in:

* **Description**: FoodCore
* **User**: an administrator account
* **Permissions**: **Read/Write** — Read alone isn't enough, since FoodCore needs to be able to mark an order complete, not just look it up.

**3. Generate the key**

Click **Generate API key**. Both the **Consumer key** (`ck_…`) and **Consumer secret** (`cs_…`) are shown **once** — copy both before leaving the page, since WooCommerce won't show the secret again.

**4. Paste and test**

Paste both values into FoodCore and press **test**. This makes a harmless read-only call against the store and reports back straight away, so you'll know immediately if something's wrong rather than finding out when the first fulfilment silently fails.

**If the test fails with a 401 on a site that otherwise looks fine**, a security plugin or the hosting provider is usually stripping the `Authorization` header from REST API requests before it reaches WordPress. Their host or plugin support can usually allow it through for the REST API path.

## When fulfilment is sent

Set **"push on status"** to **Ready** or **Delivered** on the shop's card:

* **Ready** suits collection orders — the push is effectively an invitation to come and collect.
* **Ready also fires on Delivered**, so an order that skips the Ready status on its way to Delivered still tells the shop.

If two people mark the same order Ready, only one fulfilment is sent. If the push fails (for example, an expired key), it's retried automatically once the credentials are fixed. If WooCommerce already agrees the order is fulfilled, FoodCore leaves it alone rather than sending a duplicate.

## What's next

* [Integrations overview](https://docs.foodcore.io/shop-integration-core/integrations.md)
* [Shopify setup](https://docs.foodcore.io/shop-integration-core/shopify.md)
* [Order statuses](https://docs.foodcore.io/customer-orders-growth-and-core/statuses.md)
* [Business Insights overview](https://docs.foodcore.io/business-insights-core/business-insights.md)
