Table of Contents

  1. Introduction

  2. Why Connect WooCommerce to Dolibarr?

  3. Overview of Key Integration Benefits

  4. What You’ll Need Before Starting

  5. Step 1: Install the Dolibarr WooCommerce Connector Module

  6. Step 2: Configure API Access in Dolibarr

  7. Step 3: Generate API Keys in WooCommerce

  8. Step 4: Link Dolibarr and WooCommerce via Module Settings

  9. Step 5: Set Up Synchronization Rules

  10. Step 6: Test the Connection with Sample Data

  11. Common Sync Options: What Can Be Linked

  12. Managing Products Between Dolibarr and WooCommerce

  13. Handling Customer Data Sync

  14. Synchronizing Orders and Invoices

  15. Stock and Inventory Management

  16. Setting Sync Frequency and Automation

  17. Troubleshooting Common Issues

  18. Security Best Practices for API Connections

  19. Advanced Tips: Using Webhooks for Real-Time Sync

  20. Conclusion and Strategic Optimization Advice

1. Introduction

Integrating your e-commerce store with your ERP system is one of the fastest ways to streamline your operations. If you run your online store using WooCommerce and manage your internal processes with Dolibarr ERP, syncing them can save you hours of manual data entry and eliminate costly errors. Best of all, it can be done in just 15 minutes—without writing a single line of code.

This guide will walk you through each step to connect WooCommerce with Dolibarr using an off-the-shelf connector module.

2. Why Connect WooCommerce to Dolibarr?

Dolibarr handles all the back-office tasks: invoicing, stock management, accounting, CRM, and more. WooCommerce manages the front-end sales. Connecting them ensures:

  • Seamless data exchange

  • Better order fulfillment

  • Real-time inventory updates

  • Accurate financial records

3. Overview of Key Integration Benefits

  • Automatically transfer orders from WooCommerce to Dolibarr

  • Sync product listings and prices in both systems

  • Maintain consistent stock levels

  • Centralize customer data

  • Generate invoices and reports in Dolibarr without copying data manually

4. What You’ll Need Before Starting

  • Active WooCommerce store (WordPress admin access)

  • Running Dolibarr instance (version 14 or higher recommended)

  • Administrator access to both platforms

  • WooCommerce API keys

  • Dolibarr Connector module (available on Dolistore or GitHub)

5. Step 1: Install the Dolibarr WooCommerce Connector Module

  1. Download the module (e.g., woocommerce or woosync) from Dolistore

  2. Upload it to Dolibarr under /htdocs/custom/

  3. Go to Dolibarr > Home > Setup > Modules

  4. Activate the WooCommerce connector module

Some modules offer multi-store support; make sure to check compatibility.

6. Step 2: Configure API Access in Dolibarr

  1. Navigate to Setup > Security > API

  2. Enable REST API access

  3. Create a new API key for WooCommerce

  4. Assign permissions for products, orders, invoices, and contacts

This key allows WooCommerce to push/pull data securely.

7. Step 3: Generate API Keys in WooCommerce

  1. In WordPress, go to WooCommerce > Settings > Advanced > REST API

  2. Click "Add Key"

  3. Name the key (e.g., Dolibarr Sync)

  4. Choose the user and grant Read/Write access

  5. Copy the generated Consumer Key and Secret

You will use this in the Dolibarr connector settings.

8. Step 4: Link Dolibarr and WooCommerce via Module Settings

  1. In Dolibarr, go to the WooCommerce module settings

  2. Paste the WooCommerce site URL

  3. Add the API keys from WooCommerce

  4. Choose the authentication method (usually OAuth1 or Basic Auth)

  5. Save and test the connection

You should see a confirmation message or a connection log.

9. Step 5: Set Up Synchronization Rules

Define how the two systems will talk:

  • Direction: one-way (Woo to Dolibarr) or two-way

  • Frequency: manual, hourly, daily

  • Triggers: order received, stock updated, etc.

Common configuration includes syncing products, categories, orders, and customers.

10. Step 6: Test the Connection with Sample Data

  1. Create a test product in WooCommerce

  2. Confirm it appears in Dolibarr

  3. Place a test order on your site

  4. Check that the order appears in Dolibarr with customer info

If successful, you’re good to go.

11. Common Sync Options: What Can Be Linked

  • Products (SKU, name, price, stock, description)

  • Product categories and tags

  • Orders (status, total, customer)

  • Customers and billing info

  • Invoices (PDF or draft generation)

  • Stock levels per warehouse

12. Managing Products Between Dolibarr and WooCommerce

You can choose your master system:

  • Push product updates from Dolibarr to WooCommerce

  • Or pull from WooCommerce into Dolibarr

Many companies prefer Dolibarr as the master for inventory.

13. Handling Customer Data Sync

Customer records are synced as:

  • Third-party (Tiers) in Dolibarr

  • Linked contacts with email and address fields

Sync includes:

  • Billing and shipping addresses

  • Order history for CRM purposes

14. Synchronizing Orders and Invoices

  • Orders placed on WooCommerce are imported into Dolibarr

  • You can auto-generate a quote or invoice

  • Payment status can also be synced if your store uses Stripe or PayPal

Choose whether invoices are validated automatically or manually.

15. Stock and Inventory Management

Stock updates in Dolibarr can:

  • Push real-time quantity to WooCommerce

  • Prevent overselling via out-of-stock automation

Use multi-warehouse support if needed.

16. Setting Sync Frequency and Automation

Options include:

  • Real-time (using Webhooks)

  • Hourly/daily cron jobs

  • Manual sync via admin panel

Cron setup requires server access or a plugin like WP-Crontrol for WordPress.

17. Troubleshooting Common Issues

  • Connection Error: Verify API keys, URLs, and permissions

  • Sync Delay: Check cron jobs or module logs

  • Mismatched Data: Ensure SKU codes match in both systems

  • API Limit Errors: Limit the number of requests per cycle

18. Security Best Practices for API Connections

  • Use HTTPS for both systems

  • Regenerate API keys periodically

  • Restrict access by IP if possible

  • Log all API requests for audits

19. Advanced Tips: Using Webhooks for Real-Time Sync

For advanced users:

  • Enable Webhooks in WooCommerce

  • Trigger sync on new order or product changes

  • Use plugin like AutomatorWP or Zapier for custom logic

This reduces lag between systems.

20. Conclusion and Strategic Optimization Advice

Connecting WooCommerce with Dolibarr is one of the best ways to automate your business processes. In under 15 minutes, you can achieve a seamless bridge that handles orders, invoices, products, and customers—without manual intervention.

As your business scales, continue optimizing your integration by:

  • Enabling auto-validation of documents

  • Using analytics dashboards in Dolibarr

  • Segmenting customers by order source

A no-code integration not only saves time but enhances accuracy and customer satisfaction. Once in place, this connection turns your Dolibarr ERP into a powerful engine for online retail success.