# WooCommerce Integration

# WooCommerce Integration

The WooCommerce integration connects your WooCommerce online store with NexWave, enabling bidirectional synchronisation of orders, products, stock levels, and customer data.

## Data Flow Overview

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC8wNWEyMDE1OS1hY2Q3LTQyOGYtOTY2NS05Y2ViY2EzMDNiMTQvd29vY29tbWVyY2UtZGF0YS1mbG93LnN2ZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMjAxNDAwLCJleHAiOjE3OTMyODc4MDB9.8C2q6wLcARifXG4Pl0XT8h7OdXAJNGR3he5Br5Ftb2I " =700x389")

## Features Overview

### Sales Order Synchronisation

**Direction:** WooCommerce → NexWave

* Automatically creates Sales Orders in NexWave from WooCommerce orders
* Supports webhook-based real-time sync for instant order creation
* Auto-submit Sales Orders during synchronisation (configurable)
* Configurable Sales Order series naming
* Delivery date offset configuration
* Custom status mapping between WooCommerce and NexWave order statuses

### Order Sync Flow

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC9jNWEzY2FmNy0wOGJmLTQzMGItOWQyYy1hNjUxMmY4MjRjMTMvd29vY29tbWVyY2Utb3JkZXItZmxvdy5zdmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5MzIwMTQwMCwiZXhwIjoxNzkzMjg3ODAwfQ.bkWsCBsvEza7c4FOHQI2XWneUCohAOBjW9y1TlrVR8I " =700x629")

### Bidirectional Order Status Sync

* Keep NexWave Sales Order status and WooCommerce order status synchronised
* Customisable status mapping (e.g., "To Deliver" → "Processing")
* Automatic status updates when either system changes
* Support for custom WooCommerce order statuses

### Sales Order Line Sync

**Direction:** NexWave → WooCommerce

* Changes to Sales Order items can sync back to WooCommerce
* Add, remove, or modify line items and reflect changes in WooCommerce
* Useful for order adjustments after initial creation

### Item Synchronisation

**Direction:** Bidirectional

* Create NexWave Items from WooCommerce products
* Item naming options: WooCommerce ID or Product SKU
* Image synchronisation from WooCommerce product images
* Custom field mapping between WooCommerce product fields and NexWave Item fields

### Stock Level Synchronisation

**Direction:** NexWave → WooCommerce

* Push stock levels from NexWave warehouses to WooCommerce
* Multi-warehouse support - aggregate stock from multiple warehouses
* Reserved stock adjustment - subtract reserved stock before syncing
* Prevents overselling by keeping WooCommerce stock accurate

### Price List Synchronisation

**Direction:** NexWave → WooCommerce

* Sync item prices from a NexWave Price List to WooCommerce
* Configurable delay per item to manage server load
* Keep product pricing consistent across systems

### Customer Synchronisation

**Direction:** WooCommerce → NexWave

* Automatically create Customers from WooCommerce orders
* Option to use a single Customer for all orders (guest checkout handling)
* Dual account support for same email (private vs company accounts)
* Address synchronisation with configurable naming conventions
* Route specific order statuses to order customer (e.g., trade orders)

### Tax Handling

* Sync tax lines from WooCommerce orders
* Option to use "Actual" tax type for exact tax amounts
* Map to Sales Taxes and Charges Template
* Configurable tax account for tax line items

### Payment Entry Synchronisation

**Direction:** WooCommerce → NexWave

* Automatically create Payment Entries for paid WooCommerce orders
* Map WooCommerce payment methods to NexWave Bank Accounts
* Map WooCommerce payment methods to GL Accounts
* Handle orders without "Date Paid" field (some payment gateways)

### Shipping Methods Sync

* Map WooCommerce shipping methods to NexWave Shipping Rules
* Apply correct shipping charges and rules to Sales Orders

### Order Fee Lines

* Sync WooCommerce order fee lines (e.g., handling fees)
* Configurable GL account for fee lines
* Tax account mapping for taxable fees

### Order Item Custom Fields

* Map WooCommerce order item meta data to NexWave Sales Order Item fields
* Extract custom product options or variations

## Plugin Support

### Advanced Shipment Tracking

Integration with the "Advanced Shipment Tracking" WooCommerce plugin:

* Sync shipment tracking information
* Access shipment provider configurations
* Update tracking details from NexWave

## Technical Features

### Webhook Support

* Real-time order synchronisation via WooCommerce webhooks
* HMAC signature verification for secure webhook handling
* Automatic webhook configuration

### Request Logging

* Optional logging of all WooCommerce API requests
* Useful for debugging and monitoring sync operations
* View logs in NexWave

### Multi-Server Support

* Connect multiple WooCommerce stores to a single NexWave instance
* Each server has independent configuration
* Per-server company, warehouse, and account mappings

## Data Flow Summary

| Data | WooCommerce → NexWave | NexWave → WooCommerce |
|------|-----------------------|-----------------------|
| Orders/Sales Orders | ✓                     | Status only           |
| Order Items | ✓                     | ✓ (optional)          |
| Products/Items | ✓                     | Field updates         |
| Stock Levels | \-                    | ✓                     |
| Prices | \-                    | ✓                     |
| Customers | ✓                     | \-                    |
| Addresses | ✓                     | \-                    |
| Payments | ✓                     | \-                    |
| Tax  | ✓                     | \-                    |
| Shipping | ✓                     | \-                    |

## Related Documentation

* [Selling](/doc/9611c59c-fa49-4d68-ae8d-435ff4e26eed)  - Sales Order management in NexWave
* [Stock](/doc/42e81da0-a3bc-4f24-a596-63df62a260ae)  - Inventory management