Configuration & Settings

This guide covers all configuration options available in the Woo-NetSuite plugin. Complete these settings after obtaining your NetSuite API credentials.

Accessing Plugin Settings

1. Log in to WordPress Admin Dashboard
2. Navigate to WooCommerce > Settings
3. Click on the NetSuite tab

Alternatively, you can access settings directly:

• Go to WooCommerce > NetSuite > Settings

API Credentials Tab

Enter the credentials you obtained during NetSuite API setup.

Required Fields

Field	Description	Example
Account ID	Your NetSuite Account ID	1234567 or 1234567_SB1
Consumer Key	From Integration Record	abc123def456789…
Consumer Secret	From Integration Record	xyz789uvw012345…
Token ID	From Access Token	token123456789…
Token Secret	From Access Token	secret987654321…

Test Connection Button: After entering credentials, click Test Connection to verify API access.

✓ Success: “Connection successful! NetSuite API is accessible.”

✗ Error: “Connection failed: [error message]” – Review credentials and NetSuite setup.

General Settings Tab

Enable/Disable Features

Setting	Default	Description
Enable Plugin	Disabled	Master switch to enable/disable all synchronization
Enable Debug Logging	Disabled	Log detailed API requests/responses for troubleshooting
Enable Queue System	Enabled	Use background processing queue (recommended)
Test Mode	Disabled	Prevent actual API calls (useful for development)

NetSuite Settings

Setting	Default	Description
Subsidiary	–	Default NetSuite subsidiary for transactions
Location	–	Default inventory location
Department	–	Default department for orders
Class	–	Default class for accounting
Currency	USD	Default currency code

Order Sync Settings Tab

Order Synchronization Options

Setting	Options	Description
Enable Order Sync	Yes/No	Sync WooCommerce orders to NetSuite Sales Orders
Sync Timing	Immediate / Hourly / Daily	When to sync orders after creation
Order Statuses to Sync	Multiple select	Which WooCommerce statuses trigger sync
Create Orders As	Sales Order / Estimate / Invoice	NetSuite transaction type to create
Sync Order Status Updates	Yes/No	Update NetSuite when WooCommerce status changes

Order Field Mapping

Map WooCommerce order fields to NetSuite fields:

WooCommerce Field	NetSuite Field	Default Mapping
Order Number	PO Number / Memo	PO Number
Order Notes	Memo	Memo
Payment Method	Payment Method	Auto-match by name
Shipping Method	Ship Via	Auto-match by name
Tax Total	Tax Total	Automatic

Order Line Item Settings

Setting	Options	Description
Product Matching Method	SKU / Product ID / Meta Field	How to match WooCommerce products to NetSuite items
SKU Field in NetSuite	Item Number / Display Name	Which NetSuite field contains the SKU
Handle Product Variations	Yes/No	Sync variation details to NetSuite
Sync Product Bundles	As Single Item / Expand Components	How to handle WooCommerce product bundles

Customer Sync Settings Tab

Customer Synchronization Options

Setting	Options	Description
Enable Customer Sync	Yes/No	Sync WooCommerce customers to NetSuite
Sync Direction	WooCommerce to NetSuite / Bidirectional	Direction of customer data sync
Guest Customer Handling	Create Each Time / Match by Email / Single Guest Account	How to handle guest checkout customers
Default Customer Type	Dropdown	NetSuite customer type for new customers
Default Payment Terms	Dropdown	Default payment terms for customers

Customer Field Mapping

WooCommerce Field	NetSuite Field	Sync Direction
Email	Email	Both
First Name	First Name	Both
Last Name	Last Name	Both
Company	Company Name	Both
Phone	Phone	Both
Billing Address	Default Billing Address	Both
Shipping Address	Default Shipping Address	Both

Inventory Sync Settings Tab

Inventory Synchronization Options

Setting	Options	Description
Enable Inventory Sync	Yes/No	Sync NetSuite inventory to WooCommerce
Sync Frequency	Hourly / Every 6 Hours / Daily	How often to update inventory
Inventory Locations	Multiple select	Which NetSuite locations to include
Stock Calculation	Available / On Hand / Custom Formula	How to calculate stock levels
Low Stock Threshold	Number	Warning level for low stock
Out of Stock Threshold	Number	Mark product out of stock below this
Backorders Handling	Allow / Don’t Allow / Notify	WooCommerce backorder setting

Fulfillment Settings Tab

Fulfillment Synchronization Options

Setting	Options	Description
Enable Fulfillment Sync	Yes/No	Import NetSuite fulfillments to WooCommerce
Sync Frequency	Hourly / Every 6 Hours / Daily	How often to check for fulfillments
Update Order Status	Yes/No	Change WooCommerce status to Completed
Add Tracking Info	Yes/No	Add tracking numbers to orders
Send Customer Email	Yes/No	Email customer with tracking info
Partial Fulfillments	Keep Pending / Mark Completed	How to handle partially fulfilled orders

Advanced Settings Tab

Queue Settings

Setting	Default	Description
Queue Batch Size	10	Number of jobs to process per batch
Max Retry Attempts	3	How many times to retry failed jobs
Retry Delay	300 seconds	Wait time between retry attempts
Job Timeout	60 seconds	Maximum time for single job
Queue Priority	Orders > Customers > Inventory	Processing order priority

Performance Settings

Setting	Default	Description
Enable Caching	Yes	Cache NetSuite data to reduce API calls
Cache Duration	3600 seconds	How long to cache data
API Request Limit	100/hour	Maximum API requests per hour
Throttle Requests	Yes	Slow down requests to avoid limits

Saving Settings

After configuring all settings:

1. Review all tabs to ensure accuracy
2. Click Save Changes at the bottom of each tab
3. Check for any validation errors or warnings
4. Test connection to verify credentials
5. Enable the plugin using the master “Enable Plugin” switch

Exporting/Importing Settings

You can export settings for backup or to copy to another site:

1. Navigate to WooCommerce > NetSuite > Tools
2. Click Export Settings
3. Save the generated JSON file
4. To import: Click Import Settings and upload the JSON file

⚠️ Security Note: Exported settings include API credentials. Store export files securely.

WP-CLI Configuration

You can also configure settings via WP-CLI:

# View current settings
wp woons settings list

# Update a specific setting
wp woons settings update --key=enable_order_sync --value=1

# Test API connection
wp woons test-connection

# Export settings
wp woons settings export > woons-settings-backup.json

# Import settings
wp woons settings import < woons-settings-backup.json

Next Steps

After configuring the plugin, proceed to:

• Order Synchronization – Learn how orders sync between systems
• Customer Synchronization – Understand customer data flow
• Inventory Synchronization – Set up inventory updates