WooCommerce Integration Setup

📋Before You Start

• WordPress site with WooCommerce plugin installed and active
• WooCommerce version 3.5 or higher (REST API v3 required)
• WordPress admin access
• Your store URL must be publicly accessible (not localhost)

🔧Setup Steps

1. 1
   Create WooCommerce REST API keys

   In WordPress admin, go to WooCommerce → Settings → Advanced → REST API. Click Add key. Fill in: Description: "Pythias Integration", User: select an admin user, Permissions: Read/Write. Click Generate API key.
2. 2
   Copy Consumer Key and Consumer Secret

   WooCommerce will display your Consumer Key and Consumer Secret. These are only shown once — copy both immediately. If you navigate away without copying, you will need to revoke and regenerate a new key pair.
3. 3
   Enter credentials in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → WooCommerce. Enter: your Store URL (e.g., https://yourstore.com), your Consumer Key, and your Consumer Secret. Click Test Connection and then Save.
4. 4
   Set permalink structure (important)

   WooCommerce REST API requires pretty permalinks to be enabled. In WordPress admin, go to Settings → Permalinks. Make sure it is set to anything other than Plain (e.g., Post name). Click Save Changes even if you do not change anything — this flushes the rewrite rules.

🔄What Gets Synced

• ✓New WooCommerce orders in Processing status (pulled every 5 minutes)
• ✓Order line items, product IDs, variation IDs, quantities, and shipping address
• ✓Shipment tracking number and carrier pushed to WooCommerce order notes
• ✓Order status updated to Completed in WooCommerce

💡Tips & Troubleshooting

• ⚡If you get a 401 authentication error, verify that pretty permalinks are enabled and that the Consumer Key/Secret belong to an admin user.
• ⚡WooCommerce's REST API endpoint is at <code>/wp-json/wc/v3/</code> — Pythias constructs this automatically from your store URL.
• ⚡For high-traffic stores, consider using WooCommerce webhooks mode (available via Pythias support) for near-instant order sync instead of polling.
• ⚡Variable products: Pythias maps to the <em>variation ID</em> and <em>variation SKU</em> — make sure each WooCommerce variation has a unique SKU assigned.