WooCommerce integration

What it does

The WooCommerce integration lets you run ecommerce automations on behalf of any client whose WooCommerce store you manage. Connect a store once, then list and create products, route fresh orders through fulfillment workflows, update order status when shipments leave the warehouse, onboard new customers, pull daily sales reports, mint discount coupons, and react to live store events without writing any code.

Connect a WooCommerce store

1. In TaskJuice, open Settings -> Connections and choose Add connection -> WooCommerce.
2. Enter the full store URL including https:// and without a trailing slash (for example https://shop.example.com). HTTPS is required by WooCommerce for HTTP Basic authentication.
3. In the store's WordPress admin, open WooCommerce -> Settings -> Advanced -> REST API and click Add key. Give the key a recognizable description (such as "TaskJuice"), choose a user with the right scope, and set permissions to Read/Write. Click Generate API key.
4. Copy the Consumer key (it starts with ck_) into the Consumer key field in TaskJuice, and the Consumer secret (it starts with cs_) into the Consumer secret field. WooCommerce only displays the secret once, so capture it before navigating away.

The connection is read- and write-capable across products, orders, customers, coupons, and reports scoped to the WordPress user the API key was generated under. Rotate or revoke the key from the same WooCommerce -> Settings -> Advanced -> REST API page at any time.

Triggers

• woocommerce/order-created. Fires when a new order is created in the store.
• woocommerce/product-updated. Fires when a product is updated (price, stock, status, or metadata change).
• woocommerce/customer-created. Fires when a new customer registers or is created by an admin.

All three triggers verify the inbound POST against an HMAC-SHA256 base64 digest of the request body. In WooCommerce, open WooCommerce -> Settings -> Advanced -> Webhooks, click Add webhook, set the topic (for example Order created, Product updated, or Customer created), paste the TaskJuice incoming webhook URL into the Delivery URL field, paste the shared secret shown in the TaskJuice connection screen into the Secret field, and set the status to Active. WooCommerce signs the raw request body and sends the digest in the X-WC-Webhook-Signature header on every delivery.

Actions

• woocommerce/list-products. List products in the store with filters for status, SKU, category, search term, and last-modified timestamp. Paginated by page number.
• woocommerce/get-product. Look up a single product by ID.
• woocommerce/create-product. Publish a new product with name, type, price, description, SKU, stock settings, and categories.
• woocommerce/list-orders. List orders with filters for status, customer, and created-at window. Paginated by page number.
• woocommerce/update-order. Patch an existing order's status, customer note, or transaction ID (for example to mark an order completed after fulfillment).
• woocommerce/create-customer. Register a new customer with email, name, username, and billing/shipping addresses.
• woocommerce/list-sales-report. Pull the sales report for a pre-defined period (week, month, last_month, year) or an explicit date range.
• woocommerce/create-coupon. Mint a new discount coupon (percent, fixed cart, or fixed product) with usage limits and an optional expiry date.

Known limitations

• WooCommerce enforces a maximum of 100 items per page on list endpoints. TaskJuice stops paginating after 100 pages by default; raise the ceiling on the action if you need a deeper sweep.
• HTTP Basic authentication requires the store to be served over HTTPS. WooCommerce rejects Basic credentials on plain HTTP for production use.
• API key permissions are tied to the WordPress user the key was generated under. Capabilities such as creating coupons or reading reports require that user to hold the matching WordPress role (typically Shop Manager or Administrator).
• The sales report endpoint summarizes the period; for per-order revenue numbers list orders directly with the relevant date filters and aggregate downstream.
• Webhook deliveries that respond with a non-2xx status are retried by WooCommerce up to five times with backoff; after five failures the webhook is disabled and must be re-enabled from the admin.