From Silos to Sales: Your Step-by-Step Guide to Integrating ERPNext with WooCommerce

By WovLab Team | April 30, 2026 | 8 min read

Why Integrating ERPNext and WooCommerce is a Game-Changer for Your Business

In the world of e-commerce, efficiency is not just a buzzword—it's the bedrock of profitability. For businesses running on the powerful, open-source ERPNext platform, the decision to integrate ERPNext with WooCommerce is one of the most impactful strategic moves you can make. This integration transforms two standalone systems into a unified commercial powerhouse, eliminating the data silos that create costly errors, drain employee time, and frustrate customers. Imagine a world where a customer order on your WooCommerce storefront instantly and automatically creates a sales order in ERPNext, updates inventory levels across both platforms, and initiates the fulfillment process without a single manual keystroke. That’s not a future fantasy; it's the immediate reality of a properly configured integration. By connecting your e-commerce front-end with your back-office brain, you create a seamless flow of information. This translates into real-time inventory accuracy, preventing stockouts and overselling. It means your financial data is always current, as sales, taxes, and shipping fees are automatically logged in your ERP. Customer data is centralized, providing a single source of truth for marketing, sales, and support teams. This isn't just about saving time; it's about building a scalable, resilient business ready for growth.

Key Insight: A successful integration doesn't just connect two software platforms; it merges your sales operations with your business management, creating a single, intelligent system that drives growth and efficiency.

The benefits ripple through every department. Your accounting team gets accurate, real-time financial reporting. Your warehouse staff has precise fulfillment queues and inventory counts. Your customer service team can answer order status questions instantly and accurately. For management, it provides a crystal-clear, data-driven view of the entire business operation, from website clicks to final delivery. This is the competitive edge that allows you to focus less on manual data entry and more on what truly matters: growing your brand and serving your customers.

Prerequisites: What You Need Before Starting the Integration

Jumping into the integration process without laying the proper groundwork is like building a house on a shaky foundation. To ensure a smooth and successful project, you must have several key components in place first. Think of this as your pre-flight checklist. Missing any of these items will lead to delays and frustrating troubleshooting sessions down the line. First and foremost, you need stable, accessible instances of both ERPNext (Version 13 or higher is recommended) and WordPress with the WooCommerce plugin installed. Ensure both are updated to their latest stable versions to benefit from the most recent features and security patches. Next, you will require administrative access to both your ERPNext site and your WordPress backend. This is non-negotiable, as you'll be generating API keys and configuring settings that are only available to top-level users.

Here’s a more detailed breakdown of the essential prerequisites:

• ERPNext Instance: A running instance of ERPNext, preferably on a server with a static IP address and a valid SSL certificate (HTTPS) to ensure secure communication.
• WooCommerce Site: A live WordPress website with the WooCommerce plugin installed and configured with your basic store settings (currency, location, etc.).
• API Credentials: You will need to generate a set of REST API keys from your WooCommerce store. These keys act as the secure username and password that allow ERPNext to communicate with your store. We'll cover how to generate these in the next step.
• System Permissions: In ERPNext, the user account performing the setup must have permissions for the "Integrations" module, as well as roles that allow creating and modifying Sales Orders, Customers, and Items.
• Backup Strategy: Before you begin, perform a complete backup of both your ERPNext site and your WordPress database and files. This is your safety net. If anything goes wrong, you can restore to a known good state.

Finally, it's wise to have a clear plan for your data. Know which data points you want to sync. Are you syncing all products or just a subset? How will you map customer fields? Answering these questions beforehand will make the configuration process much more straightforward and prevent scope creep.

Step-by-Step: Configuring the WooCommerce Connector in ERPNext

With the prerequisites handled, it's time to dive into the core configuration. ERPNext's built-in integration tools make this a surprisingly straightforward process. Follow these steps carefully to establish the connection between your ERP and your e-commerce store. The key is to be methodical and double-check each setting before saving.

1. Generate WooCommerce API Keys:
   • Log in to your WordPress Admin dashboard.
   • Navigate to WooCommerce > Settings > Advanced > REST API.
   • Click "Add key".
   • Give the key a description you'll recognize, like "ERPNext Integration".
   • Set the permissions to "Read/Write". This is crucial for two-way data sync.
   • Click "Generate API key". WooCommerce will now show you a Consumer Key and a Consumer Secret. Important: Copy these to a secure location immediately. You will not be able to see the full secret key again once you leave this page.
2. Locate the WooCommerce Settings in ERPNext:
   • Log in to your ERPNext desk.
   • In the "Awesome Bar" (the main search bar), type "WooCommerce Settings" and press Enter.
3. Configure the Connection:
   • In the WooCommerce Settings page, click "Enable WooCommerce".
   • In the "WooCommerce Server URL" field, enter the full URL of your website, including the "https://" prefix. For example: https://www.yourstore.com.
   • Paste the Consumer Key from step 1 into the "WooCommerce Consumer Key" field.
   • Paste the Consumer Secret from step 1 into the "WooCommerce Consumer Secret" field.
   • Click the "Save" button at the top of the page.
4. Test the Connection: After saving, a "Test Connection" button may appear (depending on your ERPNext version), or you can proceed to the synchronization steps to verify. The system will attempt to communicate with your WooCommerce store using the credentials provided. A success message confirms that the two systems are now connected. If you get an error, it's typically due to an incorrect URL or API key, or a firewall blocking the connection.

Pro Tip: When entering the server URL, make sure it's the root URL of your WordPress site, not a link to the admin panel. The API endpoints are standardized, and ERPNext knows where to find them based on the base URL.

Once saved and verified, ERPNext is now linked to WooCommerce. The next critical stage is to define exactly *how* data will be synchronized between them.

Mapping Your Data: How to Synchronize Products, Inventory, and Customers

Establishing the connection is just the first step; the real magic happens when you tell the systems how to talk to each other. This is where you map data fields, set synchronization rules, and define the single source of truth for your business information. A poorly planned mapping strategy can create more chaos than it solves, so a thoughtful approach is critical. The goal is to create a seamless flow of information for your most vital data points: products, customers, and inventory levels. For instance, should a new product be created in ERPNext first and then pushed to WooCommerce, or the other way around? For most businesses, managing products in the ERP is the most robust solution. ERPNext becomes the master database for item codes, descriptions, and pricing, which then updates the public-facing storefront.

Here’s a practical guide to mapping your core data:

Product Synchronization: In your ERPNext WooCommerce Settings, you'll find sections for syncing items. A best practice is to use ERPNext as the "master" for product information.

• UOM (Unit of Measure): Ensure the UOM in ERPNext (e.g., "Nos", "Kg") is correctly mapped to how you sell items.
• Price List: Select the ERPNext Price List that will be used to update the "Regular Price" in WooCommerce. You can have different price lists for different channels, but one must be designated for the website.
• Inventory Sync: When you check "Sync items from ERPNext to WooCommerce," new items created in ERPNext can be pushed to your store. You can specify an Item Group to limit which products get synced.

Inventory Level Synchronization: This is arguably the most critical function. Real-time stock levels prevent overselling and customer disappointment.

• In ERPNext, specify the Warehouse that corresponds to your e-commerce inventory. When an order is placed on WooCommerce, the stock level in this ERPNext warehouse will be reduced.
• Conversely, when new stock is received in that ERPNext warehouse, the updated quantity is automatically pushed to the corresponding product in WooCommerce.

Customer and Order Synchronization: When a new customer places an order on WooCommerce, this is how the data should flow:

1. A new Customer record is created in ERPNext using the details from the WooCommerce order. ERPNext is smart enough to check if a customer with that email already exists to avoid duplicates.
2. A new Sales Order is created in ERPNext, linked to the new or existing customer. This order will contain the exact items, quantities, taxes, and shipping charges from the WooCommerce transaction.
3. This ERPNext Sales Order is then the starting point for your fulfillment, delivery, and invoicing workflow.

The table below shows a common mapping configuration: