Skip to main content

WooCommerce Integration

Deprecated in Version 15

WooCommerce Integration automatically creates Sales Orders in ERPNext whenever a new order is placed in WooCommerce through webhooks. If the related Customer, Item, or Address does not already exist, ERPNext creates them automatically using the order information received from WooCommerce.

Summary

  • Automatically imports WooCommerce orders as Sales Orders.
  • Creates Customers, Items, and Addresses automatically if they don’t exist.
  • Uses WooCommerce Webhooks for real-time order synchronization.
  • Allows configuration of default company, warehouse, taxes, and sales order settings.

Generate WooCommerce API Credentials

  1. Open your WooCommerce dashboard.
  2. Navigate to Settings → Advanced → REST API.
  3. Click Add Key.
  4. Enter the required details.
  5. Click Generate API Key.
  6. Copy the generated Consumer Key and Consumer Secret.

Configure WooCommerce Settings in ERPNext

  1. Go to Home → Integrations → Settings → WooCommerce Settings.
  2. Enter:
    • API Consumer Key
    • API Consumer Secret
    • WooCommerce Server URL
  3. Enable Enable Sync.
  4. Select:
    • Tax Account
    • Freight and Forwarding Account
    • Creation User
    • Company
  5. Click Save.
  6. After saving, ERPNext automatically generates:
    • Webhook Endpoint
    • Webhook Secret

Configure WooCommerce Webhook

  1. In WooCommerce, open Settings → Advanced → Webhooks.
  2. Click Add Webhook.
  3. Enter a webhook name.
  4. Set:
    • Status: Active
    • Topic: Order Created
  5. Copy the generated Endpoint from ERPNext and paste it into the Delivery URL field.
  6. Copy the generated Secret from ERPNext and paste it into the Secret field.
  7. Keep the API Version unchanged.
  8. Click Save Webhook.

Note

Use the Endpoint generated in your ERPNext WooCommerce Settings as the Delivery URL while configuring the webhook. The example URLs shown in screenshots may differ from your actual site URL.

Create and Sync Orders

  1. Create a customer account on your WooCommerce store.
  2. Add billing and shipping addresses.
  3. Add products to the cart.
  4. Proceed to checkout.
  5. Place the order.
  6. ERPNext automatically creates:
    • Customer
    • Address
    • Item (if missing)
    • Sales Order
  7. If synchronization fails, review the Error Log under Home → Settings → Core → Error Log.

Default Configuration Options

The WooCommerce Settings document provides the following default options:

Setting Description
Warehouse Default warehouse used when creating Sales Orders.
Delivery After (Days) Number of days added to the order date to calculate the delivery date.
Sales Order Series Naming series used for Sales Orders imported from WooCommerce.
UOM Default Unit of Measure used while creating Items and Sales Orders.


Result

  • Orders are synchronized automatically using WooCommerce Webhooks.
  • Missing Customers, Items, and Addresses are created automatically.
  • Sales Orders are generated in ERPNext with the configured defaults.

Related Topics

  • Sales Order
  • Item
  • Customer
  • Address
Rating: 0 / 5 (0 votes)

© 2026 | goERPNext | All rights reserved