CAZ WooSync is a Frappe Framework app that installs on any ERPNext instance via the standard bench toolchain. It requires no external services, no paid accounts, and no middleware. The WooCommerce ERPNext setup guide below assumes you have ERPNext installed and a WooCommerce site accessible over HTTPS. For local development testing, ngrok is recommended to expose your ERPNext instance to WooCommerce webhooks.

WooCommerce ERPNext setup guide — four-step installation: bench get-app, WooCommerce API key, Caz Woo Store record, webhooks and bulk import by CodeAtoZ

The first step in this WooCommerce ERPNext setup guide is installing the CAZ WooSync Frappe app from GitHub. Run the following commands from your ERPNext bench directory. The install takes one to two minutes depending on server speed.

bench get-app https://github.com/codeatozcom/CAZ_WOOSYNC
bench --site your-site.local install-app caz_woosync
bench --site your-site.local migrate
bench restart

After bench restart, navigate to your ERPNext instance and confirm the Caz Woosync module appears in the top navigation. If it does not appear, run bench clear-cache and hard-refresh your browser. This completes Step 1 of this WooCommerce ERPNext setup guide.

Step 2 of this WooCommerce ERPNext setup guide is generating the REST API credentials that CAZ WooSync will use to communicate with WooCommerce. In your WordPress Admin panel, go to WooCommerce → Settings → Advanced → REST API and click Add Key.

• Description: CAZ WooSync
• User: Select an admin user with full store access
• Permissions: Read/Write — both directions require write access
• Click Generate API Key
• Copy the Consumer Key (ck_...) and Consumer Secret (cs_...) — they are shown only once

Step 3 of this WooCommerce ERPNext setup guide is creating the store record that connects ERPNext to your WooCommerce site. Go to ERPNext → Caz Woosync → Caz Woo Store → New.

• WooCommerce URL — your WordPress site URL (e.g. https://myshop.com), no trailing slash
• Consumer Key — paste the ck_... key from Step 2
• Consumer Secret — paste the cs_... secret from Step 2
• Company — select your ERPNext company
• Warehouse — select the warehouse to use for inventory sync
• Income Account — select the revenue account for Sales Invoices
• Click Save — a webhook secret is auto-generated
• Click Test Connection — you should see “Connected ✓”

The final step in this WooCommerce ERPNext setup guide is installing webhooks and seeding your ERPNext with existing WooCommerce data. On the Caz Woo Store record, click Install Webhooks. This registers six webhook types in WooCommerce automatically — order created/updated, product created/updated, customer created, and refund created. Webhooks use HMAC-SHA256 verification with the auto-generated secret.

After webhooks are installed, run the Bulk Import to bring your existing WooCommerce data into ERPNext. Go to ERPNext → Caz Woosync → Caz Woo Import, select your store, tick Customers, Products, and Orders in that order, and click Start Import. The import runs in the background via the queue — monitor progress in the Caz Woo Queue dashboard. Once the import completes, your WooCommerce ERPNext setup guide is done and live sync is active.

# Queue not processing — check workers
bench doctor

# Force queue processing manually
bench --site your-site.local execute caz_woosync.tasks.process_sync_queue

# Local dev — expose ERPNext to WooCommerce webhooks
ngrok http 8080